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

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

Разбор файла QuestManager.java

: x3 f5 t' p4 E% L& k. J- c; u1 aЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
- T8 i9 i5 s/ D3 h: B5 c; GОсновные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    - q' E; S2 u$ R' R- o) t5 w
• Импорты
  

. C" R) X. b( ^+ i7 l2 X* B* O% N; e& ~QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
. }9 x. L# [3 h! Z6 B
+ @5 Z: q; [6 U2 G
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
* r3 S5 ]0 O" j- P0 e

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   1 g2 E  Y6 n' C6 ~  U0 S
5. * её в соответствии с условиями GNU General Public License, опубликованной
   6 I5 X, z* \8 p% o
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   ! o. ]/ e) P, E, I
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   $ S/ }1 U3 G/ a
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    $ d5 m, U$ ?' w! {  H* s
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    ! x  i/ Z: v; ~* z
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
3 u, h3 S6 d% c8 y) Q
$ r. ?5 L* g& @, p9 ?5 h. U
5 c. h" H& w6 I( v2. Импортируемые библиотеки

% }7 I' q& h/ I; p  Y9 }

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   ! o2 @+ l4 Y+ C
5. import java.util.logging.Level;
   " T4 G" F" X7 O2 G9 r0 h6 P
6. import java.util.logging.Logger;
   . i7 N; @0 F$ p/ l, E
7. 
   2 d9 Q1 Q. E# s7 V( Z" l/ i
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 — менеджер для работы с игровыми скриптами.

5 `* ^$ p( _1 U3 L! |/ Y8 z: v; m4 a- }3. Описание класса QuestManager
  a2 e$ E8 w! f! H$ u, t7 I" z" p7 o

1. /**
   
2. * Менеджер квестов и скриптов.
   " x8 y+ A" z' K
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   
6. {
   : b! T& N0 c, Z* I" C' y/ o. u+ e
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   4 L! C1 W% D: \; G2 `2 H
8.    
   5 o% L# h! |$ b" S5 f9 @6 [
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    ! R+ T% ^& r& f; [2 a& E
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
      ~3 l8 g# @/ K6 P. S
13.    
    7 e+ Z5 X1 @" Z( G' N8 `4 }
14.     protected QuestManager()
    - t2 k5 H2 T: `' t1 e$ v
15.     {
    , {  \2 t  ]2 l; ^
16.     }
    
17. }

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

4. Методы
Метод reload(String questFolder)
; N9 l/ C, m3 s" j- \/ s; T

1. public boolean reload(String questFolder)
   
2. {
   , f; ^5 a1 I* x* x, C
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   ) I7 c, p* w. _+ l
5.     {
   
6.         return false;
   . c8 O) Y- Z* v5 T
7.     }
   
8.     return q.reload();
   
9. }

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

8 N/ C- Y: P: j3 [+ j" D
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
- |* S& m; a  |; Z9 z* u; d$ dМетод reload(int questId)
: L; r% c# P; H' ]9 S+ k4 d
2 e; R4 s" S) Z0 [- w

1. /**
   
2. * Перезагружает квест по ID.
   ) }0 {! z3 w% S9 I8 ]0 Z  l; ~/ @) r
3. * @param questId ID квеста для перезагрузки
   . v: A# g3 s# q: Y6 l+ K
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   ; c& a( a; s) o$ Q& A/ u& v
10.     {
    $ C+ K4 x. E; }* V+ r) X6 z
11.         return false;
    
12.     }
    
13.     return q.reload();
    
14. }

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

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

$ Y% V3 a2 u+ N' ?Метод reloadAllScripts()
+ M( X% ?& e3 J+ @! Y8 m

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   2 K* H2 ?8 _7 `/ `- a5 x2 |, n
3. */
   
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   ' B5 ~7 M2 E  r1 t4 h, m
7.    
   9 L  a6 Q& Z" x% U$ |
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   1 `' g  j" X# S% r$ J% f
9.     try
   
10.     {
    + y# |' y, h8 d  q7 l
11.         ScriptEngineManager.getInstance().executeScriptList();
    " ]$ I5 b* e# Z2 v- p- W8 ~
12.     }
    & J; N, U4 i  M5 i% M
13.     catch (Exception e)
    / [  d* K9 t5 [4 S! U3 I* M% ~
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    , Z- _# I5 z' o4 H8 C
16.     }
    
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()
. ^* r1 \; P+ A5 R' f. x8 m

1. /**
   2 S2 T* k; n, O6 i( _7 C
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   4 I( Z8 A; J+ m2 n6 M% i
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
     Z4 p4 f$ P8 z9 H& S5 f
9.     for (Quest quest : _quests.values())
   
10.     {
    5 k4 b+ [5 A6 q  y( M
11.         if (quest != null)
    
12.         {
    1 j# l: E. O& [2 J& f
13.             quest.unload(false);
    : k$ n$ k# N0 |
14.         }
    
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    , W' _2 w, s7 O
21.         {
    : z( |+ ?$ I% |9 }
22.             script.unload(false);
    7 `  N4 M- r4 U7 s# a( G% Z
23.         }
    
24.     }
    
25.     _scripts.clear();
    $ j' d% Q3 J" Z% b4 s
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  0 z9 y4 B  q* {  e: i3 f

( J7 b% l9 {& T1 v5 M! |0 U! iМетод report()
) Z# G& V0 @6 s8 j7 L
3 V$ S# i* d6 J8 H' q" f& S7 F

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   / _9 p& g' n% c0 {* s7 W
3. */
   
4. public void report()
   
5. {
   , t, ^$ t$ N' Z3 \
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   2 p- p6 E4 s- _0 ~" ]
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   ) k$ `! m2 K: x7 H8 e) n* W
8. }

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

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

Метод getQuest(String name)
" {% f* `. F9 P/ k0 B. G& p/ U; p
# C! e% e4 A# Y* \; G

1. /**
   
2. * Получает квест по имени.
   0 z) s; X% i  c: q# {
3. * @param name имя квеста
   
4. * @return квест
   5 X3 ]; ]/ L# B9 u1 @- T
5. */
   5 F$ H* \. e2 x  ~; i7 z" k
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   1 }1 H2 j- |% Q! q' d
9.     {
   
10.         return _quests.get(name);
    
11.     }
    * b" a4 }. m  G# z5 j8 U
12.     return _scripts.get(name);
    6 H, d: n) x7 M# W2 ]1 T# v
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  % D6 ]* i* P3 T/ o9 x& l

Метод getQuest(int questId)

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   9 [. K$ ?5 s  W0 H8 l# N  h5 z! X
5. */
   / t! m' p& N% `9 q% h
6. public Quest getQuest(int questId)
   & U" z) R" D. \. v
7. {
   $ P( b2 f+ p4 ~3 ?
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    7 t$ F8 l' c: X2 N7 h
11.         {
    
12.             return q;
      q; s0 P  M6 g+ N
13.         }
    
14.     }
    - Y/ C, U2 z) c
15.     return null;
    & X. i! q+ \; g
16. }

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

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

Метод addQuest(Quest quest)

& h+ ]4 k3 F3 C6 m

1. /**
   
2. * Добавляет новый квест.
   . h) P9 ^5 r$ W. @
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   ) W+ e- C) x7 p: z, i' f# ]- c
6. {
   
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    7 k0 y% v! W% |0 I; `2 u( V- [* f
12.     final Quest old = _quests.put(quest.getName(), quest);
    ( l+ p( _3 g9 i) P; h4 Y- Z7 ]/ K
13.     if (old != null)
    " [! q! H: {5 W
14.     {
    / h+ p5 ^5 P4 w* {/ l
15.         old.unload();
    9 l# ]/ A8 z8 q& r& L3 N9 P5 x/ \( F
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    - E' V+ P4 b( y
17.     }
    
18.    
    
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();
    0 r* b& X4 b1 m+ M
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    4 o0 P- j- A$ e2 g4 d
24. }
    - G! j' N$ T" \# \! K# F5 u/ t2 l
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
8 K5 P4 G  s' OЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.

8 H9 s0 W; v1 l: W3 Y
. w, i. T+ {2 J4 A8 X