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

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

' |/ _5 o0 g- D+ B, vРазбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
! d1 M5 ^2 X  |9 pОсновные элементы

• Лицензия
  # q7 h) g- P* x8 Q2 f4 p4 J. X# H
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    - V+ O6 X* V' Y. @7 U* |
• Импорты
  / J' c* t3 g* I/ d  @* v# Z

+ f9 e: G7 k, ]2 HQuestManager.java — управление квестами и скриптами.
4 f* g$ E1 N) }! i3 H, O: x& `Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
' M: X- N& S# @+ o4 @  f

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

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   % g: ^0 p+ D0 Z) Q
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   ) e+ `8 j# e2 y. D. M6 q3 K
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    0 a% ~  w- L+ O: y/ a" b) O1 R
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    + r$ x' ~0 V+ h; c, q/ r
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
/ J" W- {5 k2 R6 ^! _/ _

2. Импортируемые библиотеки

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   3 Q5 Y) a+ `( F* c. a9 t$ E1 T
3. import java.util.Map;
   3 [: v6 b0 N7 B7 z; C) P
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   
8. import org.l2jmobius.Config;
   ! s; S1 O0 z7 P$ T- {8 c
9. import org.l2jmobius.commons.util.CommonUtil;
   - g  y# Q4 d3 m. P8 Q; S- o
10. import org.l2jmobius.gameserver.model.quest.Quest;
    ' `, [) U: C7 H# G5 [
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 — менеджер для работы с игровыми скриптами.

( _/ O. `: }2 F! w6 C" X3. Описание класса QuestManager

1. /**
   
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   2 i. j; g! K, N5 D; u7 D
4. */
   
5. public class QuestManager
   & M- n! G7 L$ Q: K6 F7 A; L
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   0 o- w" O9 w$ ~, o
8.    
   # F6 o1 ^! o1 u. F# E
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    7 g2 p2 e1 M6 B# U+ b
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    
15.     {
    
16.     }
    - y) y; q8 z1 O" q9 B( N8 e, }
17. }

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

4. Методы
8 L  P; x$ b+ K9 b. d; {% k- r7 C) {Метод reload(String questFolder)
, X& `9 {' e/ ]0 q: S0 u" L

1. public boolean reload(String questFolder)
   8 n, s4 \/ i% F8 b
2. {
   ; [2 t' k0 u2 J+ o8 A' x5 k
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   ' _8 f7 Z2 t- O
6.         return false;
   
7.     }
   
8.     return q.reload();
   - x; l# v0 F+ C  s) h: W8 e( p; N$ W( N
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
5 B3 Y! ]* X0 O3 ~# S9 LМетод reload(int questId)
: n# d$ V6 _# T9 b$ H) n: x2 A- T+ }
' G5 ?" q% `0 ~; r  o

1. /**
     h8 [) W/ U) s5 [3 _( ], c4 g
2. * Перезагружает квест по ID.
   1 I% j: c+ A8 N6 h* ]9 O
3. * @param questId ID квеста для перезагрузки
   9 ]4 S/ \, `! _6 l
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   % n  e1 K) m& l* E7 w) y
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   5 G# n! s. @2 P$ ~" y
10.     {
    
11.         return false;
    
12.     }
    
13.     return q.reload();
    " {" z9 \( X- `9 y/ o) I3 {
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  ! w" @2 I; ^# {' |3 v

2 d* J- J5 Y7 k# o( y% [Метод reloadAllScripts()
" [  @  o+ ]9 }0 s& g2 E1 R9 S
: U4 G& m1 _% h! Z1 o* U; ^

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   3 M; |3 m  i; q; J5 E3 v
4. public void reloadAllScripts()
   ( ?) y4 V: p3 D2 c: y! b
5. {
   ' c: K6 z7 `7 P) a- b2 X0 |
6.     unloadAllScripts();
   % o( c; H( t* {; t
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   / L$ p3 B! l, z) V/ m
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    
14.     {
    . P. g7 J0 z7 M( N
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    ! z4 Q' O! L! H8 z
17.    
    
18.     getInstance().report();
    $ C. A5 |2 S$ l* Z9 W. v3 D8 x
19. }

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

Метод unloadAllScripts()

9 T, |4 w; D0 j% I+ Z3 l

1. /**
   3 u" `1 ^, f5 d/ R5 x
2. * Выгружает все квесты и скрипты.
   & M2 V' n+ p, |) m' w5 u7 S( j
3. */
   
4. public void unloadAllScripts()
   1 b5 c& s1 f, C9 ?) g& @
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   8 u2 S+ K; Q6 c# T
10.     {
    + D1 Z2 }/ C* k2 f. N
11.         if (quest != null)
    0 ~4 n$ F/ o7 C# a; F. Y& Z3 E
12.         {
    
13.             quest.unload(false);
    ; A8 g0 l- \- S- O
14.         }
    + Y( D6 ~: q" c9 z7 n6 k
15.     }
    8 I) H. z/ j( V$ [% d- ^
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    - M9 k! D6 W1 U, Q" C$ |7 b
18.     for (Quest script : _scripts.values())
    & r- z% n* }5 u( X7 E- N
19.     {
    
20.         if (script != null)
    
21.         {
    9 i, }( C! B# w$ ]. b
22.             script.unload(false);
    
23.         }
    
24.     }
    
25.     _scripts.clear();
    
26. }

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

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

3 U, d: }* b+ yМетод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   3 y$ S! R" C2 a
4. public void report()
     o& a+ n, n  W& I; r8 L+ J
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   $ K' G+ `# ^; U
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
     U" L' `' |3 ]6 c/ t
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  ) J+ |3 ^3 O2 |5 L  H6 J0 t

7 l) _+ f5 E" {2 w6 y% Y* tМетод getQuest(String name)
! L! e+ |- z4 I3 C+ S

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   2 k8 C1 T0 }) C& E; h$ c) R1 @
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    5 C! z- Y1 T& [5 U& g
11.     }
    
12.     return _scripts.get(name);
    7 j9 o6 m7 u/ L' q$ v: n5 q
13. }

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

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

0 O4 x& E8 G+ ?Метод getQuest(int questId)
- G7 O" y2 A6 W# G/ J, t) c7 o8 u
4 y/ {: Q% K$ F) n# n. ?0 ]1 q

1. /**
   3 W* |, l* ^6 U/ A: q
2. * Получает квест по ID.
   ( m6 j+ e; N: ?1 M% h. {+ j" X
3. * @param questId ID квеста
   1 e+ Q' ?1 c3 L) u
4. * @return квест, если найден, {@code null} в противном случае
   , \8 t: l* V7 z4 A; |
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   , K- q/ k$ w% t6 Q
10.         if (q.getId() == questId)
    6 y" H6 p* z! ?- e
11.         {
    
12.             return q;
    , v. F0 T# r8 i
13.         }
    5 \* t6 l; V& f; d( ]6 v* _2 t
14.     }
    
15.     return null;
    8 k) P9 O+ J8 M" ?
16. }

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

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

* H& o$ M) j1 ~/ m( SМетод addQuest(Quest quest)
) I$ i. |1 x6 C$ ]

1. /**
   
2. * Добавляет новый квест.
   1 y8 P* W% w1 o2 T2 q
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   % K; _: m5 A( g  W/ y
8.     {
   1 i2 X1 X( {3 a+ X
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   7 a3 O) I) g6 J# d! Y" t' M+ a
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    & |' ?7 d, R8 E8 ~& ~# D" _
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    & ?, @1 S. X! t* \; u5 c1 p# l+ }
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    # N* {1 Q9 a9 B- B/ C5 n4 S
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    6 m: \( Y7 R+ n5 D/ J' t8 `8 ~1 e* f1 ^
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    ( X( K" z% O5 k/ W& f
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
* C% J' U+ }( R$ |9 [" v8 lЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
. I+ H# _- ?% z4 p
5 s" g* P2 i  Z4 W" H) _
* Z4 O8 ]9 e2 L2 W" [6 l