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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
( N( O# A! S$ Q8 V5 x
1 R/ T; V8 c4 I5 d. A9 _Разбор файла QuestManager.java
& k. k. d) [0 D8 f% W: b2 N
( `5 L5 O9 B0 p( v8 [' y& w+ W& MЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
6 f; ]( ~8 z( j/ V3 e$ x3 b# g8 j0 i+ r8 DОсновные элементы

• Лицензия
  8 q3 I( p- y2 T) N
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  1 n) S4 m' W2 V2 F5 j

QuestManager.java — управление квестами и скриптами.
( A/ J, s2 A" v4 c3 {4 Y7 TПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

& k6 `3 Z: {% m3 y1 D% V
" s8 Y/ V  u5 d# n& {Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
/ B. ?+ |, a+ @7 r% y$ k1. Лицензионное соглашение

1. /*
   8 G6 N+ M, l, E; O9 J0 J
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   . l( Y* N  F( N% H/ ^- S2 N3 Z8 C8 `
5. * её в соответствии с условиями GNU General Public License, опубликованной
   ( H" H. Q: s; ~' D: G
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   7 q1 O5 b+ W7 ~6 N
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   8 |( ^5 x- m( f; b8 G  S
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    : j: y( D9 O* W: x
11. * См. GNU General Public License для получения более подробной информации.
    ; Y  |* X6 t. b7 F# F) ?" W
12. *
    
13. * Вы должны были получить копию GNU General Public License
    , K! T0 z3 q  p& m* c+ R, T5 h' S
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    0 k) Y$ a: [; ?( x2 V: W& q
15. */

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

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

2 w$ m0 w, Y3 r, y
7 v$ n- S5 a  a0 A0 G$ l2. Импортируемые библиотеки
: `. u: H' O/ z- }. X8 s2 N# M

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   0 R. R3 S: n6 f! ?* R
3. import java.util.Map;
   3 ~( L6 w, r: \4 r2 k
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   4 }, ^1 Q' d, y/ ~' x2 c* x# a8 w
6. import java.util.logging.Logger;
   3 U/ ?* q  ]7 ?8 l
7. 
   
8. import org.l2jmobius.Config;
   
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 — менеджер для работы с игровыми скриптами.

7 T9 ]9 S% {  _, }3. Описание класса QuestManager

1. /**
   / H. j1 E( P2 T# [
2. * Менеджер квестов и скриптов.
   2 V/ v' c1 h* f: j/ \
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   
6. {
   9 ]! H7 a  _  q3 ^: |/ T
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   1 O$ m9 k" Q3 B% A8 j' s0 q# C
9.     /** Карта, содержащая все квесты. */
   2 z# w  S0 _' o- g6 s% _8 q
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    - b0 a" Z% x0 m- c
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    " J8 I0 v4 [; \! ]6 s, Q6 x/ D
15.     {
    
16.     }
    
17. }

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

4. Методы
4 h9 f* a2 J; `/ C% KМетод reload(String questFolder)
. h2 B$ n! D4 y

1. public boolean reload(String questFolder)
   9 N. J/ y; {+ M( k4 P! p9 P
2. {
   $ T2 h8 \! f2 D0 ^& \$ I
3.     final Quest q = getQuest(questFolder);
     C4 D" ?' ]: \" M  g
4.     if (q == null)
   8 A! F/ G8 n, J% c' h4 w
5.     {
   ' r; t/ |" T  }: }3 n
6.         return false;
   " P) f5 i& N3 `$ W) J% u; ^
7.     }
   - _1 p* R, r) [  a6 h8 E
8.     return q.reload();
   
9. }

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

9 q  k0 S! A( z; N( H0 ~! w
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
; U; r% s( J, w& p7 I4 dМетод reload(int questId)
4 l. S- \0 w% x6 s2 g) K
5 {0 H9 P3 m1 ~: N% x1 X' c

1. /**
   
2. * Перезагружает квест по ID.
   6 v1 A5 k; X- Z8 F
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   3 J2 G; g$ h$ P; V
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   8 q5 K; L: S2 @" [0 T. W
10.     {
    
11.         return false;
    ) l  a  u2 T+ a# r
12.     }
    
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  5 x7 M" _/ `) n; K- ?# N

9 a9 e; G  M9 gМетод reloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   
7.    
   0 v9 g& ^  ?5 D; Y9 h' t, g
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    6 O) L! {# ^6 U$ K" r
18.     getInstance().report();
    * ]2 C) y+ Z$ N0 W5 U
19. }

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

Метод unloadAllScripts()
+ B9 H2 ]" v# H

1. /**
   ( m: V) W5 k! u+ L* w2 @% P
2. * Выгружает все квесты и скрипты.
   6 g) a0 T0 J; ^% E: s, Y2 q
3. */
   
4. public void unloadAllScripts()
   ( `% S+ c6 C* v7 [& w( i; C
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   4 a5 I: W+ d% B. E9 d3 Q. I
10.     {
    
11.         if (quest != null)
    
12.         {
    ' W& m1 B9 I( O: {4 z
13.             quest.unload(false);
    
14.         }
    
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
      \5 q: ?' y0 _5 s% Y
18.     for (Quest script : _scripts.values())
    , c. N% k- k' ]* j
19.     {
    
20.         if (script != null)
    
21.         {
    4 W6 e5 J5 @: B) G
22.             script.unload(false);
    
23.         }
    $ p: n: p' c3 U0 D+ B
24.     }
    
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  " Z% ?9 D: Q/ H5 W* V  s5 V! U9 n

4 w/ }* P* l) p2 e4 I  P; }7 o2 fМетод report()

% m9 P- I9 O+ F# ]% M$ |

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   ; {! W* x$ v4 y: m
4. public void report()
   
5. {
   - Y# |; `2 L% c. [2 }5 ~
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   4 f# ^5 t% }& C' a8 T
8. }

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

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

: ^% O( E$ ~, b9 nМетод getQuest(String name)
  ?3 T7 S' v. [( h

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   % x, E( t, k, E1 y" ]% B* ]9 O4 v
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    + l7 F6 ]& p) n6 Q1 K% x
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

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

- y# a# m, ?( [: Q1 ]7 X8 VМетод getQuest(int questId)

1. /**
   
2. * Получает квест по ID.
   4 u1 v$ c; E9 h2 ^
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   $ ~+ P: X5 `- a* E( B" B( V- X  g! O
5. */
   
6. public Quest getQuest(int questId)
   / D7 t3 V! _7 r+ W0 g
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    
16. }

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

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

Метод addQuest(Quest quest)

) z5 ?" j8 S, f: B; a& w, v

1. /**
   ! h0 C- n7 f) M: J6 Q
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   # N- t; H  H) |9 w9 {
4. */
   
5. public void addQuest(Quest quest)
   1 H- Y4 @8 Q( L( I
6. {
   
7.     if (quest == null)
   % ^* r( Y. K( Y7 F/ d6 h
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    4 F$ x4 C8 Y8 G; `7 H
14.     {
    + S0 a/ ^  [, v/ P+ z$ A3 }
15.         old.unload();
    5 I9 @  {+ `3 K0 }' f  ?3 b
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    ) L( a3 U2 ?8 \! t
20.     {
    8 N: [2 H3 h8 R1 ?" N8 u
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    " y9 h. Z9 q! j& I
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    & F4 u  D; T8 |" J3 `4 P& l
25. ``

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

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

+ z( V6 j# Z+ z- o" r3 a' k

" n. T# K6 r2 D: {7 g