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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
1 g4 y4 W9 S0 S
Разбор файла QuestManager.java
$ Z0 o- ~. X- f6 O
! j" d* E2 d  p) d) ]! X( dЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
( D9 ~! ~+ f2 K3 o' c8 I9 i

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

% l7 r% Q4 x% l7 MQuestManager.java — управление квестами и скриптами.
+ p6 B1 g$ b' H( _$ Q2 n3 i, T2 kПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
! S" S- R9 F+ F, G3 v
) r/ s$ M. _2 }; {
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
/ _. n, o; K' S9 M3 h$ S. ?" e( E1. Лицензионное соглашение
; s7 C9 K. R) q- S6 M; \. C6 F

1. /*
   : T' J6 y0 E' H5 x
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   7 ?% F) L# g! N6 t" N% c; ^/ K' W
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   , G% _. l# E* I) V
5. * её в соответствии с условиями GNU General Public License, опубликованной
   . d7 X; V2 S! ~/ I2 W2 E, H' l
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   4 q3 L5 d3 B2 Y' L, V& m7 Q; ?9 D* I
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   + j: O1 m" d$ Q' d0 U
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    # @( D' H$ T. ^! ^
12. *
    
13. * Вы должны были получить копию GNU General Public License
    9 K2 N- x7 h% C2 R& \% S' u8 s
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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


: C0 l6 j+ v' d3 E! }2. Импортируемые библиотеки
  ^6 X/ Q7 T( O3 i, S7 n# w5 Z6 _
: E- w  |( ^) ^% l  C* |

1. package org.l2jmobius.gameserver.instancemanager;
   7 N7 \3 R3 M6 l% g0 l2 k& K
2. 
   & w# S5 N+ R; E# F6 f* n0 X8 i
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   5 Z+ y7 l* l$ L+ N- F" z
5. import java.util.logging.Level;
   - U9 m5 F; s& E
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;
    ! V6 x4 R  t7 B2 E0 C9 _
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 — менеджер для работы с игровыми скриптами.

( \4 ?6 s! s! L" N; r! f, J* `3. Описание класса QuestManager

1. /**
   9 z8 F' t) o) L3 V$ N8 _% Q2 k
2. * Менеджер квестов и скриптов.
   % n2 w2 v' r7 A
3. * Автор: Zoey76
   ) Z, u5 E, A6 ~2 G0 b
4. */
   + ]$ W( ^: S0 C1 X! H
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   2 d$ V6 B# l  j! @
8.    
   5 t5 |$ W- a8 }) y
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    # N& S1 O0 Z8 q( u9 d& ~1 I" V
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
      B' m/ q1 Q, ^, J
13.    
    
14.     protected QuestManager()
    , g2 L. |5 x6 x
15.     {
    / W$ ~" E, R( T/ z' p7 X  P
16.     }
    
17. }

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

4. Методы
Метод reload(String questFolder)
( F6 \4 p9 S0 z' z

1. public boolean reload(String questFolder)
   * _2 ?: V+ z  e" ~" I
2. {
   
3.     final Quest q = getQuest(questFolder);
   8 j9 r* i: X: m) `/ D, r& g
4.     if (q == null)
   7 h/ \' M" G$ _7 u# o* A" i: G0 ]
5.     {
   & m2 x4 p  K4 b8 @9 T! p9 |2 P
6.         return false;
   " K, k8 M& Z# G
7.     }
   
8.     return q.reload();
   # H! X: J. |; V& f1 _
9. }

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

5 M* O6 k' c  u7 M8 @: r, B# t8 U
2 r3 [! v  _1 U5 j2 B1 EМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

1. /**
   
2. * Перезагружает квест по ID.
   4 A0 C( B% p) b6 f
3. * @param questId ID квеста для перезагрузки
   7 N" c2 f! t& u! |4 _7 ~
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   # ~# a2 T6 Z; G2 Q3 d3 k* t9 G; S
10.     {
    ; z$ w& Q7 e3 Y- d9 v
11.         return false;
    4 V4 }0 S9 J! C" d7 H
12.     }
    
13.     return q.reload();
    / n( }5 ~, a( \5 \8 E
14. }

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

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

Метод reloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   
5. {
   $ j& `+ i2 z0 U# N$ w) F6 S, V4 L' v
6.     unloadAllScripts();
   . m8 e0 }- Z% K" e7 o
7.    
   2 ?) @" |% B2 R
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    * R, ]7 }: ]* ^* M# ?: Z# I* `6 b& u6 r
13.     catch (Exception e)
    ; o9 i' R1 z5 y
14.     {
    5 A$ ^. w9 ^8 G7 J  e2 W; X
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    ! ?# l8 ^7 b8 O5 w/ |
16.     }
    
17.    
    
18.     getInstance().report();
    ' O1 a& D% h2 d& l- R& @- q2 O; T
19. }

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

Метод unloadAllScripts()
+ ?5 H% ?/ Z( m# U& Q( ?

1. /**
   
2. * Выгружает все квесты и скрипты.
   - S+ t& A( ]; O' P! Z
3. */
   : ^5 p) h) y* E/ C4 |$ H8 b
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   + E( Q7 U; G* n, X( p; K
8.     // Выгрузка квестов.
   0 G3 A" @8 Z! G5 H9 L: J
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    % q* }0 s5 W9 J- z
12.         {
    , A! p% z) U5 U5 i1 D
13.             quest.unload(false);
    
14.         }
    
15.     }
    $ Z# y( Z* D. V6 c
16.     _quests.clear();
    6 b0 S5 V9 {! Z  N% C/ N8 D" X" z
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    9 M, _; j9 v9 J! U( A  W+ Z
21.         {
    
22.             script.unload(false);
    : u, g! o. k4 }* n  {8 [3 P( @
23.         }
    & J* X& K: M  Q! ^
24.     }
    
25.     _scripts.clear();
    
26. }

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

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

Метод report()

0 X' a/ O$ ^* c  G# z

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   ; n2 P* q9 n4 D* O! V9 N5 w; N5 p
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

Метод getQuest(String name)

; T2 X( D& N9 c# ~

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   2 }& ?% O- n! c' Q9 x1 I
5. */
   
6. public Quest getQuest(String name)
   
7. {
   % V4 |* h7 v0 v9 D! d& u4 C0 z4 f+ Q9 X
8.     if (_quests.containsKey(name))
   
9.     {
   ; S: U7 |: X' ^6 q5 K6 |& S4 b
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  2 h( p4 G3 e3 T3 R6 W# L

Метод getQuest(int questId)

1. /**
   , w" }# ?& @, I" C
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   + h' L8 c1 s) ~! G9 O2 ?( c9 e
5. */
   ) ]9 d; \" }+ m: O5 s) J
6. public Quest getQuest(int questId)
   % P" u+ A/ q( R* r
7. {
   
8.     for (Quest q : _quests.values())
   4 t. [; L; W8 O6 W
9.     {
   
10.         if (q.getId() == questId)
    # r5 m" n2 R5 g6 Y
11.         {
    
12.             return q;
      I* ^& Q4 b2 @: w
13.         }
    ; @1 V1 X' F) C) k" w. S, A1 G
14.     }
    1 Q. B$ l* y5 Y3 Y2 x% I6 n* L" ^
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  3 t" Q* t) {, a8 u' R# _, [* p

Метод addQuest(Quest quest)

1. /**
   
2. * Добавляет новый квест.
   / P, L( \: ]) ]! S" p
3. * @param quest квест для добавления
   ! E1 U5 f/ S" l: B$ f
4. */
   9 U. b+ T5 [6 y6 P2 q# e
5. public void addQuest(Quest quest)
   - e: k0 ^/ v7 A# _
6. {
   
7.     if (quest == null)
   : p/ j0 V+ D4 P6 ^: N4 F
8.     {
   9 v; P  L4 d; Q2 ?
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   , x) E2 ]1 p$ z9 M8 Y5 H
10.     }
    
11.    
    0 q+ Q4 U; q& v9 Q) E9 d' M0 j
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    9 M; K5 U% ^2 r: T! M7 `
15.         old.unload();
    # b4 j% q& I9 t% q) G
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    8 s" y7 x8 T) u; j& I
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    4 h6 V# Q! o: ?8 g$ n
20.     {
    ! h! l. l" ~2 {! z/ g0 B/ e5 d8 j
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    2 P! x& ~" L) i/ u
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    9 E6 M3 y  v) L
23.     }
    
24. }
    ' t- z: J9 E' ^; H7 ]
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
" f: l; L' U0 w; c* a  O6 MЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.


$ p" i7 y9 h" ]9 L! x' E