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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
' ?$ ]4 y0 m0 F$ F5 v; W5 j9 I
Разбор файла QuestManager.java

2 _* _5 l8 a' G; W8 n5 T# _' P3 uЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  : G+ K4 @) C9 k% e3 q% A
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    . n, Y; ?5 z& Q% Z
• Импорты
  8 O% L! t1 a" h6 ]9 {1 x) q

1 T) O8 u) [% N- B. Y' k7 t' TQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\


9 M4 g) p9 W& I6 `. k8 fДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
% N( J+ e  U2 Z5 A5 m

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   2 |! n; j* [/ t3 B* {& P- D0 c
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   8 V$ ^4 h6 x# V) k, K. Z% Q+ ?
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   ! }) C! u. E1 p; u- e
8. * Эта программа распространяется в надежде, что она будет полезной,
   2 o' }/ H$ A& n  U1 I! ~! p
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   " w; \0 A5 w& D! B+ N3 g; x6 [; j* D
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    9 ^+ q, }) }" T9 d) H( s7 g0 X  X+ e
11. * См. GNU General Public License для получения более подробной информации.
    9 I5 v+ E& ?3 N
12. *
    6 s. E! d% @/ [+ a
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    3 z4 M6 G2 H! F
15. */

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

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


2. Импортируемые библиотеки
' d% g* B! R# s
) m: |2 [" `2 |# k

1. package org.l2jmobius.gameserver.instancemanager;
   - w5 Q3 o7 R6 Y' Z! W4 {2 z
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   ; ^0 x' t# D: l# t9 e* R8 K3 A
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   3 C! o4 Y+ a1 Q  X3 z9 h
7. 
   
8. import org.l2jmobius.Config;
   / i& \$ S1 ]. p9 o7 E# p$ T
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 — менеджер для работы с игровыми скриптами.

3. Описание класса QuestManager

1. /**
   5 e. Z8 v, F' R7 i) ?6 U( [
2. * Менеджер квестов и скриптов.
   3 M6 R1 z% x- c# q* F5 `+ ]
3. * Автор: Zoey76
   ) H# h7 I% `% W, v3 @
4. */
   , o8 k9 U+ h5 L; O  m
5. public class QuestManager
   & z; w  i' K! e$ W' }
6. {
   % |. m# `1 }, F
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    6 H9 O- G* w! Y8 [
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    - P) Z+ B1 z6 H; \! x5 V* [
14.     protected QuestManager()
    * N$ R7 K; X$ U6 s5 `
15.     {
    , C1 p$ i0 F; C1 ?) K" b
16.     }
    ' d) z+ L" A' ]
17. }

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

4. Методы
/ V- J  a& Z' u  kМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   
2. {
   : H6 O: a' s$ x6 n1 [. Y
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   ! A' Y' v/ {  U1 H. R% A" v+ b$ J
5.     {
   9 v; K  t% B: }: T) o
6.         return false;
   - F/ a2 k& q! C3 ^! H3 m. t$ I
7.     }
   
8.     return q.reload();
   
9. }

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

/ K. |3 U: e7 w& u! X1 K
: P5 W# I0 n  {7 m' a0 DМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
# P, c; E; Y0 W) ]8 w! S9 ~. |

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   2 p# a6 ~3 o9 _  E1 Y
6. public boolean reload(int questId)
   - n/ y% g  p* S6 T  K. Y# H
7. {
   " C2 }1 f& s  K- i  i6 u5 k
8.     final Quest q = getQuest(questId);
   # H" ~7 y  M2 s
9.     if (q == null)
   
10.     {
    ' M/ y/ r! o8 a3 |' ?
11.         return false;
    2 z. b! c5 o" I& Z; G0 `1 Q
12.     }
    
13.     return q.reload();
    
14. }

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

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

" Y: f% K8 t2 Y7 r% G: Z! c: XМетод reloadAllScripts()

1 H! a, e7 X/ g- B# f4 V

1. /**
   ; J9 B& v5 t4 y" h0 q4 I
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   
5. {
   ) T6 ^7 Z* t! l& k8 v; e
6.     unloadAllScripts();
   
7.    
   1 ^* x. r- T- v* e9 i* O
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   0 V1 P3 c9 i+ Y% N3 O, Y! @
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    - p' r6 X# p+ w- S# r9 E
13.     catch (Exception e)
    1 P, x) J. }% \
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    ( @3 C# n, F" s1 m
16.     }
    
17.    
    - z# Y  @% b- O" E; p
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   
5. {
   : X, c- l- T3 N% f. j( C5 J( ~; k
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   . f5 Y1 h! Q5 X" l
8.     // Выгрузка квестов.
   # l" c% F' B: R. r. [
9.     for (Quest quest : _quests.values())
   
10.     {
    5 B$ r7 m0 F* U; M0 m
11.         if (quest != null)
    " P* O; h0 z8 ~5 N
12.         {
    
13.             quest.unload(false);
    6 u5 z7 [3 S( C6 F( B9 P
14.         }
    9 f$ r8 o8 k$ K6 c
15.     }
    & v% k8 O  c  m1 O
16.     _quests.clear();
    5 o2 i7 J/ E# e3 L
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    6 ]8 I, a0 Q# A! Z6 C, T
19.     {
    & v: B$ [: E. ?' W5 o7 O6 [+ i
20.         if (script != null)
    4 O2 D5 Q* W/ ^7 g# e5 ^) K/ y5 ^/ o" J
21.         {
    
22.             script.unload(false);
    
23.         }
    
24.     }
    0 F5 e8 l- f9 H2 v2 P3 u: a7 F
25.     _scripts.clear();
    , B0 ^4 ]" x9 |
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  + X. M7 X2 r# B+ S; ~

Метод report()

3 q2 ]- E' G4 z+ k& L& o; i

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   9 ^8 D' q5 g1 H9 g& d3 b$ E3 t3 ]
3. */
   1 i8 Y/ p2 M% N, T7 R8 v1 |" d
4. public void report()
   / J8 w/ I$ V7 Y5 W! W$ u
5. {
   5 F* I  j. [; V
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   ; A( Q0 G+ X) C3 [; F
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   2 ~0 l/ Q: }  a9 i; n* W) @
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  ; i  {" l0 ?2 K3 l, c1 t# \

Метод getQuest(String name)
, w; `. R! V. G4 P" P$ E$ z: ?% f
7 @% [  {4 ^' n* u

1. /**
   9 A& Y( T( a9 b5 b4 ^7 l) x- L' W
2. * Получает квест по имени.
   ' t$ s; T" H/ S; Y" l
3. * @param name имя квеста
   
4. * @return квест
   4 I/ m  ^! K" Y' V
5. */
   ' H8 P! A4 ^4 m: C- z
6. public Quest getQuest(String name)
   ! M6 B2 D6 x* J6 Q
7. {
   % t* E0 F8 x3 l- Y2 d1 j, W) H% X
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    
11.     }
    % Y: i' h; n/ p" `, o- T4 v
12.     return _scripts.get(name);
    ) h- ^6 W, N5 E& B' I6 |
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  7 Q$ n3 P& {) Y' b6 K

6 v# G, X; ~- `5 ~0 T! E& wМетод getQuest(int questId)

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   1 X" O4 _3 H7 M: w* O
4. * @return квест, если найден, {@code null} в противном случае
   / _# f8 L# m0 f( [3 Z5 @
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    . ~$ r% y2 N7 K% Y, T# L. j) O$ ?/ S
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    $ G1 h1 o3 V6 d! ?) ~& \
15.     return null;
    ) I6 _* q7 |% U
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  3 q5 s( ?3 A; ~+ l. }3 x, A

Метод addQuest(Quest quest)
! P7 z  M1 J- ^& x% a, L* R* \0 X# ]

1. /**
   , |( R0 @# i4 S- I; C' q0 {- C
2. * Добавляет новый квест.
   8 J- r, K5 V) o, T
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   - S; r" x4 B: y: B7 S
6. {
   ) x7 s+ W( [$ L! G' k/ `! `
7.     if (quest == null)
   9 m* R, ~% `8 D" ^
8.     {
   7 h: F) ?* w/ I$ ~6 ]# y
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    5 o; Q+ F, {8 a+ |( u- A/ k
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    ' P6 D% K8 N3 d4 G8 K- Y' p8 g
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    & A) @+ V, G2 }* f6 W. I
18.    
    ( r2 m7 N) ~/ R) N% I! W
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    4 D- n* H: p" j9 `
20.     {
    ) @( N8 n& G4 R) S
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    ) R" o/ _( T/ C+ N' D5 B. u) @% J
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    # v( X$ H3 m9 j0 c9 c5 \: J. h
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
+ {% Y% b- T% [+ M- s1 ~2 J: @ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
5 [3 j! G6 B) B$ |% H6 x6 }, Y
. {( y! N! X2 Q  \4 A
* |( B, U( w' \  i0 _# D5 @
: C6 n: Q. r/ {( K0 w) E