artace.ru - творческий сектор

Название: Гайд по основным Java-файлам ядра сервер L2J_Mobius [Версия для печати]

---

Автор: admin    Время: 2024-9-21 10:39
Название: Гайд по основным Java-файлам ядра сервер L2J_Mobius
Гайд по основным Java-файлам ядра сервер L2J_Mobius

Разбор файла QuestManager.java
/ X! P$ ~, S0 b6 S# y( x
( E+ J1 Q% w# d# C, I% s( QЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
    J& l( z, h+ d4 f: \( u

QuestManager.java — управление квестами и скриптами.
8 _5 W! K; t) E1 P  i, BПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
0 p" d& @8 x' Q) }& ~# s

4 q% h. `0 q' y: m0 U  i7 N$ H6 H4 |Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   3 f  F7 M% c+ ]
5. * её в соответствии с условиями GNU General Public License, опубликованной
   . \# t3 J7 {- _' ~: x
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   8 ?/ n( z) i& ?4 D5 k, T/ J
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   $ X7 [2 `2 N/ ^& z8 Z7 H* M
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    : X, @; z4 j$ g7 i! T# |7 _
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    ) x" x' I( G) `
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

Скопировать код

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.


2. Импортируемые библиотеки

: d5 k3 b! e5 J2 ?8 i

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   : ~8 M; o# u! d& S- A2 x/ I/ C, r
3. import java.util.Map;
   3 G/ o1 x8 }7 g
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   ' O! r" ^: W  v: w! ?
6. import java.util.logging.Logger;
   
7. 
   0 X) ?# B; M2 h; F
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   5 P: v& E0 J" L
10. import org.l2jmobius.gameserver.model.quest.Quest;
    ) i! I3 U, y/ ]  b& w, j. m
11. import org.l2jmobius.gameserver.scripting.ScriptEngineManager;

Скопировать код

java.util.Map — интерфейс для работы с коллекциями, которые сопоставляют ключи со значениями.java.util.concurrent.ConcurrentHashMap — потокобезопасная реализация карты для использования в многопоточных приложениях.java.util.logging.Logger — класс для логирования информации (вывод сообщений в консоль или лог-файлы).org.l2jmobius.Config — класс конфигурации сервера.org.l2jmobius.commons.util.CommonUtil — утилиты, которые могут использоваться в различных частях программы.org.l2jmobius.gameserver.model.quest.Quest — базовый класс квеста, представляющий игровой квест.org.l2jmobius.gameserver.scripting.ScriptEngineManager — менеджер для работы с игровыми скриптами.

; D; ~6 ~/ [; M) x6 d) v3. Описание класса QuestManager
# \% D3 T; K' C- Y

1. /**
   
2. * Менеджер квестов и скриптов.
   + `2 X- T. s0 H9 r
3. * Автор: Zoey76
   " R- M4 ?2 ?; e4 \3 M
4. */
   
5. public class QuestManager
   ; N0 D; L- Q$ I2 Y& ^. M- M! p5 S& p
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   * m% y8 n+ n: j0 D5 x9 k% [: S4 Z
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    % }( t1 d# i5 x! X
11.     /** Карта, содержащая все скрипты. */
    5 q7 u5 n8 K, U6 u# w6 ^
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    0 C+ {. Z( ]8 |% I
13.    
    
14.     protected QuestManager()
    
15.     {
    
16.     }
    
17. }

Скопировать код

4. Методы
/ u. C' V5 n  }( M4 a! w/ ?Метод reload(String questFolder)

1. public boolean reload(String questFolder)
   4 H$ T" T+ n' ?/ n5 T; Q- M# m
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   ; Y$ q1 s8 @5 }4 w: m1 @& q
5.     {
   2 I& O2 v% ], F0 J1 K5 I
6.         return false;
   
7.     }
   
8.     return q.reload();
   
9. }

Скопировать код

& v) p1 R. ~1 l' q5 Q8 a4 G
4 y' T7 }: Q0 S+ A3 Q, M9 yМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
# T$ |: L* {! }6 }, `/ N  X

1. /**
   
2. * Перезагружает квест по ID.
   + P, H$ ^7 A; k0 v
3. * @param questId ID квеста для перезагрузки
     R# E( O0 q' k2 Z9 {
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   5 D5 w' n! C0 e; n1 F: Z( H
5. */
   * f$ ], ~0 ?6 f5 Z
6. public boolean reload(int questId)
   & ^- B, O& W) u9 {) M
7. {
   
8.     final Quest q = getQuest(questId);
   % \* k" h) p7 h; G4 X. e2 \
9.     if (q == null)
   
10.     {
    
11.         return false;
    6 S& u( P4 r( b' X+ r
12.     }
    
13.     return q.reload();
    
14. }

Скопировать код

• Аналогично предыдущему методу, но перезагружает квест по его ID.
    R: q% v9 D+ ~+ w4 p, \

6 s6 x% K& k/ Y# ^9 F3 bМетод reloadAllScripts()
7 u$ V1 j" M1 p; }
+ s0 U" v; \! {6 a

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   # Y) b" M# E% o3 N! R9 d
3. */
   3 j$ E& q9 p5 e
4. public void reloadAllScripts()
   % d( @, `- P7 x  c' j' R
5. {
   
6.     unloadAllScripts();
   
7.    
   8 W2 l! v3 Z. R7 Z. _4 X+ }7 a
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    ! f% z0 m6 o: w/ L! b8 I7 Y
12.     }
      D/ H$ a  |  K) h- q& s# s2 J; j5 _
13.     catch (Exception e)
    " T7 m. n' A2 t
14.     {
    ' W% q, a* K1 h" P" f
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    & j8 k- C; J) U! m) Q, h- d
18.     getInstance().report();
    
19. }

Скопировать код

Метод unloadAllScripts()
+ s: D) \% g2 C) g+ z3 P  `

1. /**
   
2. * Выгружает все квесты и скрипты.
   - J3 |8 B, f5 a8 q$ W9 p5 J# m
3. */
   
4. public void unloadAllScripts()
   & d9 W% k2 ~8 E. \' m  h$ d
5. {
   * {/ H# q2 C1 L( z" i
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   $ @0 `' ]" Y: t3 K) b9 r: F
7.    
   
8.     // Выгрузка квестов.
   2 z1 @/ X* ~- k- H
9.     for (Quest quest : _quests.values())
   0 q$ Z5 m# H; T" D
10.     {
    . {7 S- U9 H' h5 d0 B% F# o
11.         if (quest != null)
    ( w# J" o; G5 l, f( K$ h
12.         {
    : N0 y4 G9 R7 A9 E; y  V0 S
13.             quest.unload(false);
    
14.         }
    : ?% T3 i7 i3 e3 D6 `6 D
15.     }
    - c1 U$ p2 \0 U4 y
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    3 L) u& ]  z$ l9 A( @$ U' B/ W
18.     for (Quest script : _scripts.values())
    , ]1 x; S. h4 [$ U  Y
19.     {
    / s% I8 G2 u  I# R2 q
20.         if (script != null)
    6 V7 v/ G; b& w' N, S. l: l2 h
21.         {
    
22.             script.unload(false);
    
23.         }
    
24.     }
    
25.     _scripts.clear();
    8 B3 i+ ?4 H5 i" ]  w
26. }

Скопировать код

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  

2 A0 F# |& y5 ~! QМетод report()
; m7 {+ I$ t% N6 b2 O
7 j, J# h& X# B) W5 j+ u

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   % b. b& r2 r' y5 L- J: N3 z
4. public void report()
   
5. {
   ; R4 l0 k9 d. M# [6 Y4 \0 _8 }
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   $ w) b3 M  V3 K! v4 Y$ ~4 V
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   - ]: o# `) s$ Z. {
8. }

Скопировать код

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  

Метод getQuest(String name)
3 q6 E$ o- [9 q" e+ F
9 ~1 S+ \5 d% E9 X* ?7 s# b

1. /**
     @  ]6 |" Y1 w7 a. G2 ~5 _; C
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   * P8 m! I1 y/ H6 L4 k2 r0 @
6. public Quest getQuest(String name)
   - T8 Y9 r. B+ z
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

Скопировать код

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  ) T' l  [  o4 A

: _1 x" G: j9 U" x/ tМетод getQuest(int questId)
/ @" Z. k8 \$ L( Z8 [5 i
& I5 J% G% v! Z9 V% a0 [

1. /**
   1 O: m, U/ c0 i; J3 E* X( l
2. * Получает квест по ID.
   3 W/ w  B) u  }
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   : J" C. i; j9 \& I
5. */
   
6. public Quest getQuest(int questId)
   / e# N% }: ]$ `$ F$ f- n4 ?+ ]
7. {
   
8.     for (Quest q : _quests.values())
   3 `- P1 y8 e1 H9 ^0 d* X+ i
9.     {
   6 M5 K: Y0 J/ K2 B6 K  V/ r7 N0 I# N
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    4 I9 F) U- J" }; L/ z, r8 t1 s
15.     return null;
    
16. }

Скопировать код

• Этот метод ищет квест по его уникальному идентификатору.
  

Метод addQuest(Quest quest)

; k/ G) L7 |0 t

1. /**
   ' B9 S# L6 W7 h( h  v
2. * Добавляет новый квест.
   0 W  l( C7 l* J8 X" j
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   5 _( k9 K: B* q1 ?# [3 t
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   - K, ]9 y9 R3 \1 O; p5 o, t
10.     }
    ! W- y; k1 p% g# ?+ A
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    4 n) d+ S0 W4 k! }& q$ g1 N. Z
14.     {
    - l) I, c0 R# w( p2 M2 m: M
15.         old.unload();
    7 Q& ?) T2 n+ ]
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    3 r& O3 B1 Y' e0 v+ X/ _  g: M
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    4 i1 r4 G  E/ c. i3 }
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    ( b( R9 S8 B7 j% `' @. }4 J- j8 F
25. ``

Скопировать код

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
% z9 s8 T; ^8 j4 T: xЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
+ l, L( E, ?' E' B0 `


( P' L( P/ _" |( R

---

Добро пожаловать artace.ru - творческий сектор (https://artace.ru/)

Powered by Discuz! X3.5