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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
, v9 d( v  r  C: [
Разбор файла QuestManager.java

5 X- s$ m- Q# f2 T; R: a9 Z  _  |Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
1 I5 ^4 r6 U& H3 |, `

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

QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\


Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
5 Z& s, w5 y+ G# ]' X

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   0 Y- H+ c9 @% U9 ]  N6 O# _
3. *
   2 B& H( h1 o) C# U. A( X# ]
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   . i! g0 i4 Y. e
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   4 R$ e: g' h) R8 V* O* L  t
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    - c' q$ h2 m% z% b9 O/ D: [$ C
12. *
    ; J4 B4 P- L4 V- o) w$ S* E6 c
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
. N; E+ C) d% m+ I! |, C% D
- [  ~5 B  i" X) B% E
2. Импортируемые библиотеки

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   & o9 H7 w! X% ~* B/ b) i  k
3. import java.util.Map;
   7 b$ T1 |2 Z3 |
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   % L( z1 _0 I) @. n! \5 y
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    ; [1 [7 h+ F1 b# q8 b% U4 `
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 — менеджер для работы с игровыми скриптами.
9 U) j0 o/ O0 F4 B
3. Описание класса QuestManager

1. /**
   
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   $ n0 \7 ?% E) V0 U2 y6 d
5. public class QuestManager
   
6. {
   2 W: ^3 `" F% }
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   ( m5 n: \7 t7 K5 _" z
8.    
   9 [) R0 I+ ]- b
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
      l( j' Y2 L; j3 K+ p) }. B- X" d
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
      ?/ C, \  T2 M1 Y* N! D+ k9 w
13.    
    % p6 m& T% e& D# ~( w) _" m( \
14.     protected QuestManager()
    
15.     {
    : h& C) {- t- p0 P" I& s. |
16.     }
    % f+ c, f% b$ C2 G' ?: U
17. }

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

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

1. public boolean reload(String questFolder)
   1 Q/ K: I$ T) s2 U2 g% ?5 t. z
2. {
   6 b* `/ u0 B8 n2 }6 s
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   ( ^$ ]% J$ }' N) o7 n! a
5.     {
   
6.         return false;
   
7.     }
   - q. c8 N' S# A% G9 Y5 [+ o
8.     return q.reload();
   7 P3 h# z2 d/ x! }& b) m! |* C8 j
9. }

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

! V/ d4 a6 |1 R6 U
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
+ l: F( _0 v, l8 V7 v4 nМетод reload(int questId)
+ i0 n* h% q$ y/ D* r5 J2 b  v& b& R

1. /**
   * V. r# @8 m" T% {+ Z
2. * Перезагружает квест по ID.
   , ]6 g' i" Z* v: S0 G
3. * @param questId ID квеста для перезагрузки
   # D- B7 @7 m  l: j0 C4 m) y1 I0 Q
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   . N  W" }! H& k7 x
5. */
   8 O: W+ m8 G. Y* M  Y% ^" G( P7 ?6 {
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    
11.         return false;
    . h0 P4 _: S. t% z, @% N* y
12.     }
    % _- \$ W* U+ i4 c/ S1 c# M
13.     return q.reload();
    4 n3 n7 q. A9 }1 H0 y
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  2 e6 |0 T% t2 F2 o/ P

Метод reloadAllScripts()

; N/ L* b! |1 d) P2 P( O

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   " ~4 w: n" A, I; X9 Q9 e* S7 C
3. */
   
4. public void reloadAllScripts()
   / g" L% S; K  v
5. {
   
6.     unloadAllScripts();
   
7.    
   $ _7 C9 ~; ?- V  h5 C- x
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   ) G; m! J1 q4 d6 w8 K* G  z
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    * A: {) {0 M7 |$ k
13.     catch (Exception e)
    + R# F5 y# a$ P& G' y1 k
14.     {
    / Y" ]% Y8 b, V: F+ E
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    ; @% P2 v! b" M' }5 x/ ~/ A
16.     }
    
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

2 ~% a0 `0 _: h5 x/ g" Y

1. /**
   
2. * Выгружает все квесты и скрипты.
   + G$ p% [- a9 n! H0 X0 Y
3. */
   
4. public void unloadAllScripts()
   5 x, C$ a1 V+ Q. N3 ?' U% ~3 K2 |
5. {
   ! ~" @* j3 @! f% b
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   $ q) G9 \9 m0 A9 i! K
8.     // Выгрузка квестов.
   4 }" F& s& o! x) P1 T5 z$ ~8 Q0 M
9.     for (Quest quest : _quests.values())
   ; W9 }  p/ {% C7 Y9 I
10.     {
    
11.         if (quest != null)
    - d% c6 h! V% [. o
12.         {
    2 m; W4 R( k8 \2 R$ A1 Z
13.             quest.unload(false);
      w/ |  e1 }3 P, O- ]3 A
14.         }
    
15.     }
    
16.     _quests.clear();
    8 R$ B8 B* y6 {. T! E  @
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    5 B% V( m+ r9 ?* Q  R
19.     {
    
20.         if (script != null)
    
21.         {
    $ D2 v+ |  i/ o5 Q6 c, x
22.             script.unload(false);
    / A3 E$ \$ L) U0 M9 b. B
23.         }
    
24.     }
    . ~) U" L9 x5 @; b: ?5 z
25.     _scripts.clear();
    
26. }

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

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

Метод report()

1 V3 ^1 L. q3 v9 Z$ L

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   7 M* z  ?2 I& @7 j8 G- K
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  8 v9 q7 U2 Q" q0 r2 \

Метод getQuest(String name)

  ^" |& F& U% @; @

1. /**
   3 u9 W' Y& W2 `6 V5 C( R
2. * Получает квест по имени.
   5 P0 K* d+ G. c* U9 O+ K; c
3. * @param name имя квеста
   2 \: _; ?2 K0 Z' s
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   7 j: A. K! \) }# I
8.     if (_quests.containsKey(name))
   $ p* D# {2 }1 z9 K/ @
9.     {
   . H# X/ N1 K; N/ b
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  " m. X# F$ X; u7 z7 }) t8 {  z

Метод getQuest(int questId)

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   * [3 q4 Z1 s. \& `
4. * @return квест, если найден, {@code null} в противном случае
   9 f) ]. W1 E* s- O! l
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    ( s- o5 y, S% ~6 Y4 F$ z$ N
13.         }
    . r) Z0 O  U2 ]$ I5 \( B9 i
14.     }
    
15.     return null;
    
16. }

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

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

Метод addQuest(Quest quest)

( z1 u- |( V* T. z5 G/ f

1. /**
     z; Q8 y& E' W% i9 B0 L" c3 o& }
2. * Добавляет новый квест.
   * w' X- s) ?- _  X$ i( @
3. * @param quest квест для добавления
   
4. */
   % o. K3 p' g) d& c4 K& u2 q; D
5. public void addQuest(Quest quest)
   : s  y; }9 G, w' Q5 f( A5 G0 q
6. {
   
7.     if (quest == null)
   % P! |/ g2 D6 n
8.     {
   1 n6 m: X0 T7 u, f! }0 @6 L
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   # r% ~; ?6 X. A0 n' j: W2 X
10.     }
    - m. E& [" m2 X4 U
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    2 }1 {& j* I5 B( Q# u
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    + l; G' `9 r. Z& v  _+ m
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    9 r: b  \: g4 L+ W
17.     }
    
18.    
    - K2 x! V6 l) N, I8 W
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();
    * O' I, z! q, c% x5 Y
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    # z& k7 ~  |" p* d1 F5 Q! {
25. ``

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

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

: J' v: k+ g$ M