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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
' M% G9 h7 D7 r$ T- n. R
Разбор файла QuestManager.java

9 q4 }/ l7 k- N  _+ d6 v* fЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
/ j/ V4 i7 K; U( PОсновные элементы
) [& ^  z" ?$ A# L7 _; D" }# q

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    2 h/ b9 ]& D' Z8 A6 D
• Импорты
  

5 ~  j" R$ D( V+ s! W  g! u3 sQuestManager.java — управление квестами и скриптами.
* \$ g6 F  y# e1 ?" w( L6 `Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

8 Y4 |+ t$ t8 {3 a5 t  v
: M5 M. Q$ L+ Z" Z5 f2 KДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
! }1 {' q% Y1 w* s1. Лицензионное соглашение

1. /*
   0 n2 p- Q2 w& C. V5 j% t$ c
2. * Этот файл является частью проекта L2J Mobius.
   * g: z' _- f9 i0 r! r
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   : W7 R% M0 D3 q
5. * её в соответствии с условиями GNU General Public License, опубликованной
   " ]& B0 i6 N7 ]$ N
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   # m' D$ R" a0 b( @# o
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   # o6 }: a+ g1 E2 O0 T- ?% Z
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    . A' W& W! D; V9 _1 M
11. * См. GNU General Public License для получения более подробной информации.
    6 c. m' Z, \; `$ }
12. *
    
13. * Вы должны были получить копию GNU General Public License
    * C$ f  `5 G! I
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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

4 c* q* L, `; k' C6 A1 p
2. Импортируемые библиотеки

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   ' e) E- L1 [! ^' `$ Y+ B
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;
   
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
! g5 P) S4 }# N: M6 b& ^+ `

1. /**
   * q; [7 M$ Q5 D  L
2. * Менеджер квестов и скриптов.
   0 D2 F/ o/ N2 X+ d" t0 u/ v
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   8 h- J) z; n( e% X
6. {
   # V% l2 r# K/ i9 [& h4 x6 |! C
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   4 }! a7 R: {7 O3 O9 j
8.    
   6 A9 Q: a7 k- j5 O  y) c
9.     /** Карта, содержащая все квесты. */
   6 Z7 b1 u( @' j  `4 u; l
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    4 M6 C' u) E- U2 e$ O# o
11.     /** Карта, содержащая все скрипты. */
    5 R  R$ y% O- h
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    , `& O/ `# R% e0 g0 O: [5 Z+ u( x9 d
14.     protected QuestManager()
    2 Q, p: W2 n9 M8 z; y) s
15.     {
    4 E0 P7 W( _  D0 Y  L# d1 x
16.     }
    6 I5 k6 @: U0 ?# g! {9 a/ o
17. }

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

4. Методы
9 G3 I8 W* ?9 @. @* Q& jМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   
2. {
   7 S% O. x# o+ X
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   " R8 q& w/ x1 _4 M- c0 n; k
6.         return false;
   " g# P' ~8 o5 l& \
7.     }
   , C* A: R8 S9 Z& R* y' A" @+ i0 ~
8.     return q.reload();
   
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
7 s; A) u( F" q8 r# `9 N* T' k; f: jМетод reload(int questId)
. r( N5 c' K$ {7 D2 p: w" E

1. /**
   
2. * Перезагружает квест по ID.
   ( u# G: |! c  W
3. * @param questId ID квеста для перезагрузки
   ' H/ c' H! B% |2 o% s2 \1 d, T
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   : r# P# O$ {* [7 j
5. */
   , c$ V. w5 s! A9 v0 j9 ~; U
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   1 F' d+ j$ g: z- t- ^, z9 H
9.     if (q == null)
   " v: W; |/ k; k5 N
10.     {
    4 n4 b: N  g1 v, w% q
11.         return false;
    
12.     }
    1 z# c( m: {; p
13.     return q.reload();
    
14. }

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

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

Метод reloadAllScripts()
* N' ^. Y4 a# o+ n

1. /**
   : D$ e8 m( B! J" E5 s
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   4 k" c4 r. M& {  g" |+ h
4. public void reloadAllScripts()
   $ K* O; g: r& S
5. {
   
6.     unloadAllScripts();
   & H8 _" w  ^# k3 [
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    ! f; a# ?) e1 [. Z( Z, }9 A$ P# {# E
11.         ScriptEngineManager.getInstance().executeScriptList();
      t8 N, T3 t# D1 Q
12.     }
    1 F! J! x. Z- {5 n+ e
13.     catch (Exception e)
    % @0 d0 n2 m) }* Z- ^+ D6 T% G6 ]  s. \
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()
+ H* \- p5 ^0 W1 L8 G5 w  E- q

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   & h' B7 Q$ d% M: O) S* p$ b# a
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   ; Q: k5 H# y7 e# u2 S
8.     // Выгрузка квестов.
   9 t( G  p: X1 I4 @& W; _( u  }
9.     for (Quest quest : _quests.values())
   
10.     {
    % Z7 a8 u' o2 P6 h2 l. U
11.         if (quest != null)
    
12.         {
    + K$ M5 y" L) Z1 K( `- B7 r. D0 I9 t. k
13.             quest.unload(false);
    
14.         }
    * i& ~) \4 B8 ~; `
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    9 `% h& n* y' K/ `
18.     for (Quest script : _scripts.values())
    
19.     {
    ( {1 C& x) E! p# u) ?4 {. A
20.         if (script != null)
    
21.         {
    1 @7 |- x" q* d0 e4 v
22.             script.unload(false);
    
23.         }
    : ]$ z7 I2 u& a) H8 x+ j
24.     }
    $ e4 N7 z5 Z! e/ K$ Q1 X! x) Y
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  + R' C3 Q9 d3 P; U

3 |. N  R3 v2 k+ fМетод report()
$ e2 M/ H0 a6 K  [% j6 K' s1 _7 f1 {' J

1. /**
   7 H3 o# G  i; S) ]1 X
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   & Y+ W) J* p3 C7 Y) i
4. public void report()
   
5. {
   + s# D4 V* d# ]6 B! b
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   9 p1 v  g, t7 P: s5 D) j$ i
8. }

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

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

( }* ^" q9 p; V6 RМетод getQuest(String name)
  u% p+ c% g+ t! E+ G

1. /**
   2 c. W6 t0 }$ i; ~4 Q
2. * Получает квест по имени.
   8 }% ]; u% I% O9 C
3. * @param name имя квеста
   8 F% F/ x- q: r% c
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   ! P' R  P3 V# {/ i/ r1 O
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    
11.     }
    / d) m# h, y. t- z9 l" h
12.     return _scripts.get(name);
    
13. }

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

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

+ p1 j2 D2 V2 X* p, p; C& sМетод getQuest(int questId)
3 K' e/ v1 B% f4 n* W

1. /**
   
2. * Получает квест по ID.
   ! S8 c5 T6 K! h3 p! o
3. * @param questId ID квеста
   5 q9 h# [8 g, @! G# r6 N% I
4. * @return квест, если найден, {@code null} в противном случае
   $ o$ j; Q3 n& W1 I- S4 K& T. v
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   : T$ J/ _& C" _
8.     for (Quest q : _quests.values())
   / r$ L+ _% t, a! H, P  X
9.     {
   , e6 @7 k' P1 W8 D4 p5 O
10.         if (q.getId() == questId)
    
11.         {
    & g' Q% N2 `* K6 @* [+ V- h
12.             return q;
    4 I7 E  |/ w4 U1 B. Z
13.         }
    
14.     }
    2 F0 Y4 e6 e, H+ y8 V
15.     return null;
    ) R; z. @! q* @' }% n4 _
16. }

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

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

Метод addQuest(Quest quest)
1 c! q: e+ O, q$ ]/ W. Z8 I

1. /**
   
2. * Добавляет новый квест.
   , j2 ?% ]2 C# L$ u$ Q
3. * @param quest квест для добавления
   4 a! x. ~( u4 ?3 o% N
4. */
   9 }+ z/ K" a  O+ {2 V9 O
5. public void addQuest(Quest quest)
   ; g- _* e: R' B; W  P( h! J
6. {
   
7.     if (quest == null)
   - @" h6 t& ^& }) t/ {0 Z3 e
8.     {
   % B5 Y5 v5 @6 n9 N1 \7 @' \5 i
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    - s: |3 Z4 R8 m, U
11.    
    + X; A; Y! ]$ `( I3 a8 n6 u
12.     final Quest old = _quests.put(quest.getName(), quest);
    ) q  k5 a% l1 ~4 x; x
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    8 c% l, }% A7 p  I8 k' w
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    # X& x! P' ?( A* i; X
17.     }
      d* T% p2 D4 r; m4 L; ?6 h
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    ' r7 k. K& x0 O  X3 M* a
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    ( H! V) H8 g: D7 c% ]( C0 Q. u# ]9 t
25. ``

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

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


9 j' x! S7 w* H6 V7 R6 j