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

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

Разбор файла QuestManager.java

5 V# y7 O. V; w- I) Z% V2 [, ]Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

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

QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
0 |  M+ E1 ], m

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

1. /*
   + n, |8 o8 w  {+ [) Q  @
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    & q0 c  [& E+ G2 u
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    + X7 u8 Q7 y5 g3 f% o1 _. T
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    - H! E' Q6 Q; P; `) t4 O" J
15. */

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

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


" m/ x) @  T/ E* @4 ]2. Импортируемые библиотеки

* R6 o& |+ x% h1 L" X5 F; @+ V

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   : o6 w5 U) f8 C6 Y. `
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   8 k$ \6 c& b; q0 A
5. import java.util.logging.Level;
   % s$ l3 S: k' x- _7 z% C. |. W
6. import java.util.logging.Logger;
   4 F* v# h- S9 G
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   # v3 v7 e% I. C5 |" ?- F" K
10. import org.l2jmobius.gameserver.model.quest.Quest;
    $ A  m$ V3 u% [8 X1 Z
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
# w$ ^, j! a- n, U& r7 i

1. /**
   
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   3 c+ o  f+ [4 p% B3 e
4. */
   
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
     u" E+ T/ O/ X
8.    
   & d* s5 r( p2 p  \) j8 t
9.     /** Карта, содержащая все квесты. */
   ( }0 {' I. n) z+ ]8 h* L+ @
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    ( F$ t- M# b# B# ?
11.     /** Карта, содержащая все скрипты. */
    1 A( X/ A8 q8 i# E- P) k
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    : F/ r7 [6 g9 Z& r! Z3 M
13.    
    7 i% Z/ S- M: D+ ^, k- p3 H
14.     protected QuestManager()
    
15.     {
    
16.     }
    / p3 F+ ?, e2 T9 D1 _- i/ W
17. }

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

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

1. public boolean reload(String questFolder)
   9 K9 Q$ N; S# R* t+ p: q
2. {
   % c4 |" N/ B- Y3 l* R1 p
3.     final Quest q = getQuest(questFolder);
   - P- V7 X! D3 ~( O
4.     if (q == null)
   
5.     {
   
6.         return false;
   3 @0 F6 S: @. N
7.     }
   0 v! Q1 @! F' s1 N8 K" c
8.     return q.reload();
   
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
& B& N7 v3 E9 T9 Y2 R
9 {: L4 C7 D0 {$ j" A

1. /**
   ; `2 N/ e( }, O& w4 X# _" R- p: ?
2. * Перезагружает квест по ID.
   ! N* j! ^3 a% {: `7 B' S3 S
3. * @param questId ID квеста для перезагрузки
   5 z! k2 }  \1 l2 n. ~8 u
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   ( o9 ^5 y* r: l3 z  E1 h
7. {
   $ f) z+ `! L6 K- }, r+ R# _, ]
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   * S' G' I: N, E: h7 r
10.     {
    2 |( {" }+ L# t$ D. |4 N. e/ o
11.         return false;
    3 f/ C; u) W3 `
12.     }
    
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  + F( ^! \% O* j  q  H! s7 F

7 g4 y* |- K! U7 w; ~Метод reloadAllScripts()

% p. v* J* c% b# C4 b% K" _

1. /**
   $ C; e% C- G/ \, N7 E0 J; x
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   3 v: Q& i+ z" @7 o3 \1 \
3. */
   
4. public void reloadAllScripts()
   / F: c: E; \. ]$ R- z; Y$ E! S: z: o
5. {
     M/ p$ C- s3 k& A6 b. r0 L: i
6.     unloadAllScripts();
   4 I/ f: ~' M4 Y- V. E+ m6 V
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    / q. d; ^" t4 r  M7 ]$ ~* @
12.     }
    
13.     catch (Exception e)
    - A4 l' M% p) e  d' s4 k- {- u& ~
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    
18.     getInstance().report();
    ! t& V$ s3 q! J6 ]% i- X2 f. v
19. }

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

Метод unloadAllScripts()

: Y5 o3 L+ ^: V5 d( g* n

1. /**
   5 R, B3 |4 W3 o; N! |! K
2. * Выгружает все квесты и скрипты.
   2 F1 a7 d% n$ e5 ]( Z1 L4 M
3. */
   * c1 B5 {! m6 Y0 k- ?
4. public void unloadAllScripts()
   # m1 y8 A+ {& S
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   - V; W% z+ y8 N) A$ T8 q) j
7.    
   
8.     // Выгрузка квестов.
   9 C' v6 R, x: [& |+ @2 A
9.     for (Quest quest : _quests.values())
   7 T% m* G: d9 O9 f: f
10.     {
    
11.         if (quest != null)
    6 ^; U( }# {; V& C+ W
12.         {
    + ?6 L5 d; u( u! e$ L
13.             quest.unload(false);
    " v' y, S  @; ~. J2 o, j
14.         }
    * \- D- H' }# ]! \. `- n7 a7 F
15.     }
    
16.     _quests.clear();
    5 C0 {  [4 ^- \7 ?& V, h
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    " X+ `4 @' l0 k0 l
23.         }
    
24.     }
    
25.     _scripts.clear();
      R) i; R' [: J; N0 M; x' J3 ?
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ! V; G, f0 \' N& |6 z% ~5 c

Метод report()

4 \# j& s: g4 w+ T* u

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   8 M' n. M& ?, u
3. */
   
4. public void report()
   
5. {
   6 L+ c4 Z5 h; d' N. l8 \' @4 [
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   0 O8 o; i  ?" r; y- ?
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   . ~/ \2 Z$ `$ ?7 o" D
8. }

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

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

+ D/ c/ n/ G3 n) r$ y( n& j# z3 mМетод getQuest(String name)

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   0 r4 b" t2 D# t7 C/ z
5. */
   / h1 F8 g, t/ c. s; S
6. public Quest getQuest(String name)
   # [& R$ Y' m; f5 `3 l
7. {
   5 S! j; E- [* j. G! B: n
8.     if (_quests.containsKey(name))
   6 f  s# Z) J9 n! K$ Z1 |* f
9.     {
   ) A4 R+ o  T  S5 b  ?4 O/ p
10.         return _quests.get(name);
    
11.     }
    % P7 m- u2 o. z: d% r5 {
12.     return _scripts.get(name);
    
13. }

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

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

Метод getQuest(int questId)
  Y- M/ \- B. K! n4 h3 r

1. /**
   + i" \( ?/ M/ H" \: x/ q6 t, Y0 [
2. * Получает квест по ID.
   ) M& d+ B/ Y# D- H9 A
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   3 j8 e4 H4 J2 g, |
5. */
   
6. public Quest getQuest(int questId)
   4 f9 ?0 `. Q0 B  G/ t
7. {
   6 D& M$ n& @9 h
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    7 c& _, L3 K4 ]6 w
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    5 {) n& s+ s! t" o3 A& s
16. }

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

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

Метод addQuest(Quest quest)
+ D" G8 N- L2 [0 q9 v% }7 X/ Y
3 j8 n# H$ D) M- K, h6 |7 a

1. /**
   + g' }9 Q) Z# G7 O. O
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   ( Y6 m3 \0 J3 w4 e
6. {
   
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    6 a) [4 Y, m5 E1 j* M+ D' h7 C- H
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    % t5 y! f) E. B) l4 O% @
14.     {
    
15.         old.unload();
    9 r1 }* U1 e8 g5 |
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    ( B$ C. Z# ^) d' @% ]9 Q  x- w
17.     }
    : @. m5 l+ {$ Z, }8 U  t
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    & C, \! _" |0 c3 W
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    9 d; P( V  i2 a* Y
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    / G% i4 C1 g9 b3 @# I( ^6 P
25. ``

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

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

0 Z) o# f% O7 S; @+ _4 l) S; T8 T

/ b  m8 C0 \' ~/ x- f