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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
$ a3 Q) F- k$ ~9 T9 m0 Y+ [
Разбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  1 S# d+ t' |, S. H4 y

QuestManager.java — управление квестами и скриптами.
$ B# `0 _' _: aПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
% f6 m0 M  `: b( }

* T: |5 l) a( W1 t% K7 IДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
8 _+ m& D# l( u9 U0 X4 A$ a

1. /*
   % S0 L8 }5 N6 ^3 r; l4 C3 c( o2 ^
2. * Этот файл является частью проекта L2J Mobius.
   " i& \- d) c& w( `5 b
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   8 h; f: [' y: e6 i. p: z- j
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   ) K) Q* x. h& T* {6 |4 q
7. *
   5 g+ ]' c0 W) q; V
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   4 |. S- z* a& |/ X7 U' k7 L
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    ! K; [% |% k$ Q$ [- ]( {' Z
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    ) q) j( g1 C7 K7 [" I4 j; V. B
15. */

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

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

7 K: i7 k6 B9 S5 J4 K" O
2. Импортируемые библиотеки
2 `$ O8 L  q+ ?+ e+ N. h+ {
& ]) t/ s7 P; i2 [, k2 T

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   9 m0 L' W- X; ^7 T: f
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
     \( `$ K. A& X( O/ u& S) ~! T
6. import java.util.logging.Logger;
     A* N. X# T! a. F3 P; B
7. 
   " H0 {9 g: Y% v5 u
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   ) w" D: ?7 A/ N7 R# r* J" ^$ q6 P
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 [, i( C3 ?- U+ M) ?  R% z
/ g5 D# p  C! D- A5 Q3. Описание класса QuestManager

1. /**
   
2. * Менеджер квестов и скриптов.
   9 t2 Q" A! O5 J$ r! O. C
3. * Автор: Zoey76
   " F2 n) g6 P+ S% n. a% M: u. J1 E
4. */
   
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   1 {( e# L5 D$ S( O, h2 V9 l1 _
8.    
   
9.     /** Карта, содержащая все квесты. */
   ' V  v5 M5 y: R9 C/ t% ^
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    # I0 A$ V# ^) F8 W- m
15.     {
    
16.     }
    " H8 ^  z8 l( r  V0 n1 G
17. }

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

4. Методы
0 C/ I- x1 F) XМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   ) {1 c1 @' A, u; ?" O
4.     if (q == null)
   
5.     {
   % V* o3 K6 P" x$ |9 _# u
6.         return false;
   ) m5 J& n! u2 L9 j* E
7.     }
   
8.     return q.reload();
   
9. }

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

. A- B' G5 P% aМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
  y. s8 W( j% z) f; d" d7 i2 K
! y2 X/ w/ k  v" S

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   $ q2 l% q$ a) K3 C* |' I
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   : w) |$ V& l- B  `: e, D) g
7. {
   7 V8 \7 o5 m$ [) f
8.     final Quest q = getQuest(questId);
   0 T4 U+ c8 f; r! N
9.     if (q == null)
   
10.     {
    3 }1 `7 `; T# F2 _2 s
11.         return false;
    2 a8 g- q) l$ h$ e2 y& t
12.     }
    
13.     return q.reload();
    * Q& C0 J+ n: @% N# f
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  ) G9 f/ x3 m0 O# r% L: q. Y

Метод reloadAllScripts()
8 d5 o- \+ [$ J* G6 G
/ B: }+ |# [1 D' b& g& }* S

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   ' M3 t1 K  O  |" G9 L3 W
4. public void reloadAllScripts()
   2 z! k0 i9 L  Q/ b" ~: Q' w3 U
5. {
   
6.     unloadAllScripts();
   0 w  u: q4 p! F* o6 S8 e
7.    
   ' G: ?9 j6 S! |. U* l1 J8 b2 \3 ~
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    0 q! G1 \  W9 E. {, c
13.     catch (Exception e)
    
14.     {
    9 n5 o5 S( s* R/ k/ O8 X# v: F$ m
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    4 Z0 f! ^1 S8 @. \4 u* T8 J
16.     }
    
17.    
    $ ]" S5 z5 j$ z6 T
18.     getInstance().report();
    7 m. q# j* F) t# n
19. }

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

Метод unloadAllScripts()

* i9 |/ Q, f  `6 n4 v1 K

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   7 |% T+ g+ ]0 M, D
5. {
   8 a7 n$ f# R4 Q! L, E: b( v
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   4 d6 P5 c3 C- ^  P# @
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    
12.         {
      g3 ]) g) ?$ R$ a* P2 z4 g: A
13.             quest.unload(false);
    
14.         }
    " I' x: S7 z( O  O0 m$ G
15.     }
    8 W' H; h3 O/ Q! s! o
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    * `4 ]% f  _% O9 b" W
18.     for (Quest script : _scripts.values())
    3 x" A# G3 U6 P2 ^- B0 ~# a" ^8 }
19.     {
    " {9 q$ D" T9 I/ }
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    ' P1 A) o2 D' R
23.         }
    
24.     }
    ' b# b: S6 a- F6 g/ S" L2 X2 f8 k, E
25.     _scripts.clear();
    
26. }

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

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

Метод report()
+ f4 v: Y, A7 D- T; O" f

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   6 P5 X' B( \1 P) l3 L% u% s3 Q
3. */
   
4. public void report()
   4 y* P8 a# o( o! E2 x* X
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   ' Q: d. w' m( a% J4 Q# H
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   4 S- c9 _( ?3 o4 t; T( V, \
8. }

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

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

Метод getQuest(String name)

8 ?4 {+ j2 |+ x, R8 T+ M

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   . J: I( T: l& f% ^/ E1 g$ A- n
6. public Quest getQuest(String name)
   8 h, X0 ^/ j4 {1 c
7. {
   8 q3 e" B( P) F/ W8 j1 e
8.     if (_quests.containsKey(name))
   ; c$ g, _% S  X$ h' V! n6 g
9.     {
   9 }& T8 k, C& p2 @4 s
10.         return _quests.get(name);
      b0 @' ^- q9 b" T3 G$ Q& ], U
11.     }
    : s8 p1 J" X! B* L" B) ^; D: I$ g  V
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  1 F2 i; }+ t: h# G$ d5 V

6 s& _& [/ a, U5 X- S  |Метод getQuest(int questId)
, D( S. X5 b7 t% g4 M* j0 R9 f

1. /**
   
2. * Получает квест по ID.
   1 _2 Y; D( k5 V0 h
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   0 J2 R9 C; s5 W: H
5. */
   / ~5 }3 K. `3 D3 p* D2 M
6. public Quest getQuest(int questId)
   2 f) U8 a1 [& P
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    : u" W$ d5 }% a- C
11.         {
    
12.             return q;
    ) ]& H, N7 V0 x6 b3 w9 e
13.         }
    0 O/ d, i0 p$ F' a. U
14.     }
    
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  0 K* v/ ?5 y6 X- {0 ]9 g# b

8 I. f, N# ~, m$ }% u4 TМетод addQuest(Quest quest)
$ C5 R1 R: n" M

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   
8.     {
   0 ^9 m- N( I$ X9 k
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   ' N: j7 U6 C& j$ b1 ~6 J2 \
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    9 ~0 i9 \, n( A; n$ D6 E$ ^& Y: }0 `
13.     if (old != null)
    , a  D; e6 q. n9 @1 o: N7 T
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    9 V2 K! q$ f$ A) A2 N6 i( P& p
20.     {
    + l$ @$ e  e3 ^) [1 Z7 _
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    
25. ``

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

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



/ {3 E1 O! F! |- c# S% O9 k  h