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

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

1 k; [$ E0 q+ ]. t+ n: v/ sРазбор файла QuestManager.java

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

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    6 C( f3 T# m1 {9 [
• Импорты
  & l& {5 ^: e( A+ ~8 l

; |% x& C( G) z! f' E' BQuestManager.java — управление квестами и скриптами.
& K$ J. ?7 c7 ?/ R/ Y* H- Z6 cПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\


Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
- }5 C/ ^% x  D7 O8 E" P: `

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   7 U4 o$ g4 f+ y# X; _9 b
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   7 g" z5 @5 T9 \2 y; }8 D/ |
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    " w' r* Q4 G. h. G$ {
12. *
    # u% q* j0 X4 E! D0 }( X
13. * Вы должны были получить копию GNU General Public License
    0 |6 o* y( q3 p- h
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    - B3 b- U5 R' j- a2 Q
15. */

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

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


0 g+ G0 }+ ^3 f3 g" L2 u2. Импортируемые библиотеки
) t8 D; R; n: ?" ~, \0 V
! N# A7 i0 [* ]# d! T/ h, ^: I2 Z6 t# ~

1. package org.l2jmobius.gameserver.instancemanager;
   9 n4 |1 e) t# G: a# \, I
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   : ]; G/ \. A& n. n& J* e& O' b
6. import java.util.logging.Logger;
   
7. 
   : F$ y1 g$ a0 P$ ]1 c. y6 |
8. import org.l2jmobius.Config;
   8 b" Y" ~& ?( ?0 s3 @- Y
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    : Z  c  P# G" l
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 — менеджер для работы с игровыми скриптами.
8 W6 X0 Y% R6 R4 w1 J. z8 ]2 b, ^  s& H
5 ]! j- q3 A9 Y: B9 {+ [" X3 s3. Описание класса QuestManager
4 t7 @3 F, `: c% n( C

1. /**
   ' n0 ~2 \# u4 \5 _; R1 K7 o
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   6 d8 Q4 y) y8 n/ L
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   2 O6 \7 X8 X( v2 M
8.    
   
9.     /** Карта, содержащая все квесты. */
   ( o/ J  F* W; Z. F- X
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    2 e! S* F1 t* M% {
11.     /** Карта, содержащая все скрипты. */
    - @7 E! u) D+ F2 q/ U6 T6 m) [
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    7 L% c) i0 {3 M  Y$ Q/ i( P
13.    
    " l7 k- |) U) j! [$ ^: K
14.     protected QuestManager()
    
15.     {
    
16.     }
    
17. }

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

4. Методы
( ~" l# D( R( AМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   0 W7 N- u  p! q& A* T/ D
2. {
   . q4 E3 L$ w' v( Y( s
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
     D, C) e8 O5 b, G5 t
5.     {
   
6.         return false;
   
7.     }
   8 }5 O0 M5 x& ]3 l- l
8.     return q.reload();
   ; ]7 _1 J* k, x  G8 w
9. }

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

; g. A' W: A# _+ s9 l" \1 JМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
# j1 N! D9 D- }# p1 \/ b5 k

1. /**
   + W9 y; f6 l& h
2. * Перезагружает квест по ID.
   4 K4 W2 [# d, {2 X3 {1 J
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
     v1 F# N+ P% Z. ]' i
10.     {
    
11.         return false;
    ; G7 W# w. n& }7 D
12.     }
    
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  7 G  b1 \' X! W* o# R" s: A! X

Метод reloadAllScripts()
9 \- h) Y5 W5 ~. R1 y

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   3 e6 Z* r9 M' t- X
4. public void reloadAllScripts()
   ; h; H' B# ^) @$ I! o8 C
5. {
   
6.     unloadAllScripts();
   4 o8 f/ G. e0 e  _" G
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
     K0 v& _3 b' y
9.     try
   ( p9 e* g1 v1 Y. Y! I: G
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    0 H2 ~! f  W8 W! s: G2 q
12.     }
      v* M8 ~! F2 m9 A) a. w5 d
13.     catch (Exception e)
    
14.     {
    ! h0 n. U7 `8 K2 H  c# J/ e
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    1 \* _6 ]2 P( M) i7 d% V
16.     }
    " F0 W  n% f5 S5 w+ x' ?# U
17.    
    : O) u7 F' T" y0 R/ C4 l# M
18.     getInstance().report();
    7 M9 z  o: ?- s/ o3 W
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   1 J; g, x: E' c0 o$ X5 M" @
3. */
   
4. public void unloadAllScripts()
   
5. {
   3 ?4 |) K' Q( o6 ~" t
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    & @6 e+ h' e4 ?* a' L! e
12.         {
    ; Z/ `+ _/ `$ L! d2 S0 @
13.             quest.unload(false);
    ) P0 i4 Q7 l" S- c; p% q2 y
14.         }
    
15.     }
    
16.     _quests.clear();
    , r4 b8 C; N1 J& |6 F/ h
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    6 a/ q5 Y# {: @' N
23.         }
    5 l( a# q3 {; u5 C
24.     }
    
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  9 \0 H7 Q% T) v

( R0 U  P+ n# F, }! y. `Метод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   ) j5 o8 u! S) W+ m+ g6 C& r
3. */
   # v7 F2 `& x5 K& h8 I, T% m
4. public void report()
     ]) v" S1 I  H/ W9 k' }: ]. E0 m
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   ' o9 `- H/ }9 m. W3 P. `. {
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   / I5 n$ j$ D# E4 ^% \: F
8. }

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

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

Метод getQuest(String name)
: x( x& H6 O9 h

1. /**
   # a4 T8 S2 N$ `' |. v* D
2. * Получает квест по имени.
   ' B% B2 r& j: ?' D8 y1 @! z
3. * @param name имя квеста
   / o' M7 c7 k& T2 [* G2 X
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   $ w- g% y; @% Q; S
8.     if (_quests.containsKey(name))
   
9.     {
   % W/ c0 [, I* X) r7 e  T
10.         return _quests.get(name);
    3 a' W- j; s3 m" j) I
11.     }
    % h$ E* k. p3 Z% G/ |
12.     return _scripts.get(name);
    4 P# N3 G; w2 f8 m. N4 j; N; R; X
13. }

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

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

# g& }- D! v% o+ i8 J3 lМетод getQuest(int questId)
7 W) h8 f# K6 E/ U1 Y
8 Q9 H8 A9 }) s, R! M3 C; ^8 A- T

1. /**
   
2. * Получает квест по ID.
   7 V$ F* W8 _) n8 A! L' T# e
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   ; F+ f& M$ q0 }# m( k. k
5. */
   9 {( e7 }2 l  o& ^2 `4 q4 ?5 m
6. public Quest getQuest(int questId)
     j5 K2 A0 E- Z4 |4 t% ~* T
7. {
   & X( ^0 N8 q, L. @
8.     for (Quest q : _quests.values())
   0 V& E0 {0 L6 O
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    
13.         }
    + E% Y# g5 c& ]# A$ T
14.     }
    1 M9 D- m& R: k3 j* N6 a
15.     return null;
    ( H  t0 n+ x3 {8 z6 \; D
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  . N( B4 p: g" X, o1 G3 G/ Y  m

Метод addQuest(Quest quest)

2 }! I* d% J7 Z* ~

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   - y0 J. v' l: A
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   ' Z: X8 b: D; p) L. i6 a) O1 i
8.     {
   3 L0 t& E5 M' W5 A
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   & r" e2 m& {% s. s) x
10.     }
    
11.    
    7 f# n, q  W9 i; ~: g
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    * d5 k8 b% Q  U1 p4 Z( N  K/ i: M
14.     {
    
15.         old.unload();
    ' V6 P' V" F8 B  Q2 C7 W) j& A5 L
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    , ?. W: ~, t$ O% l
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    " \; P: h( g4 o6 n' L8 G6 N0 U
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    : C+ {1 Y" d% y# `
24. }
    * w! W8 C5 O5 y. R: S
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
4 T% O% e. g3 C! {ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
% D" i; v9 n: u' b: ~/ L