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

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

Разбор файла QuestManager.java
7 w* o3 l' E1 U. D5 v
Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

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

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

% I/ s6 f: ^1 c' Z0 x
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
/ h( Y! h! B/ p% O: X$ W9 D) C1. Лицензионное соглашение
: d! h( f( n4 ?6 b, f3 I0 C

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   $ ]1 w9 F, E0 c1 @/ M, A; q
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   2 g% ^# I* L+ ?! f# E
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   . I6 E, k2 P/ V3 V/ z$ S
7. *
   & g9 Z# d& W8 K' T! w, R7 D
8. * Эта программа распространяется в надежде, что она будет полезной,
   + ~* D3 u) P: f) q% L, u! x  U
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   4 q; I" p# b, N  S& U6 Z
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    2 U& B8 _4 X& _, |  M
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    0 m4 K6 ^9 x- P- `$ K. A; T
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
; [' P+ y5 x$ D- h* u7 e

2. Импортируемые библиотеки
8 @/ M5 S6 a; s' e
+ j8 x; s( T6 B! h. `

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   & ^2 X. T0 m# L. _! j
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   0 U! v+ v/ V& [, z( H
7. 
   ) k" q4 G% Q2 g# k) \, J0 h  o. {, `
8. import org.l2jmobius.Config;
   5 F0 B5 u  R) n# v$ a) h
9. import org.l2jmobius.commons.util.CommonUtil;
   1 y: x2 D! p* M$ H2 c5 ~
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 b" r4 v1 o5 T; }/ [) n( s9 c
0 F1 N5 ]4 P, i) Q+ N! E3. Описание класса QuestManager
! W, A1 }9 n2 d+ L# P' y: b" ^

1. /**
   % M& R2 |" [9 x2 X* w* q3 u/ R
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   . `  U; ~7 @1 Y% r" Z; _* U
4. */
   
5. public class QuestManager
   3 V' @' s; A' R3 K5 }
6. {
   5 U  V2 @4 x6 s: G3 E9 T
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   # F% |( q- g- j6 U# X; o' ^
8.    
   
9.     /** Карта, содержащая все квесты. */
   - W8 M. f2 Q1 N- o( V4 p( `8 k
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    
15.     {
    $ `& d* U& a# Q, ~# i# Q0 z8 U/ ]
16.     }
    
17. }

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

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

1. public boolean reload(String questFolder)
   
2. {
   0 K* g4 n5 `& m9 r- n& R
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   $ b1 m: @6 [4 \, k$ }7 E
5.     {
   6 j& v1 d) h- _- C8 a7 q
6.         return false;
   , a6 k6 D( h4 o
7.     }
   
8.     return q.reload();
   , G+ F, v! u! _! ~7 d" }
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
$ O! V$ X9 H4 p7 E$ d4 S2 s

1. /**
   7 P% o. P0 P9 T1 K
2. * Перезагружает квест по ID.
   4 d( ~- u) f( f
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   ' b, p: e: z7 r3 _( o
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    
11.         return false;
    7 v# x/ j, l: z9 C  ^8 }
12.     }
    
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  7 t, J# G3 F9 Y7 y  f+ _5 |9 D

Метод reloadAllScripts()
, t$ i, t8 T% n- v5 `: t9 a$ Q' t. C8 r
; k6 N5 y$ J/ u# L

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   8 y. D0 j3 k3 r3 i
5. {
     U& W( O9 E# ^: `; Z
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    ( V) R. P3 Y7 [$ A0 i2 R; J5 n1 ^1 ^. c
12.     }
    ) {- Q$ t  s  B0 m
13.     catch (Exception e)
    . }( Q' l% D- l. V& e
14.     {
    % _7 z2 D. ?7 @7 t; l! Q/ t
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    ' o. @! q% j" g9 C8 o' A
16.     }
    
17.    
    " t# n0 ]8 [- o. |/ J$ x. \
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   & ~2 b" j0 j3 ~" K
3. */
   
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    0 {( L3 }, c/ ]/ Q! v; k
14.         }
    5 n- m# Z) p1 j
15.     }
    8 N. f7 R: p+ Z1 L. b
16.     _quests.clear();
    3 _& G, d& [3 Y, t+ ]
17.     // Выгрузка скриптов.
    . x$ w- X9 O  @3 {
18.     for (Quest script : _scripts.values())
    ( [/ g7 ]4 `" R8 T
19.     {
    2 R4 Z5 v8 R" w& a! |4 m7 q
20.         if (script != null)
    : a3 y9 I+ T3 i% E# A
21.         {
    
22.             script.unload(false);
    6 G( q! |  C( ]' _5 ~
23.         }
    1 T* g# P; t% t$ ?5 i) |: L6 n! v
24.     }
    
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  8 B4 T. u1 e5 b! `# y4 @! i

0 N3 K3 ^9 a1 w( B3 S' C5 [Метод report()

1. /**
   4 e: W- j' _2 B# L9 w/ f
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   
5. {
   8 w  N; ]5 W, y# q5 t1 ^
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  * Z5 O2 S# }% o# Q' Q( k

7 j6 d; e- i' y1 A" U# G4 mМетод getQuest(String name)

. z$ O( A+ I# @1 V$ p: Y

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   ; }2 ?( s9 {& ?, ~  D( J  M+ l( O0 K
4. * @return квест
   0 M" d* N/ M2 G2 c# X( @7 w0 v+ I
5. */
   
6. public Quest getQuest(String name)
   
7. {
   1 m2 Q% @. t  t* o6 M, I8 H
8.     if (_quests.containsKey(name))
   
9.     {
   ( Q4 B' w/ W, S* s& d
10.         return _quests.get(name);
    ) B$ v  m* y/ i/ n
11.     }
    
12.     return _scripts.get(name);
    / T+ r% c! K9 O; ?
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  6 L* K/ j& |  M( T! h

Метод getQuest(int questId)
- g6 t4 W, }% h; n3 a/ v$ Q2 A
# y/ ?# n4 m  |! s6 n8 w

1. /**
   
2. * Получает квест по ID.
   ; q0 D$ b- H  O6 F9 Y
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   6 I& K2 G7 y" e" b0 c+ Q3 A
5. */
   1 n* l! O1 l+ j" r8 X4 `
6. public Quest getQuest(int questId)
   
7. {
   0 j. ~5 f) N" z4 [; @4 C6 @; @
8.     for (Quest q : _quests.values())
   7 f% O8 ]# r  ~, H) N
9.     {
   8 Q! G+ b8 m% _- D) ^3 I2 ~
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    
13.         }
    ! U. E3 b1 Z  M7 D
14.     }
    
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  & c5 a  Y/ c& o4 ^( b

Метод addQuest(Quest quest)
" w: ?, D+ V2 Z+ i2 X! ?( u
6 i3 E: [; B0 Z0 c+ Y

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   % A2 j3 u! i/ }: v
4. */
   8 G+ V; A% F  N* l( G
5. public void addQuest(Quest quest)
   
6. {
   1 r" P* k# F  R+ i
7.     if (quest == null)
   
8.     {
   ) U* m: y: p( F8 n" I7 T* @; I
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    9 B0 M$ x, P% Y6 i( d
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    3 }# n$ B: t1 {. y4 y+ C# D
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    & ~0 Q* U$ V& K$ o
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    . z# R: u1 _0 Z
20.     {
    ; T6 u5 b) s' J/ |0 I
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 — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.

' g1 L7 E/ R4 t' ]$ Y1 I% U