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

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

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

' v, x  e- ^9 }4 yЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

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

. o+ H9 Q( n+ G& z9 \9 h6 N# u8 GQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
8 l$ h  ^& ~) X5 d8 k- r
5 ~: `/ g! N7 Y5 z
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
" p+ Y( L/ U/ i# j, M

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   . _( o2 E1 M2 k
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   : K2 P' h6 z3 O" F+ Z& J
7. *
   " F( o: n% v7 z; C
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
      v/ n6 ~$ p, }; e
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
      _6 K' H3 |+ l2 q1 H
13. * Вы должны были получить копию GNU General Public License
    % n- ^# n1 k# ^' C0 @# b+ S
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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

+ }6 K6 s- u5 {: a
/ L" N5 s( j- f2 s2. Импортируемые библиотеки
5 g; i0 F9 {. _& d

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   1 g, f# d$ W7 _* M& l, a2 h* ~  r
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   1 v8 `- K% q% x" J1 e
8. import org.l2jmobius.Config;
   " H8 s" i' V; F( E9 K" k
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 — менеджер для работы с игровыми скриптами.
- ^$ q. C) M; C* E) t( [& V
3. Описание класса QuestManager
4 [' C2 M' H- O- S- B

1. /**
   : e$ e* ^# E" y* c0 y; g  \
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   8 {# O8 m- y! m- {6 V7 K1 _
4. */
   , M5 T$ C, W4 {% M6 O
5. public class QuestManager
   
6. {
   # n3 H4 B" h: Q# [. E( ^) e  |
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   ; q. L3 n* Z2 Z8 _! A. [
8.    
   6 `: a& E& c2 u6 z6 v
9.     /** Карта, содержащая все квесты. */
   ) k' W0 K8 t8 n( l+ ?
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    & h; @3 ?7 y2 t" p6 a# N+ u- G
11.     /** Карта, содержащая все скрипты. */
    2 g8 v6 d2 n( x) e/ J  N( h
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    6 E' N  ]4 G% ]: Y$ g
15.     {
    4 l) ~% n( A. v. R3 ~9 C
16.     }
    % o5 {' d% R- n* Z) U) L0 v
17. }

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

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

1. public boolean reload(String questFolder)
   + n) d4 D% S- O- R% j  T
2. {
   & L, a; G9 @" c: `! T
3.     final Quest q = getQuest(questFolder);
   * w3 N& o; C7 l
4.     if (q == null)
   7 O1 d% z6 E1 ]% A5 O
5.     {
   
6.         return false;
   
7.     }
   
8.     return q.reload();
   
9. }

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

2 w* z( {2 {- I/ b/ Z  Z, Z2 j: j7 u
9 |5 D7 N5 d5 Z: aМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
3 j; J3 h  x% @8 S

1. /**
   ' e+ j! W$ c- E6 O
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   , L+ P0 p) S4 j# X9 O; o9 N
5. */
   ! A( b$ @' o3 y% F2 \: {7 i' v/ e
6. public boolean reload(int questId)
   1 w1 {9 m- T" T; r7 J& H
7. {
   & T: J0 i4 J: m* a( G
8.     final Quest q = getQuest(questId);
   $ u/ m8 T" u! S  J# X  _5 l
9.     if (q == null)
   
10.     {
    
11.         return false;
    
12.     }
    " i5 K) e. I' f4 r! C1 ?
13.     return q.reload();
    
14. }

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

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

Метод reloadAllScripts()

/ M' @3 E+ Z+ s2 z

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   6 O; c: o- y( D& j* ?
3. */
   0 k& I* W& Z) o8 s# g
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   # S! H) f  U1 j* j% J
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   6 V: p7 K  W' H# \1 R$ W
10.     {
    8 x0 v  P2 s- [- `( R
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    
14.     {
    . f6 n# b7 ~" q: A& d" S1 A  P6 }
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    . W! i- v/ m* K9 n5 }
16.     }
    
17.    
    ; E% p3 n" D, v  B& T# c
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

5 I' b8 c/ T9 Y- J, d. t' \

1. /**
   
2. * Выгружает все квесты и скрипты.
   9 k2 e* ], J( {# b/ R8 V0 \
3. */
   8 c8 x% a0 }$ S5 V
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   ) C. s6 s4 Z4 A9 ?% b
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    4 D5 F' H# B9 ~4 W" m6 ?- h' t
12.         {
    4 w: o7 J2 t% y# q" V! @, G0 X0 X' Z
13.             quest.unload(false);
    - r3 m3 n$ a. W3 \* n. S; [
14.         }
    6 J* D' z& `2 e% q7 H
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    8 N7 l" e* s  C
19.     {
    7 B; L, _0 I0 h9 k5 o# P
20.         if (script != null)
    
21.         {
    3 d  Y. C& K* N% C
22.             script.unload(false);
    6 w6 p/ j7 N: Y3 i
23.         }
    ! v& x7 V; S  z. |  R& K3 g
24.     }
    - u, L  a. S$ k5 U0 a
25.     _scripts.clear();
    % w1 Q) }) \! k' o0 ?; f
26. }

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

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

' C3 q+ `; {: J0 C) `3 G$ nМетод report()
  s" I+ n" i1 N2 P7 I* h' {7 x
- T7 ]# ?+ ^/ }9 l( S0 i& D% g

1. /**
   / z2 }( ^& L  n6 E1 V! b
2. * Логирует количество загруженных квестов и скриптов.
   5 q% J$ g8 |* R6 |% v
3. */
   3 a4 x5 L$ P( }- C9 m
4. public void report()
   6 d& t6 l% a0 N
5. {
   $ j# n0 h$ Z! @+ k# n$ |# V
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   . X* J2 i5 q1 t
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   6 X) o$ x1 {, n7 H$ n& D9 a% t
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  : l$ L; {' t7 {+ |  f

" ^# @) ^0 {: V, `" ZМетод getQuest(String name)
& {6 Q3 u8 o; h( F6 t. Y! P& {5 B5 R

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   & x( x9 f' b. U" {
5. */
   , ~7 a$ z3 t' p  \3 C1 F
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   8 H) Y* O4 x5 }+ ~' M" g
9.     {
   
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  1 q% G. N  s/ \+ ~

Метод getQuest(int questId)

+ Q. m% U! O( W' u& Q% G. I

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   9 O; z. ^1 H, n. Z
6. public Quest getQuest(int questId)
   8 s% Q$ y* v2 a. g
7. {
   
8.     for (Quest q : _quests.values())
   . }' i9 o4 p& C; P
9.     {
   / l3 ~! P. L  R  _1 ], A
10.         if (q.getId() == questId)
      k3 X" X: b' X+ {, p* l( b& f+ p
11.         {
    6 F3 t- T6 h9 \2 i$ b+ Q
12.             return q;
    + D& ~- p' q' n4 q8 a: G0 A
13.         }
    - v. f" Z) `( U9 v2 y
14.     }
    ( f% v$ U6 [9 P3 X7 `) S4 L( x  `
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  ' R. A" E* ^" k! _+ h) u( p8 t

# r' x4 t) ^  ^  d( {  bМетод addQuest(Quest quest)
- n2 a9 C' Y( l
  o, P* Y; M5 W# e$ a( Y! w

1. /**
   
2. * Добавляет новый квест.
   ' _3 S9 o+ X/ ?! v( k( D4 z- n& @
3. * @param quest квест для добавления
   
4. */
   : G, v* ]* c: p8 R
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   0 }' l. _  f- K- G
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    4 c( M* P' [. |3 j4 w
13.     if (old != null)
    
14.     {
    / {& V2 q. ?# T4 j" P
15.         old.unload();
    * O& O; D9 k" X% P. m& J8 e2 S+ q
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    / }' P6 \( m4 \9 K7 H2 W% y
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    5 m0 H- V2 r. g  T" n
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    8 y8 r4 R; K- X* j0 N, T
24. }
    
25. ``

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

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

& r, l2 U: G5 }0 U$ @