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

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

0 S% L% O. ]  b9 c3 c" UРазбор файла QuestManager.java

1 l% b  i3 _" s9 {5 K: rЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
6 h$ e3 o( h$ n" Y) X. A/ v/ i( ^6 T+ i

• Лицензия
    @% b# x, y0 `
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  

/ g  p+ b& [+ i) DQuestManager.java — управление квестами и скриптами.
! ~$ T& x8 G4 W; z/ n" MПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

# w# s6 W1 c  v6 J
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
+ _8 k% m$ w" o5 V* I7 f  b1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   3 R) b3 H8 @+ c& F% _3 [
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   9 v4 H. `6 t; H3 h0 J7 X
8. * Эта программа распространяется в надежде, что она будет полезной,
   3 v1 E9 i7 x/ l5 o- q. @- D8 R
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    0 ^$ ~$ B8 a2 F' X, t7 C3 x
11. * См. GNU General Public License для получения более подробной информации.
    ( Q, b# N! l5 S& |- O6 a
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
2 t0 ~" I4 u2 U3 a6 C3 u2 V  x. a" J/ N
* f2 d+ W8 ]8 `7 J
; H* e( y- i; S  _2. Импортируемые библиотеки

$ o! b( x; q" A7 Q

1. package org.l2jmobius.gameserver.instancemanager;
   : b' J0 A5 c( l. d% p1 s. O
2. 
   7 {6 c- w% E$ ~) `7 E
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   3 Q. Z% D& \; C! O1 g  v! [
6. import java.util.logging.Logger;
   
7. 
   & @" ?" R& m/ @0 C" k# |
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 — менеджер для работы с игровыми скриптами.
" [& a& M+ z& ?7 L0 z1 c+ C
- [; x& a# A. [3. Описание класса QuestManager
6 x* o( @/ j/ Y5 F0 J- t7 _7 r# n

1. /**
   # J7 |9 q# z  r; S
2. * Менеджер квестов и скриптов.
   + b4 {% \9 ]; W. W! Z9 ~
3. * Автор: Zoey76
   ' z1 l! H9 y7 X% b+ e
4. */
   
5. public class QuestManager
   
6. {
   1 X5 S8 ~% }7 K9 e. C8 {( \# ^
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   6 t: i) t& J8 E2 g
8.    
   * r' D6 ?8 b* r: G* H
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
      h- U( g# ~: s
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
      x: o6 [9 h% P% F
13.    
    9 Q% N: D# g7 ^5 \0 C, h
14.     protected QuestManager()
    * A! _5 p5 w* z; V4 E
15.     {
    
16.     }
    ' l5 t& o  f7 e6 \# _& |& H
17. }

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

4. Методы
! ^9 Y  @# A6 uМетод reload(String questFolder)
7 o' G* z5 P  u& `5 N8 y6 S: b

1. public boolean reload(String questFolder)
   : i+ p/ p- ]$ m
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   . q4 T9 a- A0 S0 L" w+ y- U$ L) P
6.         return false;
   : Q0 P' {4 ?) U# \3 y( n
7.     }
   
8.     return q.reload();
   % x9 ]7 X( Q1 ~: g. k% L' p# O: g% F) L
9. }

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

5 z; ~) }% X8 q3 r- J7 P/ C! E
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
0 \' f' _7 R# h: K7 ?7 ^8 L9 IМетод reload(int questId)

1. /**
   
2. * Перезагружает квест по ID.
   # ?# Z# [6 I3 c6 W# c" u: C
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   - F  m. O! r6 {6 \$ v
5. */
   9 B! k" A8 x: N/ ~+ G4 ]
6. public boolean reload(int questId)
   
7. {
   9 |. ~" ?) N1 v& S7 O
8.     final Quest q = getQuest(questId);
   ; H+ c0 k% \+ S* j, S
9.     if (q == null)
     @3 R# I. v7 z* \6 l, L
10.     {
    
11.         return false;
    
12.     }
    4 S2 f3 \) S* U* m) c3 u
13.     return q.reload();
    , M. j% t! _/ h# A0 Y
14. }

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

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

Метод reloadAllScripts()
! T2 g8 R: l$ A* B& y

1. /**
   7 d9 E# v0 L4 a7 U4 M
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
     r! v9 o: h( I5 p; m, p
3. */
   4 P7 o4 q& c% ?) ?: f
4. public void reloadAllScripts()
   8 J& u' f/ }; T0 p2 g
5. {
   
6.     unloadAllScripts();
   ; c2 Y2 {# R6 H6 ^& Y  q
7.    
   * g* S3 X, O- [4 X' A9 M
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
     b2 n( Q# H+ u/ R' r% S
10.     {
    6 L' c+ G; p/ C8 j# v0 M1 E3 }
11.         ScriptEngineManager.getInstance().executeScriptList();
    ! R" ?- m: s4 B5 O, j2 e( a
12.     }
    
13.     catch (Exception e)
    0 W: e- \2 ?8 F; c+ R+ G& a4 ^
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    $ q5 U: }. C! j4 J4 k
17.    
    : G* k9 E8 N; j
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

! O; J0 g# a; {6 f3 }) ~6 k1 h* e

1. /**
   2 L, ^/ k+ r4 a& U9 m5 T% ]! i* f
2. * Выгружает все квесты и скрипты.
   
3. */
   5 u2 R3 O/ O1 M
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   & w5 x  i* [  I9 \# k# t
7.    
   
8.     // Выгрузка квестов.
   ; \! ~6 P; ~9 [' U( ~
9.     for (Quest quest : _quests.values())
   
10.     {
    # W# {2 Y; E5 E3 v4 V2 V4 K4 v1 y9 j
11.         if (quest != null)
    1 Z0 T4 R/ c8 b4 p5 A/ f0 e& b
12.         {
    
13.             quest.unload(false);
    
14.         }
    : ?! R8 V. o" `' v, n. S
15.     }
    . z* e, x/ d) L; \, o% U
16.     _quests.clear();
    1 z, |% Z% J( _
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    7 X) n! ]: }% s  r, S( o
19.     {
    
20.         if (script != null)
    
21.         {
    ) l# [3 s: g- W0 q6 S
22.             script.unload(false);
    $ Q3 u1 F, O  v7 _- n5 |3 G  z
23.         }
    
24.     }
    
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  2 ]% ]1 t8 O" ?/ F

Метод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   " e" V0 d) a! A, Y/ J7 Q
3. */
   
4. public void report()
   ) `6 i4 L+ I7 V5 A7 u
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   & O0 o: ]( B1 i9 m% l
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   ( P/ q1 `8 `; M8 Z
8. }

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

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

Метод getQuest(String name)

% ?0 T, t# O9 b/ k- T/ M4 a

1. /**
   ; B# F, k3 r4 _! C. b  Z8 h1 d& w
2. * Получает квест по имени.
   
3. * @param name имя квеста
   ! D8 q' y" a, d" B; ?: Y; l, C0 C' ~
4. * @return квест
   ' J8 M1 {5 N$ J7 F/ D: \
5. */
   8 `5 _$ V" F4 T9 j0 d" U& O
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
     n, g5 j9 g( n9 [) |* h+ ^: R1 ?
9.     {
   
10.         return _quests.get(name);
    3 T. l9 y/ {! |
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

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

" ]0 l: ^2 @" Y  y: @" ?7 o. ]Метод getQuest(int questId)

; e" j* @' x9 i4 n

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   - z+ w; n7 k1 E; v8 c  x
7. {
   " h" |" t3 ?7 x  a  T
8.     for (Quest q : _quests.values())
   
9.     {
   ( e  J6 T# g1 }
10.         if (q.getId() == questId)
    
11.         {
    8 d1 ~! ~) @) D4 l3 \5 L
12.             return q;
    * d5 L, s/ u3 ]3 Z  R
13.         }
    3 d/ @$ \4 w- Q6 N9 }; w9 T: E! `4 `
14.     }
    2 ]5 u. I' E; h( \! |6 d" W& P
15.     return null;
    5 Q# e. L' d7 W! q- G- V! @
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  4 m6 u5 H9 F) D# }" k& t

. R) b. t0 u+ A/ D1 e9 J  uМетод addQuest(Quest quest)

1. /**
   # M( _; X& j" f+ M% x: q, V+ H
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   5 e5 F3 l: ?# l6 X
7.     if (quest == null)
   0 Q7 P3 g1 E5 B- Z0 S0 N& w$ b
8.     {
   1 d6 R$ D: i2 C
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   % F: `( {. N  J$ p3 x
10.     }
    
11.    
    6 \% R7 T5 C( d
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    5 [& k: ~2 a+ {; R
14.     {
    
15.         old.unload();
    . s- _) D( l1 d+ g& V7 [) L
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    $ \! U6 Y- {' h+ M5 s
18.    
    8 |+ |/ [2 u" M9 C
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    ! a! u5 z7 ]- Z! [: _
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
# W. X- o5 l# L8 z% U
6 X, ^0 @+ }1 u& V4 k; u
2 l3 q2 P  v* C