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

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

Разбор файла QuestManager.java
( R" e" i! H& \4 o% u' y
/ @' t. D# m% rЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
9 R8 V" j" m+ b9 ]Основные элементы
6 ^) s3 y4 {1 ^4 X% z, L9 V

• Лицензия
  , p  v( U0 n6 E. |! g
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    5 o# Z8 U) h9 Y/ ?
• Импорты
  6 B9 C& v( L8 L7 l9 D- w* h$ e

7 o+ h  G9 m3 i+ j( F8 q! IQuestManager.java — управление квестами и скриптами.
2 `7 t9 j* }: B( ]Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

7 l2 t  ~9 s2 G: m7 |
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   2 N- d2 X. B4 g
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   7 {$ M$ J3 L0 _) R7 Q
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
     X$ V, w# d% \6 S
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   ; R! X5 O' R  [  H3 E
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   ; p" }3 Q% k& e' z$ v8 o
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    3 ?2 d  i0 n, h% j; U
11. * См. GNU General Public License для получения более подробной информации.
    ' {$ O: ~9 \. ~! A2 B
12. *
    # g( q# g/ o; H2 W. g0 d' x1 {
13. * Вы должны были получить копию GNU General Public License
    + c& Q. T" m; ?" N
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    6 z7 U% r- r) f4 ~
15. */

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

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


* c2 [, u% t# F) m2. Импортируемые библиотеки

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   ; S  @. v* ~. m1 {) S- {
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   # {. m8 C# F( ?- E" r
7. 
   
8. import org.l2jmobius.Config;
   9 ~3 e! T4 R2 H$ t& @/ B$ Z
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 — менеджер для работы с игровыми скриптами.

8 t5 d4 N- j) j- w9 [8 N" m3. Описание класса QuestManager

1. /**
   : c9 c; C; i2 e/ S
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   3 |$ s+ A  H; j2 d0 y, N- a9 J
4. */
   
5. public class QuestManager
   5 q# c7 s, b, E$ V
6. {
   7 L* t$ B# y5 h% @6 e  Q% G  u- @
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    ) Y6 r/ ~3 z" N
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    1 q* X7 m# ^0 `& k4 O. P! N
15.     {
    
16.     }
    % J, o9 U8 E$ M: \$ P
17. }

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

4. Методы
3 z( }8 H8 ]7 T& q* rМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   * G7 l& d( G" T/ L/ Z- w4 T  S
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   
6.         return false;
   
7.     }
   / Q) c# Y7 u4 y& U! J
8.     return q.reload();
   
9. }

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

+ b$ G9 M" X$ uМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
* ?' n0 ]4 L( p  t8 x# {/ W0 G  E
6 R( N+ J$ N( B- C/ k6 p

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   - c' f9 i' C) v, H2 q. I* f7 m
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   $ l( x* H# c9 i7 g& v7 o/ s
5. */
   
6. public boolean reload(int questId)
   3 s" t% m% V- d/ x
7. {
   2 ^/ O  Z) X6 c6 s; X
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    
11.         return false;
    2 F; }2 K& _$ |3 ~# }4 H8 ~
12.     }
    
13.     return q.reload();
    8 i3 [. h2 `  r& a2 D( o
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  0 [3 Q1 H* D+ `. u+ [4 L

* v& g- R! `- J) Y: T5 A+ aМетод reloadAllScripts()

( s( L2 y9 h( ]( x2 Y- n& g

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   , p' I- i1 B: L% ]6 Z& o0 ?
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   4 }. V2 v, J% }8 R9 F& Y
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   , n( ?, _; A! e8 y* Q5 U" R
9.     try
   
10.     {
    ) E) M( g. P" u6 b; C$ f7 j
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    % q" f, }$ ~! {; Q+ ^; j
13.     catch (Exception e)
    
14.     {
    5 V# g* d1 k6 R3 Q) w" U6 }
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    " T" {0 ?. S5 z8 Z& `
16.     }
    
17.    
    2 h8 H& h+ _- K; ?0 F2 }0 p7 ^, k
18.     getInstance().report();
    0 ]4 A/ I" @, {0 ]; C% j6 M1 z7 b
19. }

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

Метод unloadAllScripts()
7 e$ Q( L4 G  G0 U" h) S( y' N

1. /**
   9 J( g- u+ y# S4 E5 E* I- \
2. * Выгружает все квесты и скрипты.
   
3. */
   ( Y5 z+ H1 s' T0 M& {; l
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   0 [4 o2 p7 o; [& U7 p- P
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    4 c) f# z% ?  _- K: J
11.         if (quest != null)
    
12.         {
    % ?6 n! e/ D* L& h) n
13.             quest.unload(false);
    5 R) m; u# c% f- c% R' m
14.         }
    % g' i, K/ e/ c- L2 V- V2 n
15.     }
    $ p" _' Y$ S' |
16.     _quests.clear();
    + ?; |; q* r+ O! y4 G: ]  ], i# N( ?
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    
23.         }
    1 i9 w; W6 p' I; s' E8 }: u8 \. {
24.     }
    , t% v' S; O! I; X; ^( o, G
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  . `7 B% E# q5 ]8 X

! A5 K. R0 w1 P- s+ I' z2 uМетод report()

1 q$ U: }, m+ X; B$ l

1. /**
   " `* {0 Y* N+ S5 e( s
2. * Логирует количество загруженных квестов и скриптов.
   0 ^3 U/ `; l2 |, p, Q
3. */
   3 v1 c) U& V8 S4 ~8 x+ l6 Q. X) Z
4. public void report()
   7 g) b% Q9 s5 l( f; h, ~0 N
5. {
   3 `. i3 p) l5 X3 t1 ]
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   $ e9 `/ D' z7 o# M- D- P# D
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   3 O$ V4 n  j' |* n$ k1 L4 X
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  % i+ I- Q4 l. \9 K' Y( k2 E. W

Метод getQuest(String name)

  X0 }6 x/ \9 [) D3 _/ a

1. /**
   ; b7 {3 o: L" a. g( R+ Z% b
2. * Получает квест по имени.
     t8 i) M: W6 \4 O9 q
3. * @param name имя квеста
   & S# @- o5 H. T6 s7 b
4. * @return квест
   
5. */
   0 v& M" m' Q( W# V: M* ^
6. public Quest getQuest(String name)
   / R- J2 Q* j" y5 X% R
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   7 P6 G# f/ B) |  u. p2 Z
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  ( u0 `( a' v0 p4 Z  N4 b

4 G6 g5 c6 ~* J( o  k. JМетод getQuest(int questId)
, z9 ~: r  {' V( }8 d
) R  M$ O( p5 g1 y

1. /**
   
2. * Получает квест по ID.
   ; o# l' ?$ I6 S: L- S
3. * @param questId ID квеста
   7 M/ K1 V0 v, B% s
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   $ r9 }' i: }/ y3 f7 ]* t/ p# w
6. public Quest getQuest(int questId)
   " R4 g4 t; ?7 R- z
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   3 h3 k9 _+ q; p
10.         if (q.getId() == questId)
    ! {3 j3 t5 Y6 w+ p4 ]' G  S! v
11.         {
    7 f$ a, l! k$ }
12.             return q;
    / ^4 [; L) F3 }3 t0 k  z' w& S
13.         }
    * ]& F5 @5 q4 W8 t
14.     }
    & f. q% I3 J! ?. L& u, C. H  Z( |
15.     return null;
    : _- n) [* F: S1 h1 b
16. }

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

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

) ], N: M; k& s1 ]- g( y# r0 vМетод addQuest(Quest quest)
2 W7 N" D- m- M; a1 j& v
* S# v5 V" J- i

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   $ g+ ?4 d* M  \7 T
8.     {
   ( v" l5 A9 c3 [
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    7 u% H/ d: e, k
12.     final Quest old = _quests.put(quest.getName(), quest);
    4 `2 g7 N) h+ S
13.     if (old != null)
    ! N* r1 U) e3 H- ~
14.     {
    5 k; |  ?; d5 \% q( L- l& q
15.         old.unload();
    & l* q: q* I6 p- V5 F( v/ F! ^
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    ! `1 P( R6 O6 H$ D
17.     }
    3 Z9 ~6 f& S8 L+ ~0 y/ `
18.    
    ' t" f) j+ Q; O. ?8 ~
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    7 n) b3 r8 y6 o2 R2 `6 Z
20.     {
    - Q8 W; t/ h8 O3 t# n  ^
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    3 o2 V) [! _* |7 f1 D; G
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    9 x8 q( F1 r! J) N, l  ?+ q, K
23.     }
    
24. }
    9 [( c8 s% `) ]( ~" Z
25. ``

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

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

( [0 K8 J, R, L8 J- f( R  R& U
/ v2 e5 N, B, b  s+ j( O; h3 c9 G$ i: B  u
2 o0 S, h# r( o% j! n7 C3 }  R: s