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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
$ ?6 h( [9 \- E8 I* X5 j3 h0 k9 w7 `
' X6 T" W  p2 d4 `Разбор файла QuestManager.java
6 |- {& [; M1 y& `9 t
: o7 ?0 X5 i7 I6 v! k! J8 nЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    * @, \: P% N, Q  z: E) W' z* ~
• Импорты
  

" K6 |" u/ g$ YQuestManager.java — управление квестами и скриптами.
8 @5 R8 K* P- o; v3 d  xПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
4 i2 B# D, u& X

Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   6 @  W- v* N8 Z8 b- ]5 B
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   0 o) w4 k  x- d6 k5 _4 e& w
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   / i( R# [+ ~+ E5 f
7. *
   * |* ^- H1 I; b9 C8 h8 ^( S' J
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    4 w, Y6 V! D% p( O9 K
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    * L; e& d2 r# I) I+ w- Z: f
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    ! D- M5 c1 |* z
15. */

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

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

/ j! K* w6 P2 J; t/ l
2. Импортируемые библиотеки
  O! _! Q3 L, s. v* Q# [$ h
- `$ I5 I/ ], g$ R

1. package org.l2jmobius.gameserver.instancemanager;
   
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. 
   7 ^2 Y, v! M6 g  b# `
8. import org.l2jmobius.Config;
   ) m; k5 E6 U# g5 H- _
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 — менеджер для работы с игровыми скриптами.
1 f8 s# _; ]: [9 o2 p. q
* Y  ]7 W, X  N7 d+ ]3. Описание класса QuestManager
! _2 S9 j+ r: J& S2 T4 Y7 N

1. /**
   
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   * C: w- ^0 v. _5 l3 ~
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
     m9 f0 S. e# C9 Q& Z: |
8.    
   " F) V+ d4 ?' c) q
9.     /** Карта, содержащая все квесты. */
   : I' ?3 O. z; n3 t, ]* \  h
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    4 M9 p% C3 q* m/ }4 h
11.     /** Карта, содержащая все скрипты. */
    4 I" y2 w2 {5 K4 V  t
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    : `' Y& g+ ?$ x
13.    
    
14.     protected QuestManager()
    9 q: ~- u& }+ b; k; K
15.     {
    " J4 x2 s6 O' X! C' F4 v2 |' K0 `
16.     }
    9 `- v% e" ]* h- Y  z/ T6 [& d0 L
17. }

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

4. Методы
Метод reload(String questFolder)
, ?* V7 m1 M# I2 i% _3 f

1. public boolean reload(String questFolder)
   ( V# ~$ M: g: Y* P
2. {
   ; D: w& l) u( \* N& P
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   ) \% j, R. @9 u
6.         return false;
   8 C7 m; {5 a: [6 s! g4 j
7.     }
   
8.     return q.reload();
   
9. }

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

. x0 P  P2 M9 \) ^
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

7 j& u, q' ~3 t. f

1. /**
   ; H  O" U$ g/ I  d! S3 l2 i
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   . n/ ]# c0 P4 x8 C+ s% ?" ^4 t/ c
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   . _6 Z, X7 n0 S& p# k. x0 I4 I( J
9.     if (q == null)
   % c& R- `+ f: Z# q, P- p# f
10.     {
    
11.         return false;
    ' x% v1 q* V( `4 @9 A0 T6 t$ G* U
12.     }
    
13.     return q.reload();
    3 Y! g  t, _) H" C5 _
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  0 C# Y* l( b1 w

2 t3 }) {  o- F: V% MМетод reloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   & e) B4 m& F/ R
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   + ~6 X* d' v2 E. r' H
7.    
   : u# X' L0 j" K7 U! Y  d
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   3 Q* t" ?: m! Y/ G1 Z) {! x. Q
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    : s$ |, Y, l( S; u# R
13.     catch (Exception e)
    
14.     {
    8 W2 l3 o5 q: \: X/ N
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    " n( y" E" t1 {  s4 Y
16.     }
    % R" C. V8 t2 }# t9 P. d
17.    
    4 l1 \) B% c* ?8 R
18.     getInstance().report();
    ( ?7 d  d3 \* A+ ~, A
19. }

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

Метод unloadAllScripts()
7 K3 ?; a- e+ U' E% e
; \' e  }2 _4 d1 ?. E8 y

1. /**
   . ^* O% v8 a! X2 V9 a- t! D, }! K
2. * Выгружает все квесты и скрипты.
   
3. */
     e: P6 O* c/ z, Y7 O
4. public void unloadAllScripts()
   / F7 Y$ @5 o. ?5 \% m
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   1 ]9 @7 }  @8 D- ?4 f/ p9 Q# ~8 k
8.     // Выгрузка квестов.
   0 B% j% a% m( n& W. G3 G
9.     for (Quest quest : _quests.values())
   
10.     {
    # _8 ~2 p9 `- V9 y  W
11.         if (quest != null)
    0 a( ~, ^$ ~% j' E$ T  s0 t2 N) M
12.         {
    
13.             quest.unload(false);
    
14.         }
    9 ]  y: i; u, F# }  f
15.     }
    % p' C0 W* N- x: j& B/ d
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    5 M2 o3 {6 Z! M' g% S+ Y$ r# b
18.     for (Quest script : _scripts.values())
    ) F/ ^! g  Q8 V1 N$ F
19.     {
    " W! R0 ~% T1 S
20.         if (script != null)
    0 I. s4 x/ Q( r0 M
21.         {
    
22.             script.unload(false);
    $ v* e! {  J( B* B4 u: j! ]0 G
23.         }
    & Z) x' Q5 W2 E9 f/ j8 l. @
24.     }
    1 t- o/ ?0 ~1 t* d4 R% R
25.     _scripts.clear();
    
26. }

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

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

" ~; K* N4 ]) R8 d: ~! O% A$ @Метод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   ( F5 y1 j  e5 X) s& X( G* i! o
3. */
   
4. public void report()
   6 p- @+ e' A# j& a/ K
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   & Z! {" v3 |  I+ w+ i
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   ) I1 r2 H5 I% X! e9 r
8. }

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

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

/ K& d8 m; |' MМетод getQuest(String name)
" {$ j- T6 h5 T* `; _) W

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   " S. T$ w  h2 J8 ^, i7 p
4. * @return квест
   0 k/ \5 s: \% e& d/ t9 p& ?( C
5. */
   - U) g/ q/ f' L, v5 _8 H  o# W
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   ( U  R5 r" l- N5 Q6 j
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

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

Метод getQuest(int questId)

1. /**
   
2. * Получает квест по ID.
   , o1 j* \3 G2 e' A9 H
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   6 n' a" Z) _8 m5 C% z( h
7. {
   
8.     for (Quest q : _quests.values())
   ) s" C! y& ^2 s: l
9.     {
   4 }, s. \7 M% V" L% j* c
10.         if (q.getId() == questId)
    ; L, v$ s3 U# p1 N* \
11.         {
    
12.             return q;
    + }$ y( r& ^: {
13.         }
    
14.     }
    6 [+ O' Z, b0 H" E* K, W3 ]* R% N1 n
15.     return null;
    & Z; l4 l& ?8 M% d
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  ! S4 l. R" b8 P2 v2 o9 D. K

Метод addQuest(Quest quest)
, t$ E- l" j8 c# j( X

1. /**
   3 T" |6 l% M( @
2. * Добавляет новый квест.
   7 d* Q; C* V4 e. z' u
3. * @param quest квест для добавления
   / N9 H9 I; d" X; y* |! }: ?
4. */
   4 p+ q" U5 c, G6 F! ]
5. public void addQuest(Quest quest)
   
6. {
   : j  I- ?4 K. ^( Y) K, ]7 a
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   % g0 @- N6 s% E1 L
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
      w( f( \/ U4 |0 J( y3 t+ v) _& p4 R
13.     if (old != null)
    
14.     {
    8 T# j- a; c# B! g
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    8 r9 |* }' J) [' v4 j# @: _3 B* o
17.     }
    3 n) |* ^" C1 ~5 M5 w
18.    
    . Q; P# H, d, P9 C
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    ; [# y% |0 O, f9 q) U: v) l
20.     {
    : p) p/ j" S3 \, Q1 H+ O9 }$ l/ N
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
      `$ o; I: k! ?
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
: x+ O  F+ |+ ], g8 ]" wЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.


) h9 B5 b& @% [4 i1 v/ l