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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
* `; ^/ I( h0 V" [& e' B' I
8 R+ I2 y+ |% ]7 l7 kРазбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
& B; i: h  _* S  q

• Лицензия
  % c) v9 m, M2 x/ t
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    9 d; E  Y+ w  S; v5 c" E
• Импорты
  3 u/ u7 S5 r4 e

QuestManager.java — управление квестами и скриптами.
* U) q5 |/ h! g  SПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
. O3 M( l. [- q1 l/ u2 K
/ J8 B2 e! k* j0 @$ K
: {% n2 q9 }/ _7 t( i* O2 IДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
8 h: A! Z8 K& u1 G0 e/ {1. Лицензионное соглашение
+ G) l5 f2 Q3 y9 K4 }' ^

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   1 ], x; E5 O, z# m+ ~- E
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   7 h8 R2 h9 ^) ~: g8 \( S4 E
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   5 i2 M  a$ `" y/ Q" Z2 \; @* n
7. *
   - w- Q# x, Y$ M0 ^
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   ! ?5 M4 X8 V! `
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    , s" ?! d  s% Q& g4 i0 {! C; ^
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
      B3 @) Q4 G- R; I4 l7 b4 ]
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
) V8 b  V0 H7 Y4 a4 V
" x& T; m' v1 k, b* E) R4 B8 }+ M
2. Импортируемые библиотеки

' j0 z: @% v* b

1. package org.l2jmobius.gameserver.instancemanager;
   # I+ i0 c& S$ m0 j1 f
2. 
   / E6 H( u, e; n4 l7 |/ a9 C
3. import java.util.Map;
   6 D: v* r0 u& j- Y: g; ]
4. import java.util.concurrent.ConcurrentHashMap;
   6 t9 |& S' W9 I3 |$ y9 Z2 ^
5. import java.util.logging.Level;
   6 x# k0 N0 q- S3 [
6. import java.util.logging.Logger;
   ; Z1 K+ o% z* I! s
7. 
   8 Z5 v4 f2 e" }5 [4 K$ Q+ H
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 — менеджер для работы с игровыми скриптами.

: o4 g% H. x8 p3 y( f: E3. Описание класса QuestManager
* o. m7 Z, d( P  ?8 H! _8 C

1. /**
   
2. * Менеджер квестов и скриптов.
   2 o5 G6 B+ t: m$ Q3 Q' p2 }9 U1 E
3. * Автор: Zoey76
   8 {% \2 V  E  I4 {1 V
4. */
   
5. public class QuestManager
   
6. {
   $ E6 A& v- o4 L4 i1 b6 B8 o
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   & Y. j) w4 E" D( k. U5 H+ D
8.    
   : ]- q- |: p0 A% x$ g2 p  G
9.     /** Карта, содержащая все квесты. */
   ( C5 J5 Y4 x3 Z4 c
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    5 J1 G) v7 _; M3 [- }; e
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    : c: b) z' q: ?1 K, y  n/ D) z
14.     protected QuestManager()
    
15.     {
    
16.     }
    
17. }

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

4. Методы
Метод reload(String questFolder)

1. public boolean reload(String questFolder)
   - H/ e0 R1 T7 a9 Y" |
2. {
   . e0 N2 U/ f+ [7 Q7 C& P5 b
3.     final Quest q = getQuest(questFolder);
   ! u0 ?6 i+ ?! w3 X7 w  N
4.     if (q == null)
   3 f1 S1 ?: Z3 C# A+ N5 k  G
5.     {
   . \; A6 G( I& q+ ]# H8 d$ ~
6.         return false;
   
7.     }
   % R2 Y8 x  Q3 @' t2 ?0 N# @1 h
8.     return q.reload();
   
9. }

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

! s# m' ^6 h  ]/ Z% E
- t- c5 ^) g, eМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
% W; W: U* O2 D3 ~Метод reload(int questId)
3 x8 N/ v3 H8 I; v# n! q; Y

1. /**
   
2. * Перезагружает квест по ID.
   & S& W- q/ G  F5 t: A( o) q
3. * @param questId ID квеста для перезагрузки
   ; ?  O" C" Y; ]* p) _, I7 q
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   - ~" u( E4 x6 S* n; D6 k
5. */
   
6. public boolean reload(int questId)
   ' ]% A; f! ^" o3 H5 k
7. {
   9 c( i: h) N- [" R$ C3 T
8.     final Quest q = getQuest(questId);
   4 ^* H+ Y! s" H3 A+ e7 k# v
9.     if (q == null)
   4 T% S; J1 ?8 e. }" f
10.     {
    % ~, C8 \" i" q! _$ a% k1 i- w8 `
11.         return false;
    
12.     }
    
13.     return q.reload();
    8 C. K% U+ M8 C! _* ~( a0 P
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  ) w) ^  U" Q6 F

Метод reloadAllScripts()

1. /**
   7 ]' W5 G$ z/ R, ?7 a0 l$ ]
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   + b, g$ v/ `' _- [- b8 o
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   1 L- {: w' j" j& k+ ]6 j
9.     try
   ) u7 r/ r1 ?! M, }
10.     {
    % T2 O/ P9 f+ r0 G0 ~
11.         ScriptEngineManager.getInstance().executeScriptList();
    ; B3 j& D. z. }" b/ z
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    $ Z, y- n' q' I6 W$ C# C
18.     getInstance().report();
      ~. u; p) R7 `. w5 ^, }7 g+ @
19. }

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

Метод unloadAllScripts()
" P) ?1 W7 A2 O& Q
; E- x$ ?) Q5 q0 D  \( @: c

1. /**
   ; q. b* S& M6 X  b% b8 c
2. * Выгружает все квесты и скрипты.
   
3. */
     B- @$ L2 P" f! I
4. public void unloadAllScripts()
   ( I  o8 ~" _' J. o  W
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   0 b0 u" K- _$ ^8 ?% d. D7 h6 c" z
8.     // Выгрузка квестов.
   7 w0 l8 r/ ?3 K; {9 X( ~( o% \- Z) i
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    ) S& c( Q( A( M# S8 T8 \" i5 q/ @
12.         {
    
13.             quest.unload(false);
    ; Q: p! s4 y! u/ b
14.         }
    - e& B/ r" K( Q( v% l' X
15.     }
    ; Q$ j7 b9 x; y. r0 M0 x; d
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    6 C1 x1 g. m" E% J) y% |+ a
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    
23.         }
    
24.     }
    
25.     _scripts.clear();
    
26. }

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

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

Метод report()

0 X7 A9 h! \( r/ m% x

1. /**
   ' o0 g1 T; U" @  f3 l$ d
2. * Логирует количество загруженных квестов и скриптов.
   & m4 c4 _. r' w7 p& }' J: `1 [
3. */
   , W: X' r6 {  ]3 m6 [8 c
4. public void report()
   # n8 h# R' R; E
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   + p( c$ B% U! Y* @+ s" l# O7 e3 j
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  * F7 c& _) B9 b8 W& b( }' a1 v

' A2 o/ s! \% d7 cМетод getQuest(String name)
, e7 M0 n9 j! n* t; T

1. /**
   # z8 `' O) U, ^' v) K3 a# i5 M
2. * Получает квест по имени.
   ! z% C; r2 m# H3 b; I, e4 t. A: W
3. * @param name имя квеста
   - I$ z" d# m; u. h
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   1 ?& p  {2 v, r9 n3 v, U
10.         return _quests.get(name);
    ' t( p1 p- a& {& s+ Z; D; ^+ ^' M
11.     }
    ) g; k  v2 |. Y9 O4 L
12.     return _scripts.get(name);
    / F/ Q1 x% B, T( y
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  / z+ U2 e- l9 h$ j. z8 w7 o

Метод getQuest(int questId)
# k: Q9 O! P/ w; T9 U$ }

1. /**
   
2. * Получает квест по ID.
   $ o0 Y5 v5 D% E8 h9 C* W
3. * @param questId ID квеста
   $ S3 a  @, D  k% p) n5 q7 _, m
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   - a/ h' F9 m6 w' u: _, e7 [
8.     for (Quest q : _quests.values())
   : H% ]  I+ \+ L: c$ e1 s2 N" k
9.     {
   
10.         if (q.getId() == questId)
    1 B: k: O! G1 m" |1 |' O
11.         {
    # a; k1 n$ s0 G8 c
12.             return q;
    # R5 p+ r; k& ~
13.         }
    
14.     }
    % X6 Y" k3 f) d7 B( o8 ~
15.     return null;
    4 L8 @9 e+ r9 [# y# J$ p9 M0 u
16. }

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

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

Метод addQuest(Quest quest)
7 ?2 o& _% Q! k, M; P
# |/ I6 Q# Z& S* [8 p" a

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   % r3 J' M3 e0 Y5 u
5. public void addQuest(Quest quest)
   
6. {
   . H) ?5 P1 ^7 B3 d: s! ~
7.     if (quest == null)
   / g8 u6 ]  t1 j4 I+ K
8.     {
   1 n4 X4 Y# P) S
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    $ L& U, ~/ K+ ~; ^& p
14.     {
    $ _: _& j! V- i# J
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    + @" f0 S8 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();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
      q# x; p8 b* r. q) W1 G  B. I
23.     }
    2 ^# [+ U6 s1 i! l4 ]
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
9 _* ]$ ~8 [9 R# R& c# f, V5 oЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.