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

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

Разбор файла QuestManager.java
9 }7 O5 k" |2 I% U0 z
Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    ' u3 [1 z. X% b3 r2 ^
• Импорты
  ; t7 v( [" H4 h5 P6 x) `

QuestManager.java — управление квестами и скриптами.
3 s: B2 H# F  \6 }3 c9 YПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

2 J- n; E% [0 A* \0 K2 v
; x& n7 [+ Y; T+ V$ MДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
- o9 n: a/ {- e  ^$ }+ R' ?1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   8 O/ c! H; v; J4 B
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   & n* z! Q; U- Z" }8 n5 o5 p% \
7. *
   ! R' [6 m$ M4 u& N
8. * Эта программа распространяется в надежде, что она будет полезной,
   + L% [# V' T3 e8 X
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   - j: P% M) e7 V  K! I! F$ G
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    # g* F9 b# N, {- N
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
5 J' |  _" e5 d. \! g7 y$ p
+ P9 b0 R" V! G0 o7 ~) T1 F
9 x# b: E6 D  F4 P: }7 {2. Импортируемые библиотеки
& k% @" r; @& T# K

1. package org.l2jmobius.gameserver.instancemanager;
   , r( M! ~" w$ w9 h
2. 
   , b' i1 e( p9 f2 Y
3. import java.util.Map;
   + \1 l, D0 ^; t  g4 ]0 T  d
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   + h! c+ y! B, ?$ \0 y5 n, `
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    4 `$ y- g! d: l1 {' }
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 _- C: _) w, u! ]/ O' c
3. Описание класса QuestManager

1. /**
   5 ~$ G. t0 M9 y8 S, J/ {" e4 r
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   ; R# q4 o& f& }6 r
4. */
   
5. public class QuestManager
   9 R, Z; b+ {; ]
6. {
   ) B) v! Y# {! V! }1 N
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
     z( T% X0 H+ f8 I1 J* S3 a2 p3 m
8.    
   
9.     /** Карта, содержащая все квесты. */
   ; I; X8 Y* u( M; z  L
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    0 b( j% Q/ ?/ C
11.     /** Карта, содержащая все скрипты. */
    # |/ K4 G4 y, f% {) m; u
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    * x+ m+ p1 y4 o# B7 i
14.     protected QuestManager()
    
15.     {
    5 B, v- w- c8 F) c' D- v2 u4 T
16.     }
    
17. }

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

4. Методы
Метод reload(String questFolder)
4 v4 Y! R. F- B+ [% ~: ?

1. public boolean reload(String questFolder)
   
2. {
   ! r( E! C7 M% w. x; i  u
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   2 t  W: k  d& S5 ?/ R
5.     {
   
6.         return false;
   6 p. y( h& G) }! g
7.     }
   7 C4 K$ M9 h9 `& O
8.     return q.reload();
   
9. }

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

5 h) z& Z: t, m* K) T. u. {* M
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
4 g/ z  g- I! f

1. /**
   , S3 s0 ]) z$ Y$ \
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   1 J$ A3 X& T+ d
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   2 i4 P5 m" C/ h. Q* I
10.     {
    
11.         return false;
    
12.     }
    4 \$ s+ p! i& X3 S0 B7 F6 z
13.     return q.reload();
    , g. V" _; q3 a; w. r/ q
14. }

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

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

( ?$ e1 G* [5 V- dМетод reloadAllScripts()
( y+ y! R8 v; L/ w- W& K

1. /**
   3 j- ~1 ]. @) T! B& G
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   5 g% C6 {* b: a* F) \1 k, k+ \
4. public void reloadAllScripts()
   
5. {
   , {; ?' T: H# r0 ^+ [# R
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   ) q6 n8 k1 F, D2 x, M# C
9.     try
   ) z1 b/ x1 @- X' I1 s1 E" }% v! d
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    6 Y) T+ z/ Y5 C; ~
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    ; h* h% l0 L6 u) G3 n4 E& D
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()
0 K  T9 G5 N* t4 }

1. /**
   6 A3 o! G4 E, H3 V/ F% B3 \
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   $ u5 G/ P+ E) f: l
5. {
   : p8 |! x7 j6 g$ e/ J3 Y2 w
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   ( f( j% l) l( F0 A
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    " [) c7 a' u* C* A% g
12.         {
    8 E4 Q- S+ F' e1 f' J/ n/ n
13.             quest.unload(false);
    6 e3 B3 b- e- o$ ^3 x- y" z
14.         }
    ( |) q5 h7 {7 @, [
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    " C8 c) `8 x1 [1 @5 ]- _
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    
23.         }
    
24.     }
    
25.     _scripts.clear();
    4 Z! ~3 q  g  }* k! P# x
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
    z8 W/ `6 w0 ]8 E- N

/ V  z8 C+ i4 b) lМетод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   * _0 c$ b& t9 R8 r/ L
3. */
   
4. public void report()
   
5. {
   ! K" x4 b$ ^, ^, |3 ?
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   ; z+ ^7 r" z: V+ N! R6 z7 A
8. }

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

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

Метод getQuest(String name)
7 D3 y! H5 q: F$ e( S+ H
. ~  \2 C% W& U( `. Q

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   : V# T  c. V6 t$ ^* N
6. public Quest getQuest(String name)
   
7. {
   5 I0 @$ o; _+ X2 w
8.     if (_quests.containsKey(name))
   
9.     {
   % {5 f9 A9 _; g; I
10.         return _quests.get(name);
    
11.     }
    + n+ M0 b" K4 G% W" h: ^
12.     return _scripts.get(name);
    # X6 B- V7 q9 c& [& K5 x; g. J; M
13. }

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

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

5 }' t" N: B. ^; k7 a, V- o4 t8 MМетод getQuest(int questId)

( z# A3 ?6 c* `4 C

1. /**
   ! D* X. x0 P% P/ c5 ?% E
2. * Получает квест по ID.
   ) Y, p3 s7 f9 w1 N8 o4 T
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   ( C5 v' o" O/ k
5. */
   : H: j7 t$ \$ C" m3 T
6. public Quest getQuest(int questId)
   ; j. ~- z6 F2 z. m8 |$ F: @
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    7 W6 [3 s0 J1 K+ F! w
12.             return q;
    2 v5 [' n7 n* g8 h
13.         }
    
14.     }
    
15.     return null;
    ' G9 P& \% f/ X' G- K2 e
16. }

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

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

Метод addQuest(Quest quest)
' J/ F" f# V: z& Y7 C
) a  i7 J/ z% s8 [2 F

1. /**
   ' X1 z5 ^* {( Q
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
     p9 u, C. r6 g! A0 q
4. */
   ; w; d, w( e5 J0 T" Y
5. public void addQuest(Quest quest)
   
6. {
   1 f: e) W& T. g
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   " U0 K( F6 J2 b% [( m% B
10.     }
    
11.    
    + P. t9 h2 \, {" o5 [1 M
12.     final Quest old = _quests.put(quest.getName(), quest);
    $ e; O5 v* W6 W4 X& a
13.     if (old != null)
    9 T. {! ]- o/ D0 H5 T
14.     {
    $ L2 L" h; V! t* m2 P, r- f
15.         old.unload();
    5 C5 m; D4 o+ D7 k" l2 M# v+ F
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    $ A1 U2 M; r  [$ D2 |
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    / c) f8 M; d0 T
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    6 v( w7 }: J' ^3 x) n: X
23.     }
    
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
5 C6 W0 d5 }2 V( \! F( D, v! \


5 p+ P+ N& k' s; K; y6 g