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

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

2 L& G" Z/ h& {5 |! K# V# j' DРазбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
    l' w/ q+ Y) a+ B& [4 Y% M3 O  @
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    3 S2 D9 n" p6 ~$ ]( v! i
• Импорты
  : J& F/ \; {; W4 v" d% X& g

QuestManager.java — управление квестами и скриптами.
1 s1 H2 K, S7 R- MПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

( Q: ]; Q6 A& D3 {: W
) l- W& ?0 h/ P  N' eДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   5 R! K7 l2 n) @% i
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   ' m7 j* p* [# @1 \) D+ ^( i
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   ) {# l& M5 U6 M
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   1 P6 K$ h) C" l# q7 c7 T
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   " ]/ _: \: s6 q
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    $ h2 a7 r5 a- O) r4 l" O
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
# F$ `( c  {5 P, G
/ Q& Z7 j$ C  {) o
9 r& F+ c% L8 n4 N9 \; \2 j2. Импортируемые библиотеки
! J# W# Q& v: F1 @1 e
5 O0 Z5 ~. [( Q7 Q0 [8 I

1. package org.l2jmobius.gameserver.instancemanager;
   . {, L3 ^6 v5 Q, K9 H+ Z# ^4 x
2. 
   8 j! ~# _8 A- ]7 t
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   5 p" t, `' i, ^3 |' x% d$ u
7. 
   ; p, j) N/ ?4 x& {
8. import org.l2jmobius.Config;
   . a+ f2 K! c/ E* p% i" f9 a9 a
9. import org.l2jmobius.commons.util.CommonUtil;
   7 `- K+ r" ~; z: k
10. import org.l2jmobius.gameserver.model.quest.Quest;
    + G) y' P1 @" b2 b: `
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
9 ^' u' Q8 D$ k" A0 J( F+ n7 C

1. /**
   3 ~; b/ ~$ w) b, c
2. * Менеджер квестов и скриптов.
   4 F* P3 p; t9 |8 Q
3. * Автор: Zoey76
   ) W3 s8 V, D& e( t0 X: Q
4. */
   
5. public class QuestManager
   ' @; I% X) }* `1 [% a- q3 b
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   9 Z% R1 q2 V# b* ~  M  z- c
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    ' p* H. `! N; M9 m3 ~4 j
11.     /** Карта, содержащая все скрипты. */
    9 I- G1 e9 z) ~$ x
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    + W/ m! p" F$ A7 Q% S
15.     {
    
16.     }
    # F8 |; y6 Y& q
17. }

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

4. Методы
2 d( |% l' U* z' k, N  ~( n' a) MМетод reload(String questFolder)
1 L( o! K' e3 H

1. public boolean reload(String questFolder)
   
2. {
   $ Z9 A3 ~; j& e& o/ A6 G
3.     final Quest q = getQuest(questFolder);
   9 ~, I7 a* T' X8 h, U- e
4.     if (q == null)
   2 B  x; b, a0 i+ U1 A- o' ?6 A/ T. X
5.     {
   & y+ G1 `$ j/ @9 O6 u  A# k! g1 _, X
6.         return false;
   ( Q1 h2 k! j# O" J) R
7.     }
   
8.     return q.reload();
   
9. }

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

6 [6 Z1 C$ P+ [  [7 @  iМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
% m7 `3 o6 U2 i+ I  V6 z# P0 r/ ZМетод reload(int questId)
4 D' X7 b; o, ?  O
( C$ Y) I" L. X2 b6 v5 x

1. /**
   
2. * Перезагружает квест по ID.
   * V# ~& w1 ?' p0 N* L
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   $ b2 D% h( T% X+ \7 T0 z6 @# ^) d
5. */
   ! Y+ `) E, S+ E! b, m
6. public boolean reload(int questId)
   9 f: T0 \- T# W' {! V# l
7. {
   7 n2 V% q' p5 B8 Q' U: ?
8.     final Quest q = getQuest(questId);
   * t! k0 H* a4 U+ f! A0 S
9.     if (q == null)
   ( \% b0 Q* t1 L0 k, K! B! V
10.     {
    
11.         return false;
    ' a, Q0 D0 Y  j
12.     }
    ! ]  Z9 b  K: f; C. G7 U
13.     return q.reload();
    ; |( \% a0 j/ m( Q8 a; |* r5 \, r/ J2 E
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  " d% g- U0 e! M# D

: F1 C3 i4 m9 U$ ^- TМетод reloadAllScripts()
, f: F- ?8 n7 @/ s3 z# O

1. /**
   , H- a2 I) {' ?& l$ P* j
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
     ]! K6 c( A, n8 H4 I" x
3. */
   
4. public void reloadAllScripts()
   ) n+ f; _) ^& D
5. {
   $ x* K9 q9 E  E- h2 u
6.     unloadAllScripts();
   9 ~" D" h+ a+ A" G
7.    
   3 o+ C3 o' r: k
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   7 U/ H. c0 ~  u1 @4 S
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    3 B+ G! V% h% H8 ~  F+ @4 M
13.     catch (Exception e)
    
14.     {
    9 L9 t4 V! z, K5 \; p% \
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    " a1 ], M- a# S
17.    
    % ?4 y9 S+ K# x9 _
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

* M$ w4 z9 b' a0 e

1. /**
   
2. * Выгружает все квесты и скрипты.
   ' m9 \& d0 f& `
3. */
   
4. public void unloadAllScripts()
   $ c, b! O6 p$ \: _
5. {
   + z* S4 z  z1 L1 D1 i& X  N; s( P
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   & X: z5 N8 _  T, }% l, u
7.    
   9 i, W& q# }0 O
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    4 M2 \; z% Y! R! {
12.         {
    
13.             quest.unload(false);
    . g* t7 ^3 @4 s$ B. S
14.         }
    
15.     }
    
16.     _quests.clear();
    3 x1 y3 @3 j$ |9 G% q) K. T* Y5 E
17.     // Выгрузка скриптов.
    ) e# Z1 ~# _+ c- a, W- T7 ?# {
18.     for (Quest script : _scripts.values())
    ( O# V4 [& R8 \$ z2 l
19.     {
    
20.         if (script != null)
    # ^2 W# _/ Z( h' L+ v0 z2 g2 s" T$ q
21.         {
    
22.             script.unload(false);
    6 Q$ s) i! z: N% q6 ~1 g/ H1 s
23.         }
    % ?. w5 ^& G  |% H% Q1 ?# ]
24.     }
    
25.     _scripts.clear();
    8 v6 F6 e7 W0 I
26. }

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

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

# M2 V1 L9 `# Z+ OМетод report()
( w3 V4 h- r/ [  X
5 {( l6 b2 Q) x# E. O% j

1. /**
   % a7 H& x9 ~3 i
2. * Логирует количество загруженных квестов и скриптов.
   7 s9 D2 l( m2 E& x. k  c  ?6 G
3. */
   0 Y/ I2 \+ I1 y. }/ d, v
4. public void report()
   
5. {
   : g+ ~% L( h' D# }$ M! P1 [( ^9 _
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   $ V: `; P  i& a1 W. z" R
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  

, N$ s6 H3 X2 m8 O1 j/ NМетод getQuest(String name)
" e( O+ b, z2 y+ R- H
$ w; o- A/ D7 y

1. /**
   ! D* [' L- d' Z* c- l# h5 [
2. * Получает квест по имени.
   0 k3 }9 m. h- c: X+ y$ J
3. * @param name имя квеста
   ; E$ Y# M  p  u6 E
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   6 T8 `: q3 D9 X4 h5 K3 r# Q
8.     if (_quests.containsKey(name))
   
9.     {
   " N* f' J% Q( _% s8 X6 Y# e2 r
10.         return _quests.get(name);
    
11.     }
    6 {. X7 N  _- m3 f3 T
12.     return _scripts.get(name);
    
13. }

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

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

Метод getQuest(int questId)

0 [# R) e' j) P0 c8 D6 K1 h

1. /**
   7 o+ D7 [# ^* d
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   / O! a8 m6 Q  z
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   6 ~, i3 X0 S3 I0 L
9.     {
   
10.         if (q.getId() == questId)
    ; ^; |( A) A6 j8 ~" [$ w$ `* n
11.         {
    
12.             return q;
    
13.         }
    ; l; W2 d2 F8 _% ~
14.     }
    
15.     return null;
    
16. }

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

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

Метод addQuest(Quest quest)

1. /**
   4 G4 ^) s- e4 U% `) U
2. * Добавляет новый квест.
   + p+ u4 l* Q$ ?# Z. i
3. * @param quest квест для добавления
   ; W) y1 e: [7 m2 S
4. */
   
5. public void addQuest(Quest quest)
   ) y. W" z) L" Z1 p5 a
6. {
   
7.     if (quest == null)
   
8.     {
   5 t" O# R* R4 }5 Z4 w1 ?
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    - I+ w/ A: Q/ E$ C
12.     final Quest old = _quests.put(quest.getName(), quest);
    0 f0 F3 I- o. Y) I  {* d
13.     if (old != null)
    3 ~8 Z* I8 {  P* I, O
14.     {
    ! x8 E' T  o4 }) G( |
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    / o5 M. V. K- V! a
18.    
    6 `. o4 |+ h* E9 `( B5 X; _6 n; h4 j
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    " Z* P$ b2 O( F* W) I2 a
20.     {
    ' @3 l* O7 V. h
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    + r2 c6 [9 j3 V$ i+ j/ W
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    ) B3 u5 }4 {& b4 ^' f) {
24. }
    ' J1 _& Q. i' M) X! \1 q
25. ``

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

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

% I- m9 r  q2 |0 \# r
. o7 r7 [8 O0 [# @
5 f3 r( @* X) b