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

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

Разбор файла QuestManager.java
9 S* U+ G) R0 T
Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
; Z% z3 ]/ c( |2 m/ }- kОсновные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  

" t# M$ ^2 p5 d8 J" tQuestManager.java — управление квестами и скриптами.
* U; L& c, W+ I4 _) }5 O; K0 xПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
3 w2 }  s8 |9 A2 a( ~+ e- V

- |" Z5 T! }6 Z! Z  z6 p& kДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
0 i3 j" y2 {2 c9 n  C; P1. Лицензионное соглашение

1. /*
   5 x3 }9 N/ y8 D9 R) e
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   . Z% t' O+ c" C! P0 H2 u" }# q
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   - c7 p% Y: D$ v6 a
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   5 H7 a( q4 a$ M$ n5 ~& D( J
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    # a- I+ c! P2 P- @0 A: o- ~! K
12. *
    # J2 K6 ^6 \" y: `
13. * Вы должны были получить копию GNU General Public License
    ' S% R! E! ]6 K8 ]5 A
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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

3 Q0 q/ h* n9 Y' B
2. Импортируемые библиотеки

% x! _- d- M2 P2 b" w2 Q

1. package org.l2jmobius.gameserver.instancemanager;
   3 E$ p, a$ p4 Y8 \! V4 i. ^
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    
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 — менеджер для работы с игровыми скриптами.

3. Описание класса QuestManager
! ]  a. Z  {# t9 f+ R, Z# W: y0 n

1. /**
   
2. * Менеджер квестов и скриптов.
     o$ f2 Y9 d5 d" F  p
3. * Автор: Zoey76
   4 S, l+ l% A+ ]7 f6 \
4. */
   
5. public class QuestManager
   
6. {
   - N$ x- I4 c4 G% }5 i/ E+ V
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   0 z1 W$ `: E9 m$ R" R0 J- E6 F
9.     /** Карта, содержащая все квесты. */
   7 J5 Q# |9 c: {, |3 J
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    3 s7 |- \% _$ h- a" g
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    
15.     {
    
16.     }
    + n2 R6 s& w* R' V9 b2 Y6 ^( _
17. }

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

4. Методы
Метод reload(String questFolder)
; X/ \! g' K: z- e' p( R

1. public boolean reload(String questFolder)
   
2. {
   4 ~; z2 h: `; g3 V9 ]
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   8 u) j* Y8 u- V# [; z
5.     {
   ! j3 @7 o! R- ], _
6.         return false;
   ( Y$ c  ^" R  b9 f1 J/ u
7.     }
   9 k* ]0 F; ~" o# G0 s7 W6 a8 A
8.     return q.reload();
   
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
. W1 b$ q6 f/ A1 nМетод reload(int questId)
4 K$ e$ \2 t$ L* i) U

1. /**
   1 G* f6 k! B) j2 N
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
     m& o3 r% D" ~4 @
5. */
   
6. public boolean reload(int questId)
   
7. {
     {8 i+ \% \  S1 a8 Q9 L9 m- q- E
8.     final Quest q = getQuest(questId);
   2 O/ H( A; P& q4 y" C7 F
9.     if (q == null)
   9 O3 H* M0 Z  @# t) e2 U  u' H
10.     {
    
11.         return false;
    
12.     }
    : j, Z/ e# Q5 D' Y$ y, A" T
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  

9 c4 C+ o( O" D8 ]Метод reloadAllScripts()

7 z+ A" E% y1 N* Q% X! I

1. /**
   - ^/ p2 b- S/ @1 v; [9 s0 Y
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   ( N9 ]7 C1 Y- r$ U6 e" ^3 ~
4. public void reloadAllScripts()
   . @' t, R  P4 c, H* n: x. q
5. {
   & D' o1 w# a3 V& D! }& Y+ V
6.     unloadAllScripts();
   ) O, Y4 \4 k) B4 z1 h4 E
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    . b0 E6 O  }8 U2 W+ d& d* M
12.     }
    3 z& V9 D) Z  M" w- S
13.     catch (Exception e)
    
14.     {
    & O$ ~( i' Q  {
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    7 u, B9 q/ d+ A9 q
16.     }
    
17.    
    " f' y' M- {; {  H" Z
18.     getInstance().report();
    3 d! _" J: O3 q. U
19. }

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

Метод unloadAllScripts()
" C: J6 A0 B/ h9 t4 @: e/ s! O
+ e# R- P: n# V% g5 M0 r0 s7 t  N

1. /**
   
2. * Выгружает все квесты и скрипты.
   3 v& a" ~( M" w
3. */
   $ u7 b9 @# W' `7 h
4. public void unloadAllScripts()
   4 l6 z' u. u( j6 N- n& f
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   ' E) F% m; u8 D  a# t: u
10.     {
    - V- u* b6 L! |+ Y8 \# f" s) M( n; H
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    
14.         }
    
15.     }
    
16.     _quests.clear();
    ( V! Y% i& g3 v: ?
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    5 F0 {2 l% O1 ^5 z5 K6 V' b
21.         {
    
22.             script.unload(false);
    
23.         }
    : B9 d/ H+ s6 m. |( ?4 I
24.     }
    
25.     _scripts.clear();
    6 `% q3 T" L3 t6 w# _/ J' D6 ?
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  / U/ ^  Y8 C1 m2 D. S% d

Метод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   7 H5 ]1 W6 k3 N& e$ Q4 p
5. {
   2 b. |, P  l, {! N% c1 b6 e
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   ! q8 J' U( G! u" \( a& Y  a
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   7 x# Q1 H: @8 I  e! ~
8. }

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

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

" ^$ ~8 d& m" |0 L6 FМетод getQuest(String name)
7 S: y) c  x6 ?% }; n  _, y7 T1 o
4 e1 Z# q) I$ i' B- S8 K  w9 i

1. /**
   
2. * Получает квест по имени.
   7 x9 W1 F* ?% @
3. * @param name имя квеста
   & y; \9 H$ Y! S, A
4. * @return квест
   , W' \; g3 [; s
5. */
   9 q- U/ g5 D9 @
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   & J2 U! S: ]! }" G
9.     {
   ( l0 t7 ~% Y$ _6 s5 C- N' T
10.         return _quests.get(name);
    0 W0 h: Y' a+ f5 K
11.     }
    ; O4 n% j, h  ~* J. ?: [3 Z
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  " _& l& s. S" c! g' X

Метод getQuest(int questId)

% w/ d& {0 |3 m) e

1. /**
   ; v3 ~! `( ^/ u; l4 o
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   " k& d+ b; }% Y5 u
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   ( \' u  H- B; X
6. public Quest getQuest(int questId)
   
7. {
   1 S7 {: O3 X' |  ^  w0 p) V
8.     for (Quest q : _quests.values())
   8 H" M7 b7 C) Q- M8 p
9.     {
   2 I9 G& k* f' o$ H+ n
10.         if (q.getId() == questId)
    
11.         {
      [$ t: l; ^3 P3 ^! m
12.             return q;
    
13.         }
    
14.     }
    0 `+ y$ A6 W( N, d
15.     return null;
    3 q: q3 l4 O3 @( F
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  # T3 B- f4 I4 U# }  }' ]

Метод addQuest(Quest quest)

8 b( a, V: L1 o$ A% R3 S* X

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   , c1 D9 U2 W9 s
5. public void addQuest(Quest quest)
   
6. {
   - ^; n) |5 T- q& M( C
7.     if (quest == null)
   % ?) I9 |: i( u' H; m8 n5 L/ N
8.     {
   $ }$ O4 l, b1 {4 V% v; U
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   / ^1 W$ ^0 J* r) R
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    9 W$ i/ L6 G9 L3 F6 E
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    3 ^6 Y7 d* d' Y
18.    
    
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();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    3 j7 @: i6 V$ u' L2 l
23.     }
    
24. }
    8 ~! ]0 f' F( Q$ D
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
8 E) H- n$ S2 t4 E' i" D2 M8 p6 YЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
' X# f+ }, t' }4 N# |( G

( X) O1 _' u2 h1 |0 O1 b