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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
3 |2 j8 @$ V4 q' M
Разбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
% X7 h3 Y- N( v' pОсновные элементы
  ~# p3 W# b' a9 x# h5 N

• Лицензия
  ' T4 [& U5 k& m' E
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  ; Z  S: c- r2 K% U# n7 Z! p* F

QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
2 B- L9 @9 I- T

Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
     O% @* T- \' l; k; d( A* h
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   0 \3 V* j2 e% Z& Q2 W6 [
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   , x! O: x. B6 k+ Q9 P( z
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   2 k& ]9 P' h% W  [" j8 R  Z! D; `
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   & W9 H+ Q1 T3 i7 E7 |$ w
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    . A' Q+ K* l" v- E3 ~8 n. a- r% n
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    + W+ }- `1 |% r( u2 S5 ~+ H
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
) l$ a( x  v) p8 {+ C* ~2 ^: N
  P/ q0 t1 F( G- b( J
2. Импортируемые библиотеки
5 I: Q3 h! T/ Q. t% W' y

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   * _, V1 `7 j8 o6 Z$ k8 N6 l
3. import java.util.Map;
   ; W1 y+ ^5 _8 e/ l7 a4 s- j
4. import java.util.concurrent.ConcurrentHashMap;
   4 B  C( w2 J6 Q; a, w' B
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;
   ' ~: Z, o4 h3 c8 Y
10. import org.l2jmobius.gameserver.model.quest.Quest;
    9 P0 c) I5 Y1 M/ l/ z; G5 y) q
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
, R0 N; t8 S( u' @1 W  d

1. /**
   
2. * Менеджер квестов и скриптов.
   2 \+ w/ w4 F' A
3. * Автор: Zoey76
   % M: y9 G/ m& d. U- o, U2 L! O
4. */
   
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
     Z. v% C  z* |" s6 N% `' W9 f6 I
8.    
   5 f9 \! P: y3 R/ L. E
9.     /** Карта, содержащая все квесты. */
   ( B7 X0 f9 Z  O! g9 f, I" {
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    - g% I$ X9 B  g9 G7 @
11.     /** Карта, содержащая все скрипты. */
    ' o3 a: x( u# A0 P( q
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    * P/ u' y& T1 e
14.     protected QuestManager()
    4 ?1 q2 Z9 P8 }" H8 Q4 a
15.     {
    
16.     }
    
17. }

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

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

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   7 n9 C' n* u, |; f0 Y+ P3 L7 R) c
4.     if (q == null)
   
5.     {
   
6.         return false;
   
7.     }
   ; V& z" }" X; n6 e9 x
8.     return q.reload();
   
9. }

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

* `, U- |; |& I+ k
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
8 x* ?- f& _% A& @8 F+ XМетод reload(int questId)

1. /**
   
2. * Перезагружает квест по ID.
   8 Z; _; Y$ Z: T
3. * @param questId ID квеста для перезагрузки
   3 u2 ^3 [" R8 N" l8 U& T# U
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   2 D8 @' V/ P% V. n& a0 i( e
5. */
   
6. public boolean reload(int questId)
   , v- N$ z3 A# V( \8 }
7. {
   1 C' p9 ]) i# w2 o
8.     final Quest q = getQuest(questId);
   " t: j2 h: T8 H( C% a
9.     if (q == null)
   5 A" Y  n' v7 t
10.     {
    " Z' `7 _. J5 T! x+ }
11.         return false;
    
12.     }
    
13.     return q.reload();
    & I) }4 t8 c5 i. q" A. u1 n
14. }

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

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

Метод reloadAllScripts()

' g/ V# d3 ^. a- T1 T2 o

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   2 O) W& y9 Q% Z
3. */
   
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   : P. a6 C: A: f) k5 O+ Z; O
7.    
   6 t9 C6 u5 A: h( C3 u$ w
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   ! A- k' g; k- E# t. e) z
9.     try
   8 ^' D6 N6 l  Y4 X( e; {1 Z
10.     {
    8 e  Z+ I) i6 \3 t7 v
11.         ScriptEngineManager.getInstance().executeScriptList();
    ! @% x3 x* y, r- |
12.     }
    ( I2 w3 }5 H/ R1 \$ R  J* s# ]( \
13.     catch (Exception e)
    
14.     {
    ' Q3 Y3 w5 ?) h, G
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    / w  l6 M) }7 {9 j- g  D" k
16.     }
    & e, e9 g$ Z+ o+ m) {
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

7 a# ?& U6 k, \! u. l0 l0 s

1. /**
   3 `# T' v! h2 k" A
2. * Выгружает все квесты и скрипты.
   
3. */
   : U) C& Q* B5 ?0 F
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   # [' c! X* c! c7 z- E3 j
7.    
   
8.     // Выгрузка квестов.
   , B% E9 O' L) u, L' @9 S- Q
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    / K8 j6 a8 {: F1 e" v0 }" H3 Y; T3 `
12.         {
    
13.             quest.unload(false);
    
14.         }
    . S" e% k  {5 [% `/ K
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    * u3 I. v% O5 _. g
22.             script.unload(false);
    
23.         }
    / w" x/ `9 b% U3 N* t
24.     }
    / r2 X: N& d. Q
25.     _scripts.clear();
    9 z2 s+ g; U. j8 E" Z% t
26. }

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

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

Метод report()
( l$ n2 p0 w9 M. m( [* T. D4 Y8 \
3 J' a( U: D* E) I

1. /**
   6 Q; }7 ^7 `$ M) e6 i8 N) y- C, C) n
2. * Логирует количество загруженных квестов и скриптов.
   ; k1 B+ j1 p9 V: I# G4 E
3. */
   1 k9 G8 D- }9 R8 ]1 S5 q5 P5 t: J
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   7 G4 ^. V4 ]! |# ~9 ~* O
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   & {  V# U( Y+ e4 Z8 k1 N
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  $ \  R) S. V& v* @" k! p- D5 b

Метод getQuest(String name)

1. /**
   ) k& w$ n' Y; x$ Q" s! y
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   0 E3 U. q( I% b7 x+ ~
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   0 Y; o: A+ y3 E) [$ g
10.         return _quests.get(name);
    ( g2 l+ E3 e4 s. |
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  # M) K4 Z/ d" l7 p6 K- h8 R

6 f! j/ C3 q5 H% N, n7 f8 ~Метод getQuest(int questId)
) b- n3 u' ^- @# a( G8 H& Y% y
! O2 g" h7 E" z5 B* ?2 y

1. /**
   $ W5 b/ [* ^$ x& F3 l4 U
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   4 B4 d! N5 p) n" ?
10.         if (q.getId() == questId)
    
11.         {
    - |1 Z) }' e( d6 Q6 T+ W3 V) N; Y$ }
12.             return q;
    3 c4 D( C: I5 J1 _4 L- t0 \2 }
13.         }
    + S( C4 X/ E- r0 T- W$ G3 e
14.     }
      H- m, e3 u$ z! `" F
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  7 _, V; [/ r3 s+ I* T: N  t

Метод addQuest(Quest quest)
6 J. C) k6 N# n5 x4 y
3 w& G) _; ^# y

1. /**
   
2. * Добавляет новый квест.
   7 Q! c: a, I  J0 A( ~
3. * @param quest квест для добавления
   9 H0 a3 {* `4 `4 W, W
4. */
   & \* |; i4 E2 l; T
5. public void addQuest(Quest quest)
   3 F* X! y& h6 X0 j- Z6 |2 t  q
6. {
   
7.     if (quest == null)
   
8.     {
   . o+ S8 g8 g4 [* c6 |8 K$ K
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    3 ]8 G+ c7 l' u5 [
13.     if (old != null)
    
14.     {
    + m3 f  }0 J( |* X5 B& a
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    6 W4 @; ?$ o6 G/ a/ a3 A
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();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    ' U+ a% c* K9 w
23.     }
    # k' D1 u8 A7 w/ X/ c1 w1 N: G: I
24. }
    
25. ``

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

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

: M9 W8 b# h7 F" q" M+ e; o