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

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

Разбор файла QuestManager.java
" w: _: [( A. s7 w6 z9 w& j. `8 U' i
8 }$ j, P# a' l/ |8 `" k1 ?& ]Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
. O! m+ z% ~$ ]8 f! U5 L: ~Основные элементы

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

QuestManager.java — управление квестами и скриптами.
/ |) U1 B+ o6 d5 LПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\


Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
! [0 ?3 y" g! m4 a1 b9 Y  u! b1. Лицензионное соглашение
6 V0 Z2 W" y8 r4 p+ ~) b/ M

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   . y' t# Z; r( z# E- A2 A  G, c
3. *
   3 P7 S0 Z& L  d9 |4 ^! M* i) S
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   : u2 d; r! j# D: R8 h: O3 [1 X
5. * её в соответствии с условиями GNU General Public License, опубликованной
     C3 Y2 D" x% X+ o/ x- q
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   & D( o4 _9 t3 b; s
8. * Эта программа распространяется в надежде, что она будет полезной,
   + }; ~- c) @" |; [' u: W, q9 N
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   1 q7 u% W, l  @) M& I
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    ! S: y- \% {. @$ K* u  h1 c
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    , j- ]# e3 a9 d  q" D- N: }
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
% m1 H: _0 F. a" Z& G+ ^5 `
( Q  y9 K; ]! V5 |- S- b
' L3 Q! h2 q" d3 x, c3 {7 h2. Импортируемые библиотеки

# f+ l' I- ~: v. V4 D! G" J3 _+ Q

1. package org.l2jmobius.gameserver.instancemanager;
   $ |0 e& [/ ^" J
2. 
   + M& s# F" u8 U- o" W2 H% m
3. import java.util.Map;
   & U5 k* b1 ?: t4 x
4. import java.util.concurrent.ConcurrentHashMap;
   3 e( s: R4 v5 K; @  ~
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   - D8 i# Q) y" u' p
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 — менеджер для работы с игровыми скриптами.
: z1 O- R6 K' L, Z
3. Описание класса QuestManager

1. /**
   : y8 h( L) J- B' e* m
2. * Менеджер квестов и скриптов.
   3 N$ @7 ~! |+ E" Y; I+ c
3. * Автор: Zoey76
   + S7 A: M: b0 e. i  q
4. */
   / e; m, p- }% B+ M' p* v1 g2 A
5. public class QuestManager
   
6. {
   $ _" }# P9 N  Y/ w6 g& R9 d
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   - _! e0 W  _1 X5 `' H* N% U2 N4 Q
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    4 e' F2 ]2 b# F2 Y7 E9 k, A$ R
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    " Z4 }* ]5 A4 Y7 h, |
13.    
    5 _* p( @: k) A' p) `
14.     protected QuestManager()
    4 M; \6 |9 z5 [  g( P; P0 |+ ~& N
15.     {
    9 p% f+ Q2 A4 I7 O
16.     }
    ; z+ r- a. a! H. \0 Z2 b
17. }

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

4. Методы
Метод reload(String questFolder)
' ~6 Z1 J7 C' p9 g

1. public boolean reload(String questFolder)
   1 X$ {* x, L7 ~; _
2. {
   . I% n4 W- W; [% F! i
3.     final Quest q = getQuest(questFolder);
   ! V* D9 r; |4 e8 s5 A
4.     if (q == null)
   
5.     {
   
6.         return false;
   + y4 D% z4 c' w7 q) V) E& O
7.     }
   
8.     return q.reload();
   
9. }

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

0 J5 ?0 d4 B* b$ l( R7 v( YМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
7 i% L: z7 @8 u; P' lМетод reload(int questId)
% T4 _8 E) A% e4 `5 T$ Z5 O0 B' D" |  O

1. /**
   % y: s2 M  F  d! N% x
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   $ J1 {  i/ f, [  A1 ^: M# A
5. */
   * L; Q" Z& d! C. S8 F' T/ e
6. public boolean reload(int questId)
   ! d4 O. L) f# g0 n* u
7. {
   ( ~/ U6 v+ D! s) g# h7 ~4 w8 R
8.     final Quest q = getQuest(questId);
   , K; a- F0 q! _& i
9.     if (q == null)
   
10.     {
    - a4 V5 K, n' `% I" u
11.         return false;
    
12.     }
    ( {4 I  i  C) g% @$ U) v
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  ) x% B# w( I( }

  x$ }/ E8 f' w( _Метод reloadAllScripts()
, Y' v, n' n5 Y+ |" E: k; O

1. /**
   * W# z. f" x7 Z- K' j
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   * g; e1 e6 g8 n' a3 z8 {
4. public void reloadAllScripts()
   & {, R0 W, N: P9 A; g
5. {
   # R) K' S% r% H6 s- L: G! V: U
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    % A( e5 H* Q3 B8 J5 W2 q
12.     }
    , ~% F- F1 {  R* i8 r; s1 R
13.     catch (Exception e)
    $ G; h% ?' a& B) J" s7 y, K
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    # C8 e; X% L: M
16.     }
    
17.    
    & w; V" K/ X1 Z, U! |
18.     getInstance().report();
    . ], T* T; J- [& ?9 k
19. }

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

Метод unloadAllScripts()

4 i& A0 K. N3 x2 _

1. /**
   3 D9 L9 N: n, }
2. * Выгружает все квесты и скрипты.
   4 D4 D2 z, Y5 e
3. */
   
4. public void unloadAllScripts()
   5 u0 q4 ~5 `, x0 b5 b1 r
5. {
   : x3 C* W( w2 Q: R. K
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   % V' o( C" H6 y. r, h# C
7.    
   4 E! G4 b! M3 X
8.     // Выгрузка квестов.
   ; @' a' [1 z. _
9.     for (Quest quest : _quests.values())
   4 @# a: x0 q; T/ K8 ?' T
10.     {
    - H+ Y/ d( A4 \, D9 K/ R  O% {0 G, O
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    $ M2 H/ G& U1 n5 S
14.         }
    " e; ?, P( P+ B" O% R( ?$ R$ z
15.     }
    - Z1 G& Y7 L9 a( w
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    ( P8 s* F( \9 @) r
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    3 |/ N6 S. ?! f* y$ E0 n
23.         }
    
24.     }
    
25.     _scripts.clear();
    * g0 Q7 ^) g+ ^# A9 b
26. }

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

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

Метод report()
' T( c' L/ \9 K. T  E3 j, b* R& A
6 k3 z$ a( b1 V/ u- {

1. /**
   , l2 y  M/ P( q4 x5 L: C1 u, n# B  e
2. * Логирует количество загруженных квестов и скриптов.
   * z+ @8 _- R, I
3. */
   5 Y/ X" M& ~, x! x" {, {
4. public void report()
   5 F7 `' C% d6 V
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   , p. X1 F6 w$ o6 x
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  ; k+ A( A  i7 e- b& t; ~

8 ]" q; X+ u" n0 r, Z6 |Метод getQuest(String name)
# @# M0 C/ ]  a4 i# t: f1 ?( h. v$ \  p
( x! v# p( S2 s  R* n3 D

1. /**
   
2. * Получает квест по имени.
   " I/ |; q4 H( g- |
3. * @param name имя квеста
   6 n! H3 I" A/ [4 k( A$ H" h; o
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   8 n! e6 p+ J* V* ], }
9.     {
   
10.         return _quests.get(name);
    
11.     }
      j8 I0 {+ F' |6 o/ K" F* P# i0 k, J
12.     return _scripts.get(name);
    
13. }

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

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

Метод getQuest(int questId)
  i8 T% f( ^7 c0 D" }6 Z: A- a# i

1. /**
   9 a/ t8 s; g0 s' ?' r- X+ Y
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   9 _9 [: a' M* H7 t; R1 e0 |
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   # B1 M; d0 K$ b: X3 j) s
6. public Quest getQuest(int questId)
   ! n  `8 f2 a0 o) Y* K2 I) j. J! w  N
7. {
   - k2 t* @" ^8 c! ~$ S2 s. c
8.     for (Quest q : _quests.values())
   ( L- L) @- [2 L. ]0 K
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    8 j, t. E) \8 ^9 @' X4 G
12.             return q;
    
13.         }
    
14.     }
    3 x0 R/ f( O5 T% D$ }1 F$ }( X
15.     return null;
    & d) x" X' ?1 Z
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  ' R& f/ B# a4 ]% N, @

Метод addQuest(Quest quest)
) h0 x) W1 `' z; }

1. /**
   , a; y( o& o" J+ U# E, D) I( o
2. * Добавляет новый квест.
   1 ?9 x* _' L% V4 j7 ^/ l5 ^2 `
3. * @param quest квест для добавления
   / [( b9 i  J- n: P( ^+ [
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   5 c- E- k/ B3 L* u
7.     if (quest == null)
   " }7 X# y( y6 O& [! H' P
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   $ L% R4 ?6 q! ^& c$ o0 n
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    # k4 e4 w& _8 @! W
14.     {
    , V4 _( J$ i4 y
15.         old.unload();
    , l2 J$ n6 \% Y8 }) n* }
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    1 v9 i" S: ~; F8 x
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();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
; L7 C  l) t+ E) f' e: ^
' s# M+ h- H9 a) G6 ^  J
' _1 {- T' Y! Y+ Z