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

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

8 d2 p  ^- V/ cРазбор файла QuestManager.java

* i- U+ t; D/ D% [0 i- EЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
4 P0 q+ a: u. u1 ~  sОсновные элементы
# j& c# {+ _* l/ V$ G% W

• Лицензия
  4 j8 O8 o1 ^; d) s% `: j
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    + l: {8 [8 A! x6 [* C
• Импорты
  

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


Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
6 d+ x7 p5 o  h4 J" ~/ N1. Лицензионное соглашение

1. /*
   ' U! m1 i) g9 B$ a+ \) I
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   6 F- g  [, g, N4 v
7. *
   , d6 U. \  {$ H* k
8. * Эта программа распространяется в надежде, что она будет полезной,
   - z. n' J, K4 x; O( t/ L5 _
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    4 |0 x1 i: g) `. Z2 M& }% P2 \
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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

1 L# o6 ^: a+ L  x! Q; M
2. Импортируемые библиотеки
- S/ ?! u. f2 v& L4 p
# O, ^, i! k. B

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   2 w0 l6 f% T# K4 T1 A2 P: y
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   8 s7 B. ^% h4 a4 ?
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   % p3 \2 z: W7 p
7. 
   ' c! F0 o' ?: D" w6 T  K0 h
8. import org.l2jmobius.Config;
   2 J4 U/ V) F5 X( @$ G+ t0 n
9. import org.l2jmobius.commons.util.CommonUtil;
   6 \, m! j  _3 g( h8 \3 t. A
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 — менеджер для работы с игровыми скриптами.
2 _, \6 X5 V2 K
6 W' P! p% S* t1 Y% {  q4 D7 e3. Описание класса QuestManager

1. /**
   
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   ) V' j# h3 Y0 ]; A) _/ R9 d6 _; K$ w
5. public class QuestManager
   
6. {
   0 w, F2 G) J- d4 z# ?
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   4 p3 U. {1 X1 J. t
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    0 A  N/ x. k6 ^! }) j
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    : e8 {; T; E/ k# G. v8 D
13.    
    
14.     protected QuestManager()
    
15.     {
      z, F; d- g+ I7 H
16.     }
    
17. }

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

4. Методы
/ E( M7 m( p" R; _Метод reload(String questFolder)

1. public boolean reload(String questFolder)
   # {$ {3 K# a5 h( D) I7 G' n  u7 d. `
2. {
   ) u: B+ }1 N0 p: l( a3 O* O
3.     final Quest q = getQuest(questFolder);
   5 I5 [4 M8 F8 U4 W) ^; [3 e9 A. ^
4.     if (q == null)
   5 X/ G7 ^& O& H! S- F, w
5.     {
   
6.         return false;
   
7.     }
   
8.     return q.reload();
   
9. }

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

) y! {& R1 P% m( h/ J% J) P
$ H% P- l6 F8 j( EМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
2 }- d  f$ n0 `& W! c5 xМетод reload(int questId)

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   : G7 X- l% k$ ~6 Q
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   5 Z4 N  T" K$ l* U% \
9.     if (q == null)
   4 A% l/ J! l  s( L6 R
10.     {
    + M6 J( t: M, T5 a" j& a2 N1 l9 N
11.         return false;
    
12.     }
    
13.     return q.reload();
    0 q7 C7 Y! R. O5 |$ Q0 C
14. }

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

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

Метод reloadAllScripts()
" Q& t/ P2 H. p6 B

1. /**
   " \  E( @: a% E& O: ?; a
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   4 @8 ~! C' [0 g7 D. \
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   ( b% w# i, x/ O9 _8 X( ~
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   9 V$ |7 o# k) f
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    0 u  F5 l- V" ]/ K$ D0 x5 ~7 `
12.     }
    
13.     catch (Exception e)
    
14.     {
    - B, C: Q/ Q8 E. u
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()
3 }9 s% ]$ e8 y# G9 ]

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   
5. {
   " i+ ?$ R: X8 I7 q7 e
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   7 h+ [! ^  f& W4 [6 O4 y6 ]) B/ @2 ?( D
8.     // Выгрузка квестов.
   2 a" K& X$ L4 D
9.     for (Quest quest : _quests.values())
   * }, U5 w- U" B
10.     {
    1 V0 w5 \# {# X& \- {- p" |( K- x' o
11.         if (quest != null)
    & X$ R0 `# C: W- B1 |
12.         {
    ' h2 @6 ^# q( c' Q" W. V
13.             quest.unload(false);
    $ T: [! I9 b$ h3 x5 j
14.         }
    
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
      a: c8 a3 D( N1 Y* u
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    3 J4 P' P4 r. F" x8 B
23.         }
    5 u& u# n, W1 ~3 S/ i0 ^2 r% }
24.     }
    
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  # W' ]% M" ~( N. E: A

/ G& ^% A. ^& N0 g! i9 u' i4 S  x; nМетод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   . C' r0 C. I0 j6 B- c* r, r
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   . ?# N3 K$ a, X" g
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   9 u7 E/ ?& f9 B4 t% a  l
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  8 }# H5 u" J6 P* e& _. c' I

Метод getQuest(String name)
- D( v/ I, N( F7 b1 ^

1. /**
   / ]$ z2 K/ b' q, m6 H
2. * Получает квест по имени.
   : z) [' [; @' W9 r6 p
3. * @param name имя квеста
   , H2 P0 c" r4 q  K, R( v) R  Z
4. * @return квест
   2 T0 d& ]: C* u0 s, E2 ^  I: }
5. */
     O! h; g! E$ Q8 @7 I
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   ( ]  D% o8 i  q/ \% c6 y
10.         return _quests.get(name);
    ' N; f5 W  v) k; R) j# i; A
11.     }
    
12.     return _scripts.get(name);
    7 `( W( y- Z+ k- G# [8 l
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  5 \& }. c# x/ O; A1 n+ L  a

0 y) M% R. P8 O1 r. d9 H8 a" M1 {Метод getQuest(int questId)

9 x* o. m* F2 }& o* H

1. /**
   
2. * Получает квест по ID.
   % o+ P3 O8 z" t6 }7 Q1 v& @0 B
3. * @param questId ID квеста
   7 u, ~# [* q; L2 t; t2 g
4. * @return квест, если найден, {@code null} в противном случае
   . ?5 K' t; z# q# x5 ~5 Y
5. */
   , D3 g" A; V: d! x
6. public Quest getQuest(int questId)
   $ w. N$ {: n2 L' Y
7. {
   
8.     for (Quest q : _quests.values())
   . ?, [' z; H% @/ p. [1 M5 |* O
9.     {
   ' I/ }  T% P3 c7 \
10.         if (q.getId() == questId)
    : P' X' x; L! Q9 I+ v
11.         {
    ; b3 e' M0 R/ c2 w5 ?' B4 J
12.             return q;
    
13.         }
    9 |7 v+ x. ]; S& [' B
14.     }
    ' H* W: W3 l3 k  z8 h
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  8 `$ ^4 ~+ h/ E2 i, P. n

, B$ u, C# R+ Y" L( D% e2 NМетод addQuest(Quest quest)
* R9 `0 B. o5 B  z. X2 Q

1. /**
   5 N3 s8 _( z$ h. X7 I
2. * Добавляет новый квест.
   7 O. c. k' k% o" ]/ V4 }& U( n7 @
3. * @param quest квест для добавления
   2 C7 q+ S# w: w1 c; h- o+ m1 Q, h
4. */
   ! @& h/ n5 Y% f' k3 ~1 z. g
5. public void addQuest(Quest quest)
   8 u- Y7 W3 F) F& k
6. {
   - A/ a4 B$ V( n; ]3 z% c' \# [1 p
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    5 I( O4 r+ o" b; \
12.     final Quest old = _quests.put(quest.getName(), quest);
    & w: [# y( I2 r( l' e, \
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    ; ^1 a# `3 q) e) q; d  v
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    - ^2 }: e% [4 X
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, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
4 ]! k) d! M% iЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.


/ _0 I9 c9 e1 W4 p
% [6 L" S# A; F. E