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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
5 S* t0 _- n( x& c- F2 ?
) R6 T! O- i# I9 dРазбор файла QuestManager.java

+ w% o/ B0 z8 `4 @+ XЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
) k# A9 w; s" KОсновные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    4 O" Y# U9 U, S" E8 s$ |  \# _7 f
• Импорты
  2 m) f( R6 U4 C$ P0 e

% J# _) y+ o9 G5 WQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\


7 f- ~& _' n( `7 s9 ?4 M, g  sДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1 f  K# f5 b- z) T% `1. Лицензионное соглашение
, M+ U  s+ V% R; Z2 C$ E

1. /*
   ) ^* B$ S" x& p2 U6 w
2. * Этот файл является частью проекта L2J Mobius.
     i" H5 }: l* I" ^1 U+ d
3. *
   . L- X/ h, l* [; p4 R
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   * F1 r* v8 g/ L) @9 f
5. * её в соответствии с условиями GNU General Public License, опубликованной
     e  a4 n! v; c+ y
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   / W5 C7 @5 e, \
7. *
   0 q0 i% ?" W  \
8. * Эта программа распространяется в надежде, что она будет полезной,
   3 i! x8 e) c0 N: K
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    0 C# s8 j9 d7 ]0 D8 C
11. * См. GNU General Public License для получения более подробной информации.
    9 B$ E  G' Y% w7 f
12. *
    : a5 W% p& T  p7 ^7 _2 j
13. * Вы должны были получить копию GNU General Public License
    9 m! ~: U: Q# H4 a
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    ; a7 U% L) Q# x' i9 O0 x
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
: @7 Q5 n' m$ ]; P  y4 K  e

. u6 c( B$ U! l6 M* O2. Импортируемые библиотеки

$ T8 O0 W* f4 J% O

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   ( B- h' [1 S5 O* _% M5 ^- B
5. import java.util.logging.Level;
   % k7 d& H9 M6 z  T6 [
6. import java.util.logging.Logger;
   * x0 `( W. v: q1 U
7. 
   " G2 S8 d8 T) @! S$ }3 J' g. d. U
8. import org.l2jmobius.Config;
   ! D) Q- h# G/ L& h
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 — менеджер для работы с игровыми скриптами.
) \7 X) B1 H# n: _: k5 k/ [) s: m
1 v7 b. a# o! F# E- r3 A. Z2 K3. Описание класса QuestManager

1. /**
   
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   6 ]( \! G9 o! y  f" m- m2 F% k6 |
4. */
   8 o& x% \* b" W$ ~6 [' F
5. public class QuestManager
   3 K9 [; e6 U" |/ i0 W8 m
6. {
   % L* t, T9 O% t& `
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   7 B$ E' h+ e6 r/ W3 D
8.    
   1 G" Z0 X3 G/ K
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    ' n' Y3 K5 x  i% m9 `
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    , ]8 v1 R0 ^5 o: {# \- b7 i& U1 v1 ~9 g# A
13.    
    
14.     protected QuestManager()
    0 d6 ~0 B8 H4 w6 |
15.     {
    
16.     }
    
17. }

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

4. Методы
Метод reload(String questFolder)
9 I! {% L/ O9 |4 J( ]( L3 l

1. public boolean reload(String questFolder)
   
2. {
   7 O, Y  J' j+ D: z
3.     final Quest q = getQuest(questFolder);
   / \& \: j2 n8 f  l8 N6 N- |, r
4.     if (q == null)
   
5.     {
   & @4 r! X1 P/ c- }7 Q$ l
6.         return false;
   
7.     }
   / ?" v2 t. i. K; w. @! X3 W# h- {
8.     return q.reload();
   
9. }

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

* ^  I+ h# H( h8 u4 a4 S
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
: x% n# X" ^- D( G5 j% MМетод reload(int questId)

. L! W4 A! M3 ~* S$ r9 O' G

1. /**
   . }; }: i  [) o( b3 p
2. * Перезагружает квест по ID.
   % j' l& f  y# V/ P& V
3. * @param questId ID квеста для перезагрузки
   2 b& D+ Q1 g% l0 V' [3 n0 ?9 l
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   & W- |9 {. g, C+ i" @% u' T0 g  R9 C* e
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   5 x' |8 d, M2 N( @
10.     {
    0 ^  ]. N; _) D! m0 f" G: Z" A5 {
11.         return false;
    
12.     }
    
13.     return q.reload();
    
14. }

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

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

9 V9 Z: x9 f1 [8 T! w, ~4 [3 x& u. qМетод reloadAllScripts()
' H; b6 ]$ W( L
% `$ N# G( r1 l) Y+ R

1. /**
   6 Q% [3 b& ]6 ~  F* t
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   , h* s+ u6 x3 K9 I
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    % @$ w/ h9 b" Y  W( p- v- u
12.     }
    
13.     catch (Exception e)
    . e( H  R& w& \5 a1 v
14.     {
    + V% s3 L. O4 A5 J- y' k! X
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    $ }* i* Q: a- Z( ^' Q
16.     }
    
17.    
    " A7 C2 i+ b; A; B
18.     getInstance().report();
    ' w4 e1 U5 _. b
19. }

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

Метод unloadAllScripts()

6 G# A) R4 X) n+ Q. D

1. /**
   6 }, M1 \, D& q0 d
2. * Выгружает все квесты и скрипты.
   , M$ y6 _2 L6 r* N' h
3. */
   4 z( O8 b6 g# Z+ p9 {4 O
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   & m" x  |2 E; @: u" ]6 O
8.     // Выгрузка квестов.
   ! a, P. Y: H# W, \9 `% D
9.     for (Quest quest : _quests.values())
   + y: ^) _; r: [& Q( r0 g/ a! O
10.     {
    7 G; p! D3 q9 d8 G7 _
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    
14.         }
    ' |, r( H! K7 ~& W' g! i0 C
15.     }
    
16.     _quests.clear();
    / g. M, ]7 ~) G$ U5 Y6 L2 l
17.     // Выгрузка скриптов.
    " s' m2 H* {; \' }
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    ' \$ w+ X! s0 y% S
21.         {
    , s+ i% s6 Y0 w$ d: c- U# W4 n
22.             script.unload(false);
    
23.         }
    5 C$ A. M  z; k* |
24.     }
    
25.     _scripts.clear();
    ) K6 B# Y. m9 a/ [, E# P; N
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  1 B% W( B* }' ?8 E7 |. k

; L* B& h! o8 h& T, rМетод report()

" `0 Q$ G2 m0 [: ?5 h. [0 T3 w- F! g9 p

1. /**
   % r1 I  i: _" T& w. }2 U
2. * Логирует количество загруженных квестов и скриптов.
   % a5 C4 _4 ?" P2 z: |% o
3. */
   ( g* e5 P: h) ~9 Y; F# P
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

Метод getQuest(String name)
& ^( |9 ]2 x' S1 s) b
8 ^3 _# L9 k' E; B) T& j4 t' D

1. /**
   ( m/ d( z" P4 P/ M' U7 M
2. * Получает квест по имени.
   
3. * @param name имя квеста
   : S) Z( q5 V3 E1 d. p- N- o
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   % C+ L7 e' ^8 g, m' M) e1 [
10.         return _quests.get(name);
    ; A; K, Y; R, e: A% U: J
11.     }
    ! ?  e" v' I, s; J$ O, n6 r& {
12.     return _scripts.get(name);
    5 o" t# Y2 x) Q2 w8 g
13. }

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

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

0 }1 u$ _: X. |' b" g+ sМетод getQuest(int questId)
; {) Z- P9 l" Z& K  K
- g. x6 a6 D6 i" K' G9 r0 z  a

1. /**
   
2. * Получает квест по ID.
   2 Y7 {+ f6 O" v6 W. H9 r; C6 w
3. * @param questId ID квеста
   ! V/ W( B# V: l4 }
4. * @return квест, если найден, {@code null} в противном случае
   9 J2 q. }" s, B5 w/ D/ H# x
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   # d6 I2 H6 c7 Z6 ]5 J: A
9.     {
   * [5 a" q$ T6 @6 `0 ~/ d$ ?, T, i
10.         if (q.getId() == questId)
    
11.         {
    + g  I! D! P  J  s, D5 V
12.             return q;
    
13.         }
    & J4 N0 [" W* t
14.     }
      M0 i- y0 S  n. x4 i) e. j
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  # A% N- W3 V, a* b0 P: `

6 F6 a: r+ u) f% A/ kМетод addQuest(Quest quest)
8 V' X) B; @' C
6 I. t" u( ?; i( m$ t$ b& }

1. /**
   8 @" K  E8 E$ t7 I4 g* R' D* F
2. * Добавляет новый квест.
   " k1 S2 l9 N5 i2 S$ r
3. * @param quest квест для добавления
   $ Y. H# K- l- K' p. W5 c
4. */
   8 p. D) P$ j. N. z0 \6 H+ K4 E
5. public void addQuest(Quest quest)
   
6. {
   7 h* H# V4 v! u8 _$ \9 v+ Z+ O. H  {
7.     if (quest == null)
   6 Y+ N. x; n+ v. m. n
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   & T) D/ I; Y6 v- Z( \0 j4 I: T: k
10.     }
    0 l4 A4 ]# w) J
11.    
    & z$ M1 A7 ^6 x7 e1 {9 i. c: T# T
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    % W! v* d" V" c  f. M% f7 y5 N
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    3 j; {( a- S" n" ~- \+ C
18.    
    8 V9 A" L4 e( a3 X
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();
    5 K9 M* _' c! L8 I5 @2 c
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    $ f  x' b7 x7 E! |
23.     }
    
24. }
    
25. ``

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

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

5 v0 y& ^; X: r; {* o