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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
' B: |: c' W2 k5 y: t
Разбор файла QuestManager.java
- Y: ?- V3 m# Y9 |9 k& r# b% j
; x' E8 o3 L: O: \, P2 Y+ l# gЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  # a6 ]. a- ]* E5 B1 v! X, Z
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    8 g* \0 W5 j; ~( c4 p
• Импорты
  

& l% J$ @1 M4 b0 Q& c4 T  E# A) xQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
  {1 [! i5 h6 v  a& X8 a
! H, Q0 }1 g6 ?7 U0 B# n
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   7 l, E8 _: ?- g# ~8 w  U0 a
2. * Этот файл является частью проекта L2J Mobius.
   , b: a$ I$ B0 A$ a& Z' h+ C
3. *
   4 V& S' a7 L5 Y  k; K$ H0 h
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   ! R, }5 ?, d6 T4 a
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   4 }5 x& j& d7 e/ O' s% P2 r
7. *
   9 e. S% a2 A. O: E' i5 q  o
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    , V2 }. o# |) u0 X0 G) ]
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    6 [8 N8 A5 ]# u) ?" A6 i
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
7 y6 @& n" T7 Z, _3 T
% d" h5 q5 v) l' _% ]! }
: @7 l  h' }1 S) ?  \2. Импортируемые библиотеки

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   / c' D0 h' \  |1 E/ V$ `- U; e5 _
4. import java.util.concurrent.ConcurrentHashMap;
   : g+ n- i9 T4 N. q
5. import java.util.logging.Level;
   $ R. n2 v9 D* i- {" n# Q" r
6. import java.util.logging.Logger;
   2 _" c+ U% ?# b* o. J( M& \
7. 
   
8. import org.l2jmobius.Config;
   # W% ]' E6 {2 Q3 t! M
9. import org.l2jmobius.commons.util.CommonUtil;
   3 ?* o7 r$ ^  p! o+ K
10. import org.l2jmobius.gameserver.model.quest.Quest;
    + ~% C  k6 _3 _9 u
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 H6 j) h, P7 m8 q! N9 D
" A! p* K( P! U3. Описание класса QuestManager
8 r4 Z8 b# I2 o" j: ~& Q. u

1. /**
   5 R* X  w' o3 S; z- A* ~
2. * Менеджер квестов и скриптов.
   5 c3 q  l, J* h  P) o0 A' v( D
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   ! B) C. v: i( v" X
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    , }' q* @, t  |. {6 L: @4 J
11.     /** Карта, содержащая все скрипты. */
    & q2 {1 K& l9 \+ y5 f
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    
15.     {
    1 X4 [3 b+ n9 `: p/ K  m2 c
16.     }
    + f9 Z; X* c' P9 Z
17. }

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

4. Методы
9 n$ Y2 `. j  z3 q2 F/ S2 z! YМетод reload(String questFolder)

1. public boolean reload(String questFolder)
     ~' H' S( K# p% G! j
2. {
   + E. [7 H5 B4 ?+ n$ A
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   ; t# m" l8 b& k7 o3 L- [+ ?
5.     {
   
6.         return false;
   
7.     }
   " P& {: x, d, }8 j/ g5 W1 [
8.     return q.reload();
   ' g$ v. u" Q* h
9. }

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

% z% ]" c! X( n2 z- P9 u3 L) H# \
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
3 E4 ^# m5 M0 c  p0 C* S& x: o9 I7 vМетод reload(int questId)
+ W7 E, `# K% H- a7 b
$ }! u/ n3 k' r. _, L' E

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   : o) {5 W5 G* Y- V3 F/ q3 e
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   9 r# t( `, c& N1 B
5. */
   & k" o4 ~, W6 T. Y8 v
6. public boolean reload(int questId)
   
7. {
   1 ~+ v8 S: @2 g5 S
8.     final Quest q = getQuest(questId);
   & l# h, l/ i8 _* {7 v
9.     if (q == null)
   
10.     {
    
11.         return false;
    
12.     }
    , Z: j+ v" Q$ x$ D
13.     return q.reload();
    * v: a* j, x: _% G
14. }

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

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

Метод reloadAllScripts()

$ V% Q1 f, @4 S4 k, E

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   3 N/ b9 A8 M3 U& Z: e8 f
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   
7.    
   ( x2 v" S2 T4 D. r8 Y
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    % n' [- ?' Y* M1 `7 R
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    6 G" G3 L: D% E: a" U" ^
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    ' l* b0 y; L$ b+ l
16.     }
    % Q* Y% X- F; ]+ g
17.    
    
18.     getInstance().report();
    * b" a6 d+ `& q/ J
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   4 V1 e4 L7 u# v- G# h) r$ ~
3. */
   + B2 p1 z: c/ E8 i
4. public void unloadAllScripts()
   
5. {
   ; ?, l# y, u/ n$ c9 V' A( I% M
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   " s, m# G" Z6 L9 E* E" V9 V* s0 r
7.    
   , _2 `" u1 S, y2 I! q. r9 ^" g6 _
8.     // Выгрузка квестов.
   4 Q  b7 S1 @( k4 q' O( O% L
9.     for (Quest quest : _quests.values())
   - K+ o( e& o" R: a/ [2 H
10.     {
    ) p( x' u5 U- @. a) l" o2 g( d
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    9 T7 h2 j# a; \% L9 S
14.         }
    , I7 q! j+ j' Y1 l
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    , N8 O/ w4 s! G* R  s
19.     {
    
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    0 U9 t' y3 u8 x( c" P* y
23.         }
    
24.     }
    & h) k. ?4 |! @! ]" i( C
25.     _scripts.clear();
    " s! f. ?5 q1 o7 [4 O
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  2 D; F- g. a/ b* V; p$ Y

' P$ v6 F' y0 t  tМетод report()

, r6 i' R5 @- J# s  h

1. /**
   % {7 g) D' t; u3 x& o, F. K
2. * Логирует количество загруженных квестов и скриптов.
   / K2 A  u- Z, g: i+ ~& e, J. J
3. */
   
4. public void report()
   
5. {
   8 r% ]7 M, I2 {4 n2 ^
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   4 w3 D3 H; z, C0 [9 L* ~) d- a
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  9 k! C; |& k( f& _5 u

& H* e& c* E4 M# L4 J+ {7 O, h% eМетод getQuest(String name)

1. /**
   
2. * Получает квест по имени.
   , y1 w  y/ d: b5 N8 s1 \
3. * @param name имя квеста
   7 E! G5 T( W/ i) x3 J$ M
4. * @return квест
   
5. */
   * [% J4 [1 [! }' ]; {2 I
6. public Quest getQuest(String name)
   + v9 k9 B( J. d* I3 P0 D' g
7. {
   / k/ w, R' V* p; \6 I
8.     if (_quests.containsKey(name))
   2 X# P; c9 A% M5 |# F
9.     {
   
10.         return _quests.get(name);
    
11.     }
    7 F' r" E+ r4 S  ~, \, V
12.     return _scripts.get(name);
    
13. }

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

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

  d: C; O: @* L$ {+ U* kМетод getQuest(int questId)

' U$ v8 C" N% Z( K3 m

1. /**
   7 W; p  X0 ~% K5 d7 m% s
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   % e& k3 c& E! {
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   1 d! V5 {4 e& c7 L7 [, p
6. public Quest getQuest(int questId)
   6 o0 C4 F4 Y, y) v
7. {
   4 d5 q1 n% i& p8 y, x
8.     for (Quest q : _quests.values())
   8 L; a6 `1 T! l6 I9 [0 n
9.     {
   - _4 k! n9 o, `6 U3 _5 j
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    % g$ m" N* z0 l( p6 [0 I
13.         }
    
14.     }
    
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  ! n# ?* ?2 e* f

Метод addQuest(Quest quest)

1. /**
   / ~! t% \2 S! ?. o$ t0 j' a
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   ' \4 {$ R  F" g8 L( B  C6 F
7.     if (quest == null)
   % h$ D2 r% ~/ F# y! _0 H
8.     {
   1 o1 H& J9 ?) m  z4 F8 N1 p! @" z
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   4 v; @$ k) t9 s/ j
10.     }
    : _2 X: Z8 W4 l, e8 P& O
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    2 O, T1 W, f1 u* j; Q
15.         old.unload();
    $ P7 T* X& Z9 E7 r+ n
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    # m9 }: K6 _, P0 ^) H
18.    
    * z2 g: g2 R- `) c2 u0 |) Y" O
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();
    ' B5 ?  g- d; M& L/ `
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
      I8 j  M8 ?1 s' e3 O5 a9 C. p
23.     }
    ' a4 Q: Y3 H9 k: W9 o0 R& [/ ~
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
0 k; r) q( B6 L4 B4 `5 d" w3 fЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
8 J9 B2 u% `$ J8 y- Y
9 _. X7 v# Y/ W6 |: K
, D( u+ {4 g. B1 Z, j2 I( U
2 |$ X$ s. p3 {* e( W, y1 S