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

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

Разбор файла QuestManager.java
; t$ a0 }( x$ Z2 t
Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
- Q1 y8 c8 H* N9 e

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  1 S3 l* v5 ?. i) k

QuestManager.java — управление квестами и скриптами.
" q% c! x8 \) p1 kПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

6 l" P1 Q/ R) [7 T* k
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
  o0 I( c5 S) R$ E7 J1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   $ u" W% J) U4 K8 ~! F
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   ) f1 x6 e, \) _4 S/ C- h6 J
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   3 _0 y7 o1 S$ u* J6 T
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    - l4 n$ y7 t. ~0 J  w9 @
12. *
    7 w' s) g. W( ~  j5 w, V
13. * Вы должны были получить копию GNU General Public License
    7 H% Z4 i" K& E  ~  s% L$ c
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
" g! L  {2 B8 g: A; c( w5 m7 k3 ~
$ L$ ?5 m+ ~, x; H
2. Импортируемые библиотеки

1. package org.l2jmobius.gameserver.instancemanager;
   9 X+ F! K# ^' a2 i: J+ }2 Q: Y4 \
2. 
   + h7 \) B+ n* ?8 n
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   . G# d( p" b; _! }# Y! f4 B+ P
10. import org.l2jmobius.gameserver.model.quest.Quest;
    3 z* o" _# _) L( c* U
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. /**
   
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   , Q8 r- G- [% ~/ l( _9 r
4. */
   
5. public class QuestManager
   * d) w# ]/ |/ K2 h
6. {
   6 F: R. n; W- @& B" A
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   . X5 B& S+ l* s$ H
8.    
   9 o3 m  B- O; V' n, F# |7 Z% G! m
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    ) p8 i4 h" L# I# F( L0 }/ D
11.     /** Карта, содержащая все скрипты. */
    3 m+ j. E9 ]; m, Q
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    ' h( J7 l. s, f/ d
14.     protected QuestManager()
    % h, Q4 K9 t2 @: I* |2 }+ K
15.     {
    3 T3 W# A7 ~! F) n
16.     }
    3 `7 z5 [/ @2 W5 U$ V+ E: c
17. }

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

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

1. public boolean reload(String questFolder)
   # z' v. N$ h+ l8 r9 ~
2. {
   4 x; K% _- i) }! F/ o9 N$ N( p
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   : ]4 X) e: F; J8 M8 m+ f/ Y
5.     {
   
6.         return false;
   # P2 c4 b2 @7 H* y) w
7.     }
   , r1 F$ H, W4 f7 y' K6 n
8.     return q.reload();
   6 S" X+ k8 M5 |- j
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
: S0 Y3 a( y. fМетод reload(int questId)
; S5 o1 k8 |+ e
% W* j7 a. p. b$ h+ T

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   1 u  ]/ P9 |% Z3 e2 u6 o3 V
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   8 _( S& q8 ]+ S$ Y
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    ; u! g8 P: s$ q, V
11.         return false;
    
12.     }
    - d- I- _- M# }2 f9 P
13.     return q.reload();
    5 L5 X* i. x# J( E9 E$ H2 [
14. }

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

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

Метод reloadAllScripts()
+ P9 H# y$ A* [' Z! q" N: U
3 ]$ w- Y  F( R( u, w7 B% c6 A

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   ' Y/ u/ K' t! x& K' n/ H. }
4. public void reloadAllScripts()
   ! t; Q! g5 c* W" F1 J- ~+ \( L
5. {
   
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    ) \: x" o8 k$ a8 l5 X
12.     }
    
13.     catch (Exception e)
    # ~8 P9 X  c1 a
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    5 Q, j0 q/ \  F' t4 a
17.    
    
18.     getInstance().report();
    $ @0 s# b6 E9 o: i8 ]1 U
19. }

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

Метод unloadAllScripts()

- P; m0 [# p+ Q5 E2 n( i

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   4 S, e  @& E' j
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   , Y+ J% {9 }" ^2 D" M
8.     // Выгрузка квестов.
   * L  E4 s; d0 {, o2 H
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    
12.         {
    & v$ c- H0 C0 e7 K
13.             quest.unload(false);
    * x3 e- |+ e* u- _
14.         }
    4 R6 ], A4 ^: h& K8 p
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
      W: {" }' _7 d4 `& `2 C
21.         {
    
22.             script.unload(false);
    
23.         }
    4 j4 ]- g5 B/ O" m8 G5 h+ w
24.     }
    
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  9 _7 l# \% V! d& |) g: C0 r6 @0 Q

Метод report()
/ _$ u' c8 A; W) a& B9 a1 x

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   : Q2 L" x0 p9 V3 f- d7 t2 p
3. */
   
4. public void report()
   - [, h$ w8 `) e: w1 y, H
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

Метод getQuest(String name)

3 V1 `; t& Z$ G3 D. e

1. /**
   . P1 b6 f9 T# c# K5 w0 k1 D
2. * Получает квест по имени.
   
3. * @param name имя квеста
   " X0 y) M" M4 S4 A1 K
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   , y  {3 U9 P$ v
7. {
   6 q; L2 G: ~# P/ O7 ~
8.     if (_quests.containsKey(name))
   " n/ y, j. Y) E
9.     {
   
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

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

0 M9 q; p/ q0 s, }8 s" {2 @! hМетод getQuest(int questId)
! |- O2 ?& Y# T. y8 a5 y" a* G
, h7 ^+ U  y1 T

1. /**
   
2. * Получает квест по ID.
   - i/ M  h1 f  j1 w0 i" \
3. * @param questId ID квеста
   3 y/ {! d$ Y$ n7 `8 U, Q# h
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   / U5 y/ E* V: A
9.     {
   
10.         if (q.getId() == questId)
    ( a8 d* W" ^$ m5 K% }  R
11.         {
    
12.             return q;
    ! n1 K. r$ C' l# Y6 h
13.         }
    " a5 c8 G5 K+ E/ v/ s8 `: B3 m. T
14.     }
    . a; i( H& n1 Q9 @! b- G0 I
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  5 H7 [- @' R* j5 I0 B7 L2 O+ }9 V$ U

Метод addQuest(Quest quest)

; W, m. Y6 m& i# P* V

1. /**
   5 D2 z: }# s9 u9 ^% U
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   6 l9 O/ p. j* v9 r( R8 q
5. public void addQuest(Quest quest)
   & ]7 x  u, O9 Z
6. {
   ( F3 S$ @' V) }$ L, C+ \+ n
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    " Y1 J! `) z3 Q+ b) y
11.    
    4 R$ c3 J2 n' M) W! M
12.     final Quest old = _quests.put(quest.getName(), quest);
    0 f! z% j1 ~5 q# h5 `2 E/ S
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
      J3 n( s5 k* H; }2 ]7 I
17.     }
    3 _- l2 C% F* l7 m5 {  Q7 Z
18.    
    % r+ I1 A; T+ ^: Y) w% O
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    5 r( p& h, D5 o
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    3 }( S  W6 b  T: v$ {* i
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    / |: V; }5 P" R# S
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
- `( S3 K$ U5 L7 K+ z# T; t/ ^
1 v/ F9 ]4 n. F9 W6 \+ ?
( x' c3 ?: O, D) w) U