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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
% f- ~4 P/ T: e! u7 J" h; D
Разбор файла QuestManager.java
& }/ n, B; y$ C/ F3 _3 i2 t) I
& n1 C3 g. w5 t/ jЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
9 t) q0 E& h3 h( XОсновные элементы
5 X6 A5 a2 u/ u" Z/ r" S; g

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    + K* u9 t$ V  d/ a9 T+ M# C
• Импорты
  ) C5 T! {& p- l5 w

+ }8 g9 H+ X' W7 k3 fQuestManager.java — управление квестами и скриптами.
; ~) u2 a0 ~# m" `: PПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\


: P: N! e2 B- `( kДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
$ ?6 M2 |; x8 t7 _+ m' D' w1. Лицензионное соглашение
3 Q& i- a( l; U7 t  [5 `

1. /*
   ; m0 m' K) a# ?- O$ B
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   ) c2 T! j: V4 Y5 T
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   , u2 K8 c3 s0 B: u) C, v
7. *
   - j. x( \) h& Q7 e% c# @5 ~
8. * Эта программа распространяется в надежде, что она будет полезной,
   - u0 J3 N5 k" g" u
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   0 g, [3 n( S5 k0 `! I
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    " M# `( Q( P5 `1 V5 _
11. * См. GNU General Public License для получения более подробной информации.
    # O% u# L5 Q( @+ z0 L$ X
12. *
    
13. * Вы должны были получить копию GNU General Public License
    . m2 ]4 _- s4 F+ O
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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

0 T. v! r9 j3 d+ ~) N" i7 Z+ q
$ X8 k; h3 h# H7 C: [6 ]0 {2. Импортируемые библиотеки

1. package org.l2jmobius.gameserver.instancemanager;
   7 \/ E% c2 W+ t- M& u
2. 
   ; e' |$ i. V/ w8 d
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   ! d0 ?: t& H) Y+ |! h
6. import java.util.logging.Logger;
     r$ C9 M0 |; L) b2 E/ H
7. 
   & @  c. w1 r# M( [% @2 R4 X
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   , B( {, x6 V' y- w2 ~+ P
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
0 |) L  i% n- z  P$ c8 {: i/ W; c0 r

1. /**
   7 ?! ]# H3 g6 R5 y3 S* d- M. q  ]
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   
6. {
   2 ~+ c. @5 k, i; O( ]: V
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   1 N# |: ?7 U$ s. ~& w; J
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    / l) c) \& r  O; P6 V
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    4 |( s( U1 |7 u: k% g4 M5 X1 ]
13.    
    3 Y7 [9 _: ?' I4 n% S5 ]
14.     protected QuestManager()
    & m- B+ O) w# j& n! X+ t
15.     {
    ' w! h5 ?/ G. X0 S& K
16.     }
    % X% W" Q! d; ^9 j) s( l
17. }

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

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

1. public boolean reload(String questFolder)
   + U3 J+ [; p0 C) M! f4 ?
2. {
   4 y% T% N" @3 K/ q
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   ; _! z. q8 [  O
5.     {
   ' k/ C% G- Q4 m
6.         return false;
   
7.     }
   
8.     return q.reload();
   
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

+ U& O1 n/ E$ l( t

1. /**
   8 T9 g2 E+ {, ~% x' X- T
2. * Перезагружает квест по ID.
   6 J5 s7 ~# g& u5 |- L
3. * @param questId ID квеста для перезагрузки
   " A: I2 w2 \- N+ v0 f6 B
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   $ X5 ]. p) T) f2 M; M6 z; A
9.     if (q == null)
   8 c, F: D& R9 |1 ^5 e
10.     {
    
11.         return false;
    
12.     }
    
13.     return q.reload();
    
14. }

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

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

Метод reloadAllScripts()
) G4 p2 s4 D" ^; |* V+ Q; P3 L

1. /**
   ! Q' R6 L+ b4 ?8 z' S# M
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   8 S8 U! [0 c5 d* y9 G' a' t( H3 a
3. */
   
4. public void reloadAllScripts()
   . ]6 f2 ]- Y1 u
5. {
   # n+ O/ `$ @0 I; l
6.     unloadAllScripts();
   8 W4 k; U% H0 X
7.    
   4 g. o5 W6 J# Y0 d
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   ; `. _9 I8 z. [# e
10.     {
    ( A) v! i  d$ l& l* I. R% T
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    0 p, C" p- R2 P7 V" Y
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    
18.     getInstance().report();
    % b5 d. ~/ V' e9 U- n* V4 A
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   3 l* i. e1 C' q, e* H
3. */
   
4. public void unloadAllScripts()
   8 x( [/ ^6 j1 A7 P; y& [& T
5. {
   0 W! O! {4 _2 s+ S0 R
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   . P* `, i7 e0 Q8 m+ S, b4 r9 y
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    $ c& V% g% H( ^! T
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    0 g) f$ s8 x' f* o
14.         }
    $ D, N( N7 L) V7 L
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    4 K, O8 @5 J* e( s
20.         if (script != null)
    + Q- |3 ], k9 N. J
21.         {
    
22.             script.unload(false);
    ) A* n, k2 R: p0 Z; y
23.         }
    
24.     }
    " g* l! i  t: h/ ~
25.     _scripts.clear();
    ) i$ Z( d: {4 g0 C$ m- |# A
26. }

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

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

Метод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   % _1 N* }( h8 ?, n
3. */
   , |: S& J- w9 F! i3 s
4. public void report()
   * w. Z3 ]% k# q
5. {
   3 v: M0 r# C* w5 o* _; a* B/ b# a
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   # x$ D9 m' z4 U) r
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

Метод getQuest(String name)

1. /**
   ( |" e" l8 @: ^. Y6 P. H( A3 G
2. * Получает квест по имени.
   & ?% ]/ a0 k  E4 x, {- e
3. * @param name имя квеста
   ; H( r, G3 J! T: S! }
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   9 G2 B. W0 t1 M; `
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    " H: K! I1 w0 T$ T
11.     }
    ' |% \$ {; L6 R7 A) n$ |
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  ' A3 G# W: r+ W2 ^; X, J

Метод getQuest(int questId)

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
     Q% G3 V/ W6 J  ?9 ]) O3 I
4. * @return квест, если найден, {@code null} в противном случае
   : y( O, ~5 W% D1 I0 I
5. */
   : s3 v( x* |' V) @2 H
6. public Quest getQuest(int questId)
     v4 W1 k6 E6 N1 E
7. {
   9 B4 C$ u4 a% j
8.     for (Quest q : _quests.values())
   " w7 m) ^% _# w: D
9.     {
   
10.         if (q.getId() == questId)
    , e( J# ~0 l: r9 b
11.         {
    
12.             return q;
    
13.         }
    
14.     }
      k' d( W  T1 c+ p
15.     return null;
    
16. }

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

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

. U9 n3 w: ~4 X, E, F3 H# CМетод addQuest(Quest quest)

: ^; d+ g" S. R  G$ m1 P8 R

1. /**
   
2. * Добавляет новый квест.
   $ d7 y! p* I$ U: ?, y0 Y- s4 `
3. * @param quest квест для добавления
   ( I* _% I; H& m, L; q7 J) U) S
4. */
   
5. public void addQuest(Quest quest)
   * e' e; r, J3 p! g9 G
6. {
   
7.     if (quest == null)
   
8.     {
   ) r. y) W$ J. W5 h$ h) @
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    ( x/ p. G. e% _  ^- O6 r7 A+ y
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    # \5 L# M  @. x) e. H# ~
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    * t  @: S  G' X0 t- ^
23.     }
    
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
2 G2 y$ u, v# d4 VЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
4 u9 X& a7 l. C# V