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

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

" y2 L- M1 k) [# ZРазбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
  J3 @; l- q9 s

• Лицензия
  ' o. ~- B5 U1 \& X
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  

6 _/ q! F4 l: O- nQuestManager.java — управление квестами и скриптами.
0 E- @7 ?+ u0 jПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\


Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
! y% R$ z* q! ]  h- I1. Лицензионное соглашение
; m) G% z5 v+ [

1. /*
   % z8 q1 W( x/ G4 N2 ^3 \0 S- y" c
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   ) o% Z4 J% L/ r' z% q
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   / ]3 d0 g& b9 F, H' \- W1 Q) @
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   & V1 O4 U' _  b$ Q) ]3 P
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   : A0 p/ S0 s: u, Z
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   ' _' T  f, X7 L* W
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
      g. I! w- R& c$ V; {
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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

! U$ e9 v9 Q$ z6 W2 O$ \
' J+ L% ~) `' T: L9 k8 {2. Импортируемые библиотеки
; [! `3 r' P" y7 [( e) a, @# {
  x7 K: j; X0 R3 N4 V

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   ; `$ d0 q: y+ P
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   : T5 t) s6 [& Q! Z/ ]8 }3 [
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   , M1 K! \, d' T2 ?
10. import org.l2jmobius.gameserver.model.quest.Quest;
    ) A& a7 w- h& F5 x
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 — менеджер для работы с игровыми скриптами.
1 w& f# m; R! r2 B4 n7 f
6 {: t2 K: {6 N; W0 p3 P4 \+ {3. Описание класса QuestManager
) V5 _9 Y9 d7 P4 X. z# |, g4 v

1. /**
   
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   ! J# O: @0 ?( U5 Y% O
6. {
   ; l( k% |4 I, g  i
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   0 Z. W- b5 m0 V8 ]3 g
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    0 Z8 m" }  Z  G: w" j' o( f
11.     /** Карта, содержащая все скрипты. */
    0 F- i% S% U$ i. S
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    
15.     {
    
16.     }
    8 A" s4 v' h8 y2 ]# S
17. }

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

4. Методы
. q' p( L" @! m* J/ \$ {( u, IМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   ) M- g$ T  m# V, J) O2 Z
2. {
   
3.     final Quest q = getQuest(questFolder);
   ; X  F0 q: N. j7 I3 |
4.     if (q == null)
   
5.     {
   
6.         return false;
   
7.     }
   
8.     return q.reload();
   
9. }

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

' Q1 @7 C) j6 l. ?. X- C
9 |. O* R( Q; N+ \1 `Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

1. /**
   ( b" V' b: |( U# W7 |' r
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   " V7 @# _+ A0 P) ]0 m" \  G) D: W8 f
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   $ i0 {  M8 m8 m9 t: Q
9.     if (q == null)
   / C- h0 K, ?2 {% D. _1 E9 m! [  x
10.     {
    
11.         return false;
    + y1 v+ V4 C& h0 X' t" R
12.     }
    
13.     return q.reload();
    ! e! {9 z7 {( |0 L
14. }

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

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

Метод reloadAllScripts()
2 c1 |1 J  U* U: m

1. /**
   2 J) e7 q( C* U% Z" U9 j% `
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   
7.    
   4 g1 F0 P, Z9 e  M
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    
18.     getInstance().report();
    5 J9 y/ D/ S% T  S  N2 _3 n
19. }

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

Метод unloadAllScripts()
4 ], T% O( h; Q( h# q) S! d5 e
7 [* i& c7 u; `* `1 a' A4 w" O

1. /**
   ; R; y# n- K+ P
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   
5. {
   - e4 Q7 N2 r2 j, }: ~/ r5 ^; [
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   , M5 k' [$ F, w/ v, _2 I0 T* ~
7.    
   
8.     // Выгрузка квестов.
   ; c& y- b% i7 P6 E7 c
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    4 F7 P8 x! G- V- V0 y5 z
14.         }
    * M; d$ s3 w. R& f; \# ~
15.     }
    ! h" n% ]/ V: h1 i/ B. B- l% c
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    " C# ^( e: [3 i" u
19.     {
      b# P* |5 ~* |  d8 B; }* d
20.         if (script != null)
    ( D) {, o$ C. T
21.         {
    ) L( t  [) A( Z9 I- y2 [" Y
22.             script.unload(false);
    
23.         }
    
24.     }
    
25.     _scripts.clear();
    ( X* R) l! E) n
26. }

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

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

9 E4 d: o- t( `7 s! o7 Q% kМетод report()
2 P3 n3 ^; d. X# p. f$ o

1. /**
   4 c# [2 @! N  ]
2. * Логирует количество загруженных квестов и скриптов.
   ( T5 ~9 C* H/ n
3. */
   1 o+ u- i! E1 T
4. public void report()
   ; H7 k% d/ P& N
5. {
   # D# \& B/ v& r
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

& a" i- Z4 F  `! O1 }Метод getQuest(String name)

, q, d' N" s) P$ `8 K! n. G

1. /**
   
2. * Получает квест по имени.
   - q& u: G5 A* F8 X2 X
3. * @param name имя квеста
   - e% _  [" v+ y* _. P% n* K3 [
4. * @return квест
   : W# \8 u2 ?. `" a! m6 O# \1 W% b
5. */
   
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   / {. L9 [! S7 J5 N
9.     {
   + @  |: v( P) b) c" c
10.         return _quests.get(name);
    - y9 O) W0 A) S6 ~- q1 B/ e& L
11.     }
    
12.     return _scripts.get(name);
    * U+ ]2 w, V" x$ b) a) Y4 g, ~4 {- _
13. }

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

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

6 n* ?% E3 T5 K$ b- IМетод getQuest(int questId)
# N! V1 r4 s; y' [. Z$ M, H$ Z
$ K3 h1 j: S: X# T

1. /**
   # f) W7 y8 I& E+ x* y$ ?
2. * Получает квест по ID.
   8 q/ n7 i0 a5 }) ?$ b9 c; _
3. * @param questId ID квеста
   % R# Q5 @9 b/ H; ^
4. * @return квест, если найден, {@code null} в противном случае
   ; R' c5 z/ @$ ]. I
5. */
   ( T2 x& F/ j# ^: J; ~1 H
6. public Quest getQuest(int questId)
   
7. {
   6 ?" n, n+ G& t
8.     for (Quest q : _quests.values())
   
9.     {
   , o+ t9 n* r! ^$ t3 W: N4 s  w
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    
16. }

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

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

% {! h( N5 O' S, a* z( H4 gМетод addQuest(Quest quest)
% L! ]7 H# r' q3 \' b' b) {- v$ P5 M
/ u) O8 B5 y: h6 ^

1. /**
   
2. * Добавляет новый квест.
   - B$ x$ F( O1 R! \4 i; \2 P
3. * @param quest квест для добавления
   ' Q7 Q, ]" j' L! f9 H" L
4. */
   
5. public void addQuest(Quest quest)
   3 w* Q2 ]3 C. R' {- O
6. {
   
7.     if (quest == null)
   
8.     {
     K" S4 s: \, P
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    ! [$ M- H7 Q" b
11.    
    ( ~7 y  [& w$ P' g6 p
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    # i! B& H& a5 s7 ?
14.     {
    3 A; G/ @& y  w0 n
15.         old.unload();
    ; b! z5 D3 F9 r0 [9 @  i
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    ! ]* J4 x- r7 w+ _6 V
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    $ l/ b( @5 S/ K9 z, n
20.     {
    0 w9 e& r! [6 ^  o* m
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    " A- `6 q) j. m+ o. |
23.     }
    / e& w6 Q7 h7 D9 v! z4 G# b. R7 @
24. }
    1 N/ P- L- s2 Z) n0 T) f4 \5 ?
25. ``

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

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


; I' k0 t3 G$ ?