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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
0 S% F- K6 Y( i1 U6 `. Y
- `& P' D1 U% z- v' KРазбор файла QuestManager.java
0 q' {# @, y& [5 N: Q1 e
1 d2 O* t5 a" F2 m  F& O7 hЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
3 O6 R( o2 w' ~1 O2 L8 |Основные элементы

• Лицензия
    r( _" H2 r0 c# t
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  

QuestManager.java — управление квестами и скриптами.
  A+ ]* o6 g8 Q3 Q6 j( qПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

+ Y  |$ f: Z: U4 z. q! A
$ k; n$ C& {8 wДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
* P4 j, h) N) ^3 J$ \+ t1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
     h7 ]; t* d, W. ~+ d% }3 [
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   $ q" U% D) x1 ^( R- G
5. * её в соответствии с условиями GNU General Public License, опубликованной
   - P0 L0 y! n3 Q$ `
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   5 d3 R# [+ O. y3 a& E
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   ! F# `5 r0 c; R7 i+ f
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    4 ?) C2 X6 f0 g" v2 N. v2 n
12. *
    
13. * Вы должны были получить копию GNU General Public License
    0 H9 ~* o; t1 M
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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

% m3 ]- h' Q, T# o
( R8 d' F, |8 @6 ^4 m% A3 r/ i2. Импортируемые библиотеки

5 _6 a6 k$ X" r; s/ H& j

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   8 N- }( p4 P' q" ~* h
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   , h# c/ B! g1 X/ M( Y
7. 
   & B$ ~- t' F* w$ g" c( o* V$ J
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 — менеджер для работы с игровыми скриптами.
- M2 ~, A% d( l8 F9 K8 S4 s" F9 H& k
2 J5 X3 Y8 T3 A' X, _9 ]" ]9 u7 ~- R3. Описание класса QuestManager
) Y+ ~2 U- r1 M

1. /**
   
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   , U+ n1 k0 E+ T" C2 w  q- e
4. */
   $ q( j+ {, r, w& o) g1 {
5. public class QuestManager
   
6. {
   4 ^- r; z7 [  I
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   8 D- u8 n9 W: t+ v3 W0 {
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    # o  H" ^$ o9 V# W4 T
11.     /** Карта, содержащая все скрипты. */
    9 }8 t) m$ V; j  H. c. ^
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    ; L2 }( ?- V, L* F0 j+ [
14.     protected QuestManager()
    3 K1 F( G: O1 O  p5 w; d4 S6 Y
15.     {
    
16.     }
    
17. }

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

4. Методы
Метод reload(String questFolder)
- W$ u  W6 y1 V1 z$ D8 A7 g/ u# z

1. public boolean reload(String questFolder)
   & G) k7 E. O$ _' ]! n/ w8 q" X
2. {
   
3.     final Quest q = getQuest(questFolder);
   ( R" @9 U5 t. z7 _- d, ?$ K3 G
4.     if (q == null)
   
5.     {
   ( t% I' B) p7 i. ]+ \  w0 ?5 D$ Q
6.         return false;
   ) ?6 \3 ~/ @6 O% z1 D( R7 d: Q, H
7.     }
   " o9 u; L' K5 N, |
8.     return q.reload();
   2 r# }" G, Q# G) X2 {; `
9. }

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

0 p2 u+ j4 N/ F% Z5 f$ L8 w, `: I3 |  `
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

/ \4 `4 Q) ?* L# l* U

1. /**
   - ]1 z( u. ?# F1 X8 S* V+ B
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   8 o. s( M6 Z# R2 e7 Q
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   & p5 ?) F1 Y, |* U! S
6. public boolean reload(int questId)
   ( q% E2 g# J0 \# h: x0 E9 f
7. {
   1 Y% I/ h" u: l) O
8.     final Quest q = getQuest(questId);
   + `4 R$ _6 }# T
9.     if (q == null)
   5 Q1 q7 h4 O5 w, I8 F
10.     {
    
11.         return false;
    
12.     }
    
13.     return q.reload();
    
14. }

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

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

9 t) c! s+ P3 k1 Y* wМетод reloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   4 ]6 w5 W2 ]' z( b
4. public void reloadAllScripts()
   
5. {
   ( t. V4 f% C+ n6 |/ S
6.     unloadAllScripts();
   $ R! v9 h! N# }9 [
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    $ B* @6 w  g" `& n" U: J  ~4 H4 i
12.     }
    2 }5 d+ ]3 D, R' X. J7 I
13.     catch (Exception e)
    
14.     {
    2 k! f$ k4 ~. `# d! A4 Z8 [
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    , v$ E* ^7 L0 H4 B6 k5 c
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

1. /**
   : i* o# h8 |$ i, Y- p. O7 F' b( c8 k
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   ; d7 x; u4 Z/ N$ H1 m( R
5. {
   7 J! k# N" e9 J( `$ c, B" `+ F& O1 S
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   $ I# s( i8 Q* w- E8 U# c
7.    
   ) _! h) N$ S- R# l; u$ F
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   4 g, `2 B% C" W6 Z
10.     {
    
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    + `# s, \8 x9 ~. ]
14.         }
    5 P3 \; h8 r, J6 f/ }
15.     }
    
16.     _quests.clear();
    $ L* q' T9 k5 U2 K6 _& g! Y+ ]
17.     // Выгрузка скриптов.
    6 b6 |1 \* z6 x0 e
18.     for (Quest script : _scripts.values())
    1 D: ?4 }5 q, q7 t' z
19.     {
    5 Q3 a$ ?- p9 d: o7 E4 b2 ?
20.         if (script != null)
    
21.         {
    # u$ ^  D$ g, Q$ t7 W" a' X9 }
22.             script.unload(false);
    
23.         }
    * q5 d& ?2 j3 Q0 m! |1 h
24.     }
    $ C8 e* m; _: T4 Z, b8 Q) I3 O) A
25.     _scripts.clear();
    1 J' W+ [4 V) _1 s9 W6 u3 e4 ]- y* n
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ' A: a9 v; k& z$ z* M& K9 W" L! @

Метод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   
5. {
   ' j  ~! A8 P* t
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   5 F3 R, H" s2 Y/ a9 ^% R% r% E3 x
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

% a$ M8 t$ M5 L3 N( e0 |" c, I3 EМетод getQuest(String name)
6 {6 ^* }0 Q8 W, L3 N' K8 s" h

1. /**
   ) L( Q8 c5 U! o% u
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   ( ~  }: R: }8 _+ ?
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    
11.     }
    & @) n) \3 Q. ^) [
12.     return _scripts.get(name);
    # y' A& |1 W8 e% E
13. }

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

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

Метод getQuest(int questId)

1. /**
   
2. * Получает квест по ID.
   8 d5 B  A, z" c3 u  s
3. * @param questId ID квеста
   9 P+ V( i3 Z  ]; h2 K$ c8 k
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   ; C  t: V+ `  D4 d
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    / U' Z+ `+ V& {9 T. K/ Z
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    + l: Z- v  R! F. F  a
16. }

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

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

Метод addQuest(Quest quest)

1. /**
   ; i5 b) @. T: [  K+ r- l1 E9 V, A0 `! x
2. * Добавляет новый квест.
   % o8 \% C* z+ X* P$ x. |) a* l1 y
3. * @param quest квест для добавления
   ; n" g1 V( H2 v$ }/ b
4. */
   
5. public void addQuest(Quest quest)
   , `( K0 d+ {2 h/ t0 ?+ {
6. {
   ( _5 I2 s6 H$ ^0 X$ I& M0 Z# n
7.     if (quest == null)
   
8.     {
   0 u& y1 D$ e5 @9 k0 [- _. I
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   0 A7 S+ g* X+ j: M- J6 l
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    6 |. x8 i" |* s
13.     if (old != null)
    ' N2 t! o) ?4 f# i' o4 C
14.     {
    . w' X5 h: D1 t8 X
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    ( u& c# Q% r7 q2 t0 [: j$ p! D2 l
17.     }
    
18.    
    % Z! a$ i6 O, u5 E$ c0 {. R% G& d
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    2 r, I( m& m+ M( w
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    ! Y, |- h0 b9 \2 g/ ?' u
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    2 I6 h* B- H7 ?2 F5 o0 }5 V1 q( d! Z
23.     }
    
24. }
    
25. ``

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

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

0 Y* g6 w% Z3 _' n( r+ u/ \9 N
1 [& T" I9 s7 ^7 t9 _3 k; r