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

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

& Y. @- ~1 B2 J) c" u- U3 i- O5 B; @Разбор файла QuestManager.java
* A$ w/ U6 w* w9 n% _+ [
Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
$ o2 R% j8 k: d! v7 r9 Q/ t

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  

6 H4 W6 n& c( k1 B- ^4 v) gQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
  b; _$ G0 P, ?) j$ Z7 a  s7 v

Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
# c6 |) a/ k; D# V

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   7 r6 d$ d3 ^9 O: W% l2 X
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   ' ^5 `% n, V5 G: k' }1 `- |) k
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   0 n* g- l% ~& v% Q, a9 ?
8. * Эта программа распространяется в надежде, что она будет полезной,
   - O! N* H5 j& r, `
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   8 o" x. r/ \. R2 W! i& ^
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    $ O0 J  b4 y, T+ \2 M* w" X; k
11. * См. GNU General Public License для получения более подробной информации.
    , M: N7 t/ w  [* f$ D
12. *
    
13. * Вы должны были получить копию GNU General Public License
    8 w6 J# h% `/ V- E2 [! R) Q) U% F/ [
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
0 W; F; i, S5 @% q5 ^4 A
' E' P' c% ~8 o& Q2 n! t$ `
5 T: x4 f4 ]; F1 V2. Импортируемые библиотеки
9 B/ r$ q' b+ p

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   7 d  J1 T4 B/ s* @7 `% N
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   0 o( K$ W" m$ n4 v! @" T
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   3 }2 I$ K: p. I* {! C, u
7. 
   + L5 ^" L+ |5 M# d9 V- d) I
8. import org.l2jmobius.Config;
   , m3 |' E/ E; 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 — менеджер для работы с игровыми скриптами.

3. Описание класса QuestManager

1. /**
   
2. * Менеджер квестов и скриптов.
   + W( L6 f) ]3 M3 W0 k$ H3 N  l" R% T2 Y
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   # l  c, _; G9 r4 U. O4 [
6. {
   9 Z- Y4 }1 @8 N( ~
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   $ n, W7 @- g$ _. @4 _
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    ! J; ^' k1 R2 y6 l. X; O! M
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    2 U* i+ O" o+ g) L. h* Q& T- }  E
13.    
    
14.     protected QuestManager()
    
15.     {
    
16.     }
    & F# d6 S+ ?: \8 z# e: _: x
17. }

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

4. Методы
1 E9 f8 w  J6 f- l7 uМетод reload(String questFolder)
2 o) x% x* W) w9 @( a! N

1. public boolean reload(String questFolder)
   
2. {
   4 Y" l: B/ X) Q9 ^9 O. ]
3.     final Quest q = getQuest(questFolder);
   ! v' g* c4 E4 R0 o! o* v( n
4.     if (q == null)
   
5.     {
   3 b+ R) C6 S4 u' _9 S4 q# |
6.         return false;
   8 `& P. j) w7 l: N$ U. S1 J
7.     }
   
8.     return q.reload();
   
9. }

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

8 x7 z( H% e1 j# H* ?
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
7 T% C4 a, E* K, EМетод reload(int questId)

1. /**
   
2. * Перезагружает квест по ID.
   1 y$ z  k! x$ M( ]( d. N7 y
3. * @param questId ID квеста для перезагрузки
   8 ]( t# L- e% `9 ~- H  d5 ^
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   / V9 }+ M( P1 l3 M6 }7 ~% W
6. public boolean reload(int questId)
   3 `& K9 [8 W" T; H( F) O' ?; Z4 `* [+ x
7. {
   
8.     final Quest q = getQuest(questId);
   4 |- H! t4 O3 ~  x  m/ u' H8 j
9.     if (q == null)
   
10.     {
    # V- z. }& E+ d) o
11.         return false;
    
12.     }
    4 v$ N! @% k- G# h% [+ s
13.     return q.reload();
    
14. }

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

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

$ a3 k% ~: ?- T( k9 P9 o* VМетод reloadAllScripts()
1 G7 ~, h4 m* y  M

1. /**
   1 P- k8 L7 ^, X. ~4 B- N- C
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   . n9 Q4 v9 |; r; h! W3 b( }
3. */
   
4. public void reloadAllScripts()
   3 ~9 N- a: y; ?) i- W
5. {
     i' E6 W/ J" O
6.     unloadAllScripts();
   3 a* g, v- k2 \5 V/ q
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   - i  m+ Q% ]2 @
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    
14.     {
    ' K3 g$ H: S9 v& V6 G
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    8 x1 m% t6 X4 F. t" e- U
16.     }
    
17.    
    
18.     getInstance().report();
    0 F. Q; d( K" e/ m; P
19. }

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

Метод unloadAllScripts()
9 Q0 A" W  _( \) c7 q

1. /**
   5 u2 S# K1 y( o* g
2. * Выгружает все квесты и скрипты.
   
3. */
   1 n. D& u4 u0 o* h2 j0 i4 |% F, U8 c
4. public void unloadAllScripts()
   % S8 U8 @3 }. ?3 k# r) I+ e( T& ]3 M
5. {
   $ O' _/ Q  D* ]
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   ) ]& R) L4 n8 h+ N) }4 C
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    0 L( o" M& J3 W. p4 c
12.         {
    & H% J$ {/ \$ `; _
13.             quest.unload(false);
    
14.         }
    / {/ W) b6 N5 l( N4 J" P% h
15.     }
    4 R& r2 s  D% y# d5 ~/ E1 q! F
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    ) D2 b. _& ^! \# y
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    0 Y! O% V5 W% J2 j2 ^
22.             script.unload(false);
    / ?8 N( q  \0 _0 e/ z7 ~" `
23.         }
    ' _8 d' _6 ^1 u- o" G
24.     }
    
25.     _scripts.clear();
    
26. }

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

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

$ ~& q- d* H* {9 Q0 \: QМетод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   * }1 |" z( R9 e+ \: c" W' Z
3. */
   ' V6 ?1 l$ X+ q4 U+ X9 T& M
4. public void report()
   
5. {
   , v% c1 Z8 C# B, l% \$ {8 {
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   ' z2 ]- L: `* ~- c+ R7 ]: U
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   . j# z: n8 @9 P/ j7 M, _
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  - k; m2 c2 ]: f# M9 E

& N, U) D4 E  x. A/ yМетод getQuest(String name)
; k# h3 v' J3 i+ F' D( @
5 G% F; i" u4 K# g' g5 ^

1. /**
   8 J, {& d( Z+ A: q; C: r
2. * Получает квест по имени.
   
3. * @param name имя квеста
   " s9 S" T& Q+ j* o
4. * @return квест
   
5. */
   ; q5 k: D/ L; S1 u. J
6. public Quest getQuest(String name)
   5 z& h; h- L% c: e- K5 A
7. {
   3 J: C4 p0 u* V/ j& ~3 B  }$ j
8.     if (_quests.containsKey(name))
   : C' J( J) b* u
9.     {
   . u% p! y: t4 ^* C
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
      h1 J9 Z( h9 z4 ?# M
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  ! n3 J4 @5 U* u: v0 n

Метод getQuest(int questId)

1. /**
   ( b9 m# _! l6 ^; _- R
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   ) S& F& v% U% i1 N7 N7 D. s1 T
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   6 u8 H' w9 I' K
7. {
   
8.     for (Quest q : _quests.values())
   + c5 `2 Y) {( @& K- |5 U
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    5 l% X5 ]8 d/ E0 ^1 J
15.     return null;
    & g9 @0 `7 R3 b* x7 \. S
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  , m# v" L- g. E0 W0 a  Z) t

Метод addQuest(Quest quest)
8 R$ y% n0 [# k4 {! t. y+ T2 H! \5 A
2 d/ ?- S" e, a8 R

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   9 a5 H2 g3 S3 @8 M+ _
6. {
   - u- F/ `8 j6 k( ^2 f* T
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
     N& Y# [1 z) ?# |; `  \+ X7 {" v2 S
10.     }
    1 M! G' {% B6 V; Z: h( Q
11.    
    3 ^* {6 G4 ?, V2 [1 w# C# s
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    3 I9 G5 F$ j' y# ~  l
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    8 j3 I! O) h* R4 z1 G
17.     }
    : P% }2 [% Z" ^  Z+ J- N4 `
18.    
    2 n0 d* d7 L/ 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();
    ; D7 Z( P3 }. r" ^
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    8 [2 H9 I/ g1 J. O+ E$ v) O3 j: I3 j
24. }
    5 g# q2 h# z5 F, C* Y6 e: X. E5 m
25. ``

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

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


9 J* L  O8 l5 m7 u+ C4 {