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

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

6 {2 X0 I% d! A7 M& E) |* r5 bРазбор файла QuestManager.java
9 P, \9 l2 p: V' P2 o2 k
Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
+ t$ U; C# E1 {7 O& _

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

QuestManager.java — управление квестами и скриптами.
% s; g- h: H6 B1 k. u$ uПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

& g  E5 G6 N, P
5 I# ~: v1 i8 L$ w% ]9 uДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
8 k* {2 e) B: w( n3 Z% H4 y1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   7 g, D, n: `2 \% f4 R
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   $ T8 k$ H' K2 D" D5 n( s$ h1 S, |' C
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   * `/ G) h& ?1 O7 ]
7. *
   ( U( R# p, x# \6 Y' o
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    ' I# S2 s1 I& Z4 O  A
11. * См. GNU General Public License для получения более подробной информации.
    : z. Z6 c9 ?9 z- X* ], i: m, g+ c1 h
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
, V" {& \8 _+ }% ?# ^. g' ~; t

; p1 x5 I7 N& I# z2. Импортируемые библиотеки
: C+ z* n0 U( f7 v5 I

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   $ ]' X! H, N* U$ g7 K0 O: ^
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   . Q' C: F  h% s) F9 J- o
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   
8. import org.l2jmobius.Config;
   0 V5 s5 f/ `' d# V0 ~
9. import org.l2jmobius.commons.util.CommonUtil;
   , P8 X1 H- I: W* x8 _1 A7 I
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

1. /**
   - `* y% v; U1 ], E7 [
2. * Менеджер квестов и скриптов.
   - z$ K. \0 \8 K4 m1 F
3. * Автор: Zoey76
   / u& L3 s$ ]4 \0 l" U$ n7 c
4. */
   
5. public class QuestManager
   . }" w1 ^( b! y4 x8 Y
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   8 G' v& [0 x' f' J* M+ I
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    % `5 O9 V- P: Z, d5 d
14.     protected QuestManager()
    5 g" l8 X* h% V  R9 s  c0 Y: D
15.     {
    / z6 y6 k# |: G' ^. C
16.     }
    # @% k3 n6 C+ L' ?0 P2 b* l& s) P
17. }

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

4. Методы
( f/ ]. P% J! Z) K( cМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   + y- X. \; x$ g
5.     {
   
6.         return false;
   
7.     }
   $ z  \; M. T2 D: k( D9 a" p
8.     return q.reload();
   $ e: O- H; p/ w0 {  D' c
9. }

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

8 \/ i4 M/ M9 }9 r
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

1. /**
   : ~5 ^' ~* T/ k* l9 q' S
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
     x, B, K( u! n! t6 j
5. */
   
6. public boolean reload(int questId)
   
7. {
   3 `6 ~; q. [+ d+ z" E1 ]" x
8.     final Quest q = getQuest(questId);
   4 s7 _+ s/ X0 ~
9.     if (q == null)
   + c& D  e9 ]8 m% d( J: N0 Z! ]" N. d
10.     {
    % B! h8 x4 a4 h& N$ y
11.         return false;
    
12.     }
    . I# j, O  m+ X& j& s- P# V2 f
13.     return q.reload();
    & M* G5 A' y$ k! y5 ?9 b- \1 D* V
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  3 A; o. H# v, t' S$ d

Метод reloadAllScripts()
; N5 J% J. X: ^. [0 c/ m& X+ S
8 P8 m6 t6 K6 Y) x6 M/ y, l' Y, D

1. /**
     _/ }  R' s, t1 \% _9 T
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   & D9 j- f* p1 B- K) f
5. {
   1 ^7 \( L0 {" ~( G. Q
6.     unloadAllScripts();
   ! h4 k: J( h+ m/ B1 _' X# i
7.    
   ) Y: b. i5 O" u! A6 I6 [' E
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   + Q7 j  y2 e  X4 S" l- E* R0 l
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    + w/ P- ~3 w; y
12.     }
    9 D: R  U% F: w: G1 l. R
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    ' b+ z" Q# T' X' R1 K
16.     }
    
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

1. /**
   - g* s1 a7 \$ ?
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   * l  k4 Q+ [# V6 m2 V! Y7 b
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   1 Q4 f9 f1 k2 L/ g: s
10.     {
    0 D! r  D1 h  k* f* I2 L0 K4 X
11.         if (quest != null)
    1 E- O7 K, O: O: a" x2 x0 g
12.         {
    
13.             quest.unload(false);
    % J. Q& A/ \  X+ }9 O! f1 f) u. t
14.         }
    
15.     }
    / J0 p! Q! W1 P( [$ _7 q
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    & l& W( B5 b9 ~6 X: g
19.     {
    
20.         if (script != null)
    1 E9 w+ p) X; p( H) v8 T/ c
21.         {
    
22.             script.unload(false);
    
23.         }
    ( V/ I7 i+ T* x1 I, i
24.     }
    
25.     _scripts.clear();
    ) S. p* i4 I( `- h3 w, G2 _3 |
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  , N# W- T, \+ t" _4 E

Метод report()

$ t, s) l( n( m0 V( u0 ^

1. /**
   ' u5 x2 S/ B  E9 O$ u  o5 ^
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   # O, h, k" M. J4 v% z
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   8 w$ {# U6 W" g
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  ! T! P3 j: a, T+ m3 d, u- |

Метод getQuest(String name)
. K. z7 L# ^3 Z' J4 Y8 \

1. /**
   & o# _5 q7 w+ L- W6 g3 l2 Q" H
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   1 v+ ?1 F& o7 L- S. S* |% b/ m
5. */
   
6. public Quest getQuest(String name)
   
7. {
   $ {& g9 W2 x. e0 C' K' O# x
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
      ?  [2 \, B- D, Z' F
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  5 L# z/ }$ ^) f5 ]" ~

Метод getQuest(int questId)
1 m( R1 \8 S8 q; @! f
0 a, W/ q: Y; I

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   + @6 d6 q, F" W- \# Y
6. public Quest getQuest(int questId)
   0 E: }7 V$ P8 x# u
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   2 v$ p% g! n+ a
10.         if (q.getId() == questId)
    0 Q* n' r: m; q8 L# J' @: Y
11.         {
    $ X+ q4 i$ V; v( s
12.             return q;
    & s2 I( g! m/ A- H* x: T1 U7 m
13.         }
    
14.     }
    
15.     return null;
    - ~- S# E" i/ f' X5 {; |
16. }

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

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

Метод addQuest(Quest quest)
8 `4 \" e' F! W/ @4 C: E. r
9 n5 A6 Q; y! k, Y2 B  s0 i

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   ! D( E& H/ a* F% E* c  D8 n
6. {
   
7.     if (quest == null)
   
8.     {
   / d1 P; V. z" U6 q8 k, L* Y
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   + n1 U" ~: \* b0 N. z6 k2 O
10.     }
    2 `9 Q" E4 v: b& u& b* R/ r* e
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    6 L9 Q) H' r2 K7 d
15.         old.unload();
    3 `8 p4 R$ X! Z0 q: W- o+ ?$ l# p
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    ) {" u" O  Q; [* m
17.     }
    3 h' w/ u8 J$ A' E8 C2 [
18.    
    7 r( m/ D2 {) H) j. ?
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    % K5 v3 i% F0 V% R$ C
20.     {
    $ E8 t$ B0 ]$ a+ {$ l$ A  Z: N2 ^; F
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    + d3 S$ q: |: d! O7 X6 h
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    8 D) b6 A6 g; h: p& d- j6 u; B
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
! b) w* J5 Q4 r) v5 v6 x7 R+ dЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.

' f# Q$ c' Y; ?! k
, d" {% H+ B# v( O- t