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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
$ V% r1 S2 K) l4 q9 C! E" `
Разбор файла QuestManager.java

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

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  # _1 v4 \5 H# n+ D% \

/ y! B. ^5 @9 h% j' dQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

5 M8 f/ x# i) I4 u; `
4 x8 N1 |0 u6 yДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   9 u$ Q% C) m4 U; \5 ~7 O
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   7 m6 O" m$ ]* m9 c: r
5. * её в соответствии с условиями GNU General Public License, опубликованной
   1 e- a; x9 _: e5 |
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   " _- i3 u! [  S: |) p- m4 ]$ M8 l
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    : R; [* z. q1 B) p
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
3 }6 y& J$ Q3 ?  S9 N% N

( `3 |% X; Z! L% H! a6 B2 E2. Импортируемые библиотеки
" M6 ~9 D, \) [4 j

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   9 C  m* g2 G) b" N) `- v
6. import java.util.logging.Logger;
   
7. 
   
8. import org.l2jmobius.Config;
     }/ Q/ H- ?! |+ d$ a
9. import org.l2jmobius.commons.util.CommonUtil;
   , h* B. `7 v$ F6 i, @8 O
10. import org.l2jmobius.gameserver.model.quest.Quest;
    & m1 z; D$ |' U) @' i: \
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 — менеджер для работы с игровыми скриптами.
& d, J3 P6 {! O  r/ x
3. Описание класса QuestManager

1. /**
   & S& Q% l2 ~2 g# C- g0 k3 F  s
2. * Менеджер квестов и скриптов.
   " X; N0 P7 W, H8 i
3. * Автор: Zoey76
     U$ [- {: O# i4 Z
4. */
   : i; X( {, g' r; y  v( s- V2 R
5. public class QuestManager
   : F- G, X: o" N0 D9 M- g
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   ) d& m) `) \1 U! R
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    - {; U( Z6 D1 D2 ~
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    $ Q9 I! H6 w; h* q
14.     protected QuestManager()
    
15.     {
    
16.     }
    
17. }

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

4. Методы
Метод reload(String questFolder)
+ X2 X2 ]' y* S( V

1. public boolean reload(String questFolder)
   
2. {
   # }& q! \% Z* X- x5 {7 C( ~! f" n, g
3.     final Quest q = getQuest(questFolder);
   * [" E: A& G! }2 E7 j: d+ ]$ k
4.     if (q == null)
   
5.     {
   
6.         return false;
   7 c- [& c8 B$ x' m
7.     }
   : e( o- Z! k4 v6 C* ?1 w, s* h6 W3 H
8.     return q.reload();
   
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
$ T6 ~$ [  O9 f9 _, D. tМетод reload(int questId)

; a4 B$ Z, K- K* u& z) I- J# ^

1. /**
   9 h5 @* d8 z' h
2. * Перезагружает квест по ID.
   ! e2 ^: N% Y" R0 T$ A7 C
3. * @param questId ID квеста для перезагрузки
   ; l  z$ W' z( l) b- Y5 K; F
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   4 I+ N9 @/ |' \& _6 A
5. */
   6 u- U; @6 V9 E9 h6 _* @$ ^! S
6. public boolean reload(int questId)
   
7. {
   5 N  w! @5 F* f5 Q
8.     final Quest q = getQuest(questId);
   ( k$ m) H3 a/ E% F1 D, s
9.     if (q == null)
   
10.     {
    + y/ C& x; R4 W
11.         return false;
    $ j5 X: p' ~/ g. X( t/ Z; d& R
12.     }
    
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  % K, e, T* g1 ^$ b) h9 [

7 o3 I4 i& \) g# m' [) U0 YМетод reloadAllScripts()

/ x& K+ g2 M* }1 I# U( }

1. /**
   4 X* M, P4 d7 i: S) h
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   ; B# T- i0 |* R5 y8 j
5. {
   6 e# k* _1 K4 F/ q$ E. ^. @
6.     unloadAllScripts();
   6 [4 y. r7 v6 G& F$ {9 U7 z* L5 z
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   + P8 w  P3 t7 j0 n) v+ b
9.     try
   
10.     {
    3 Y1 g) J4 F# D4 i# z% M' R* `
11.         ScriptEngineManager.getInstance().executeScriptList();
    1 l7 z9 \3 a' y
12.     }
    ; A3 Y1 j% L& V# N1 j
13.     catch (Exception e)
    & i- d: h" U3 i% R
14.     {
    & m% y2 ^6 r, d0 Q0 O. Q1 D
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    5 q& I1 h5 {& ^1 B! C) r& x: r
16.     }
    ; v! N- e/ K7 J! d9 D
17.    
    ' N0 `1 t3 E* L2 }
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

6 D5 `+ L6 k, T3 T4 q# t- E

1. /**
   ! ]; ]" j  U4 n- x7 V  G
2. * Выгружает все квесты и скрипты.
   
3. */
   4 }7 E& c8 y" e
4. public void unloadAllScripts()
   
5. {
   6 ]; ?) p; u) y! d& g1 {, _% M
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   9 ?4 X7 I  ]; t  p- ~. G% I  ^
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   6 ]+ F& i2 C0 ~& _
10.     {
    
11.         if (quest != null)
    ) I  Y* U: v3 T
12.         {
    & _: a! N6 E( @2 o, M
13.             quest.unload(false);
    6 W! |4 Z& @. q8 |# X' S9 n# @. X
14.         }
    , h1 ?; g" s! Q7 X6 ^5 t
15.     }
    
16.     _quests.clear();
    ' ^0 Q3 x  R0 g: D
17.     // Выгрузка скриптов.
    ( I9 `2 T& P* e) B- |4 q6 A
18.     for (Quest script : _scripts.values())
    
19.     {
    ( Q! r) e4 u2 L9 g' Q
20.         if (script != null)
    ) b4 C) ~3 x5 F$ T  V8 P( x. V
21.         {
    
22.             script.unload(false);
    
23.         }
    9 K+ x, u  w3 j. n" [+ {
24.     }
    : ^* ^. L- f3 l3 F# ^/ ?
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ' l/ s1 G* o9 E) k" x) r. u. f

Метод report()
3 _1 f3 e3 \3 y/ ~4 K9 q

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   - i. I6 {. y; O! i( ^7 T# O0 u0 |
3. */
   6 u; t5 h) S. s& v: i4 J9 q
4. public void report()
   . @) O$ p; |. ]5 Y4 D9 s% K6 s
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   . M% K& J: a4 E
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  $ {6 S% }9 ?0 ]

Метод getQuest(String name)
1 h# c7 w; x. T! D) X8 w1 `  u

1. /**
   
2. * Получает квест по имени.
   4 E7 o1 @5 v, `4 `2 L+ j
3. * @param name имя квеста
   
4. * @return квест
   1 p7 y+ ^, z2 d3 Q: d4 A  I9 ?
5. */
   " k1 j/ k8 U) v: d& R
6. public Quest getQuest(String name)
   
7. {
   1 b9 Z$ W4 h' x6 n0 `
8.     if (_quests.containsKey(name))
   4 K, z8 z7 A; u( q; p# l
9.     {
   
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  : B, P9 o6 P0 w4 c# L* Y* D( m

Метод getQuest(int questId)

% ]; f4 o" x* ]3 z: A( |! o

1. /**
   1 l( m, r( [4 F0 ]+ ?. `
2. * Получает квест по ID.
   0 g3 y+ k7 [# r, i
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    , M+ b2 |/ a& n  x, w
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    6 T* Q5 _4 v4 l4 _1 d
15.     return null;
    6 J: s$ q4 T  ~3 T5 l$ w$ W
16. }

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

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

Метод addQuest(Quest quest)

9 b; ?3 q! i1 X. D, x, t9 _

1. /**
   7 h0 s) u3 \1 g% C
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   ( `. e2 ]7 u" t) a' N
10.     }
    
11.    
    0 G) ]- J, F, W$ ?$ w  j" \8 m
12.     final Quest old = _quests.put(quest.getName(), quest);
    + g% J( ~- X- H* J
13.     if (old != null)
    
14.     {
    & a9 U1 e+ c+ j4 j
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    ( I" S. x  O" t  w6 g. o4 p
18.    
    * P4 ^+ Y9 V* x  I) A3 E; f3 C8 }
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    ! c/ ^% q; l" ^  e4 D. Y
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    ) W: M! @7 U; |- w
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    # r) b9 C6 O0 e- d0 N0 Z
23.     }
    
24. }
    2 Y4 w- Q# `8 b* Z! C; U' R% |
25. ``

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

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

  J, ^3 n8 ]9 A* [1 s. S

+ n) C8 f& ?. V% w& f$ H