Гайд по основным Java-файлам ядра сервер L2J_Mobius

Гайд по основным Java-файлам ядра сервер L2J_Mobius
" o3 U* y: T. X1 g1 q
Разбор файла QuestManager.java

/ G+ T3 d2 U8 ]/ q. V  kЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
  Q/ S1 D5 o! Q, q% G, t9 @! k

• Лицензия
  " g) a/ g3 ?" l
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  * Y% \7 ^+ X8 v4 B

QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\


+ m- ]) r. D. R& E, RДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
# c' ]! ]- Z& N# n1 `, J$ E) a) z

1. /*
   " F* e, P& H8 {: n4 H1 a
2. * Этот файл является частью проекта L2J Mobius.
   ; B, P* T5 l( d+ l5 A; f2 [
3. *
   4 b+ s* U* \. ]9 [
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   3 E( i! X+ c" A3 c
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   ! F( v9 y  q# H3 F
8. * Эта программа распространяется в надежде, что она будет полезной,
   9 }4 y' H: \& ]$ ]" Y. I
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   % k& _' H4 G& E: B3 ]3 |1 X9 U
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    / _: k5 o4 ^$ W* M/ {
12. *
    * E" Z  p% w" ?  k; U& t
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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

, v. G8 u$ z3 J; }4 B6 T
* W0 c: N/ E, I& f6 _/ g. q' N, [  x" W2. Импортируемые библиотеки
  ]9 ?; g* m6 A8 T5 W1 n0 h
! I' Y: z/ Y1 u, `2 `2 \" [

1. package org.l2jmobius.gameserver.instancemanager;
   $ T( A- b  ?2 X4 o
2. 
   + I* @. c  x5 t% `) O# ~/ i
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
     n6 @1 ^- L+ v. b  ~" j" U" z- c
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   / \5 K! a, j" u+ q
10. import org.l2jmobius.gameserver.model.quest.Quest;
    3 y0 y1 `  w# `! `. U' |- I& ]* @
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 — менеджер для работы с игровыми скриптами.
7 W! M8 t' B7 U& S$ P3 X. C% u
9 R3 X, f$ q" W. e; s3. Описание класса QuestManager
. Y/ M* }* y" {3 E

1. /**
   0 }. d& l7 V3 ?1 `8 a0 H
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   8 `6 c4 A( f% k* s8 C
4. */
   
5. public class QuestManager
   
6. {
   0 d1 W& Y5 w& Y: s) `4 x
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   5 f) S' L/ n' X9 K
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    / X# C/ V: j/ d% A
13.    
    : U* k* C" h+ }
14.     protected QuestManager()
    
15.     {
    " W) n# B, |6 ?2 K2 S
16.     }
    7 m1 i9 C0 K* M4 }3 `
17. }

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

4. Методы
Метод reload(String questFolder)
# \3 \0 G+ T( O0 i0 X

1. public boolean reload(String questFolder)
   
2. {
   / j  {$ k) n/ _# G) Y0 w, s
3.     final Quest q = getQuest(questFolder);
   8 X  ]2 E3 ~' c  p
4.     if (q == null)
   . {; f7 Y0 C% a6 n
5.     {
   
6.         return false;
   - ]+ Q, M- Q6 d, ~7 o
7.     }
   % }$ A$ ]5 _" _1 k0 Y
8.     return q.reload();
   
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
7 g: h* N8 ~% q- ?' R! iМетод reload(int questId)

1. /**
   2 q+ b  Q: O& u5 ]4 _/ y
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   8 a: \7 x3 P% m7 Z, K
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   ( e) X: B( g& `3 r
10.     {
    4 m; `7 n! n& w. q* ~
11.         return false;
    % {8 n% ]- t7 T- L. M
12.     }
    5 o1 f- q: G$ G6 w' L7 P4 I
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  ! I) {8 a1 Q, d7 W  ]' J* S

3 c1 e- ?( U4 y0 @" hМетод reloadAllScripts()
& _0 z  {3 \# M' E

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   # L- n% I1 _7 q1 x
3. */
   
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   + Q1 l: y, k! a+ m5 W
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    ) [/ \8 ~- Z* ?9 L/ n% E
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    ! A% B- r8 Q; g1 E* y
18.     getInstance().report();
    % p7 ^- T% m/ Y4 e
19. }

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

Метод unloadAllScripts()

6 d; D4 i' b6 w1 D% T" p

1. /**
     Y$ q8 D8 H" f) j2 P0 ^
2. * Выгружает все квесты и скрипты.
   ! z  z* a; Q2 s* R" B& z9 ]
3. */
   
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   8 Y: K! l1 b- \/ l- F! a
9.     for (Quest quest : _quests.values())
   5 M) s  W# g( k6 p2 j
10.     {
    ) [3 l: Q0 K+ \9 i* H+ d0 p
11.         if (quest != null)
    
12.         {
    4 j. M/ W4 Y0 }0 o5 e- s
13.             quest.unload(false);
    * Z+ f3 c& \2 z- S6 m, Y
14.         }
    & m+ L& t$ v" w7 x' I
15.     }
    
16.     _quests.clear();
    # g: H3 ~. o5 a2 H- B) ~% q
17.     // Выгрузка скриптов.
    ; A% I+ @2 ]% b7 Y, k
18.     for (Quest script : _scripts.values())
    ' r: ?/ a% y" Z5 t3 ]
19.     {
    
20.         if (script != null)
    
21.         {
    8 z/ u3 e: O7 {
22.             script.unload(false);
    
23.         }
    9 h6 [4 g" b2 _- A$ J8 A' f
24.     }
    
25.     _scripts.clear();
    & z9 i% Q: s4 h% L* v
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ) O  \* i  U" s3 x. n0 i

2 {7 E! A. h" R; EМетод report()

( Y! ^1 W- L+ f. P# I* p

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   $ X9 s) @8 E8 x+ k) y% c: u
3. */
   . O" w! V: w0 E* a% g3 t1 I( u; _
4. public void report()
   ' g! `+ I3 G4 N7 U4 v
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   ; a: F0 X. {: r, Q3 z+ e0 M$ ^
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
     I. ?  A4 J+ @, X6 S
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  0 D2 \5 J, @% D# w4 n

0 ~0 U! v7 \- D' z! d7 [/ _/ t/ I2 nМетод getQuest(String name)
7 I8 C. B1 |. F* u8 V
4 W, e; F" r7 W4 P6 f$ o

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    1 U' J% n) |' [7 Y
11.     }
    
12.     return _scripts.get(name);
    % B1 c  d0 H2 O+ Z* V
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  

Метод getQuest(int questId)

& ~8 a' u1 y) ^& a9 Z

1. /**
   , {9 z& W: U# r+ Q; n) _
2. * Получает квест по ID.
   . y* v, z6 x5 L  Z; Q, ^
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   4 n2 U: m0 Y, N% R% b
6. public Quest getQuest(int questId)
   . I2 \3 K! o# W
7. {
   
8.     for (Quest q : _quests.values())
   . n2 z& \1 `; w2 |' H0 w. S' E
9.     {
   
10.         if (q.getId() == questId)
    $ u5 @8 R1 Z- k. {
11.         {
    
12.             return q;
    9 e; `+ G; F  g7 K/ k5 N% T! ]7 S3 f
13.         }
    
14.     }
    : L% B! k7 s2 ]7 D9 b7 U
15.     return null;
    
16. }

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

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

Метод addQuest(Quest quest)

1. /**
   
2. * Добавляет новый квест.
   " W$ q1 z) F- ]" h9 k7 f" B
3. * @param quest квест для добавления
   6 Y# j* k9 r  n
4. */
   / ~+ q( k' Q" o
5. public void addQuest(Quest quest)
   
6. {
   5 s0 r1 ~/ U6 w
7.     if (quest == null)
     ]. p% w8 ]/ U
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   - M) O* l* S0 y" q( s$ ?7 F0 R
10.     }
    9 b% D/ `6 l1 _3 J, G2 K3 H8 u
11.    
    7 l; q" L/ }3 _( X
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    - D' Q$ D2 z5 B4 D
14.     {
    2 H1 Z; n; g/ o% `+ C* e, Y
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    ( a+ B! D7 o5 h+ j
17.     }
    + V* A$ @5 c  }% U+ j
18.    
    - t; H- H  @; @
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    2 u9 Y  L) o* z2 z4 O" G
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    ; C. _5 H& V5 @0 F% ^1 A
23.     }
    : ^0 D9 A- f/ T) \
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
2 I) U4 U3 q+ M* cЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.


: X4 ]' v3 @" N7 B7 ]