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

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

Разбор файла QuestManager.java
8 |! {5 Y/ n4 o$ s: v" ?: {
Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  . j' T- w0 r) S) B2 |* p! g
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  

: Z! S8 j, ^5 B  i: N: k' n" EQuestManager.java — управление квестами и скриптами.
( V( a# g1 w( m) H; v* ^; b$ PПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

5 Z+ j& f8 d+ Q( S* m
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
; h$ y" z6 _. \( F+ i) Y: F1. Лицензионное соглашение
2 {" b( V/ M7 J- [5 N

1. /*
   7 I1 ?6 M7 J7 D  }! p3 R" [
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   ; t9 ^1 v: N6 Z) Y3 }# ?  Z# ]
5. * её в соответствии с условиями GNU General Public License, опубликованной
   8 z2 A; K" x3 e* d+ D$ A' Q
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   1 V2 N: {! T# |  q+ r# I
7. *
   8 W+ V( Y* O  J! |& \7 L; C) {
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    7 w2 r( R  J0 t4 [1 V
11. * См. GNU General Public License для получения более подробной информации.
    3 d* O, u7 q$ ]. d
12. *
    
13. * Вы должны были получить копию GNU General Public License
    ( H9 W  D% y# N9 m( E8 V. s
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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


/ j" k# l  g9 ~: [2. Импортируемые библиотеки
3 F* W6 C+ c" H& x; R2 y
- `. A/ \( X5 `; ?; a

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   ' z( c! j. {8 Z) Q) X# `7 u5 g  @9 ^2 i" {
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   2 r4 u9 p: n' Q3 r2 w# P& o$ l
6. import java.util.logging.Logger;
   
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   , O; Z, B7 U! ~( B8 n+ p
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 — менеджер для работы с игровыми скриптами.

3. Описание класса QuestManager
8 U8 q% E9 n# D) H

1. /**
   ! p' i9 T; D/ }. A. H! Z' S
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   " n' E: y! n/ a# G8 U7 H
4. */
   $ J  g9 f) Y/ Z$ ^! N% ^! u
5. public class QuestManager
   # m. Q2 N2 n8 F" d
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   8 ~2 `6 k" o' `# L) H2 u
8.    
   $ m. ?- G! S( T6 f
9.     /** Карта, содержащая все квесты. */
   2 \! `- }. s; ^, p  _7 _/ `
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    ' B: |# Q! }# G& N& ~
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    
15.     {
    % }, w4 m: h4 `9 z# f, V9 L6 T
16.     }
    
17. }

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

4. Методы
Метод reload(String questFolder)

1. public boolean reload(String questFolder)
   
2. {
   ! t( _# c4 j$ S! u' {" T
3.     final Quest q = getQuest(questFolder);
   2 P8 C- F* a, P2 [0 T  L. E
4.     if (q == null)
   & J5 x: I% i5 W
5.     {
   4 N1 ~. O7 e- r: A
6.         return false;
   
7.     }
   9 f, ?' k* `# _
8.     return q.reload();
   
9. }

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

$ q' N9 Y9 O4 a- _/ x. BМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

, u: \4 n) x: O, H4 O- j

1. /**
   6 ^/ E1 i0 }( x: F
2. * Перезагружает квест по ID.
   & y8 ~( }) }$ e, g/ {, r
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   / C- e2 \; l4 a5 R
5. */
   * n8 j5 l3 i8 x7 Y0 S3 l! i
6. public boolean reload(int questId)
   8 L- s7 j- p  \) z' F, f4 F) j
7. {
   6 ?7 g8 @4 m: v
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    3 L0 B- X2 g  l0 P
11.         return false;
    
12.     }
    3 m: h7 y7 g# B# F1 u2 r4 k# {, f
13.     return q.reload();
    6 \* S+ H2 ?1 x0 s5 u' K- V
14. }

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

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

Метод reloadAllScripts()

* L0 `8 E$ f+ N6 s* I" O% x

1. /**
   1 M2 W, A  y) ~: o$ ~9 y
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   & X& t! L/ _" i& j" G
3. */
   ' ~2 F, n# w" L8 m( I$ X
4. public void reloadAllScripts()
   
5. {
   0 Y5 i0 R5 x! Y; ]" l6 Z6 g
6.     unloadAllScripts();
   8 ]9 b6 M3 Q% g" @
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   ; C% g" Q) V% l8 D# ]
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    6 {( i( j; H8 ^9 @
12.     }
    9 C! G, y7 G/ w, W6 q3 ^( E
13.     catch (Exception e)
    ( K! F4 I2 `( R: q9 [, v
14.     {
    ) G* ?$ s$ {8 \7 \1 W
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    % o& w8 h5 e- F5 i
17.    
    " A/ ]& \" m8 E
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

2 q6 p3 |& G- n. C  T4 V: A7 q. n

1. /**
   4 |' t9 L/ e9 h0 Z* W. n, T
2. * Выгружает все квесты и скрипты.
   " J- T* Z: Q( i: i
3. */
   
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   ! @' b1 U% Q+ q
9.     for (Quest quest : _quests.values())
   
10.     {
    5 p' Y* v+ f3 W6 q: d+ H2 L; e( D
11.         if (quest != null)
    
12.         {
    ( t: S+ X2 z2 y' [
13.             quest.unload(false);
    
14.         }
    
15.     }
    ! K. ^' J7 T$ I0 Z. z
16.     _quests.clear();
    ( k4 Y, u- _% |; I! N: }/ V& x
17.     // Выгрузка скриптов.
    9 U4 m) R. b! d& e
18.     for (Quest script : _scripts.values())
    $ C0 q4 ]% \" j  m: N4 U( N, e
19.     {
    
20.         if (script != null)
    0 E! d) }) w% q9 }3 r# [% E7 ^- [
21.         {
    9 t' a6 ~1 S/ R5 W7 ]6 @3 N
22.             script.unload(false);
    7 F: K6 n- t! h, W, X
23.         }
    
24.     }
    
25.     _scripts.clear();
    . }! s4 j( Y: E9 ]3 E
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ' e  i5 A; e: r, G8 G( g- b

* X' L' W/ ^5 G, d+ J6 JМетод report()

1. /**
   8 g4 M7 I7 ~: F- P. Z3 y
2. * Логирует количество загруженных квестов и скриптов.
   9 N3 e* v4 O# R* A8 b
3. */
   
4. public void report()
   
5. {
   5 k: L: Q. ^1 H( e( k
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  0 |* r: E8 n& L  P. _8 l

Метод getQuest(String name)
0 ]! |* C6 W- G2 K! y! `
, H' i- d; z) d7 ~

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   9 `6 d8 J4 k5 R
5. */
   
6. public Quest getQuest(String name)
   
7. {
   " J- P, a3 G  D( p* ^& E, r7 q2 x& g
8.     if (_quests.containsKey(name))
   9 A/ A! K2 G3 ^, _* i
9.     {
   + i+ J4 {6 m& m9 B* p. I
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  / w; X: n. h" n, H9 o. M& y- o

Метод getQuest(int questId)
5 E' B# i( U* [/ w4 v! }
* l, H: Y) j  ]& g; _

1. /**
   
2. * Получает квест по ID.
   ( G0 F$ B4 b3 C; w
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   ! u/ B+ g* r* Y" G# R0 n5 |* e
5. */
   2 i* O" P& `/ k; A3 W: S
6. public Quest getQuest(int questId)
   0 ?% G& X5 b/ s/ i# h2 _: x$ j
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    ' O, x1 o. h: E9 s3 k# v5 E1 _/ X
13.         }
    + _# _$ F/ V' X6 c! c: J$ O* S
14.     }
    1 _+ m3 T( J+ M6 o3 [* ~
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  # k  `* G# R* c0 i, f/ _

Метод addQuest(Quest quest)

4 B" |% k7 o2 @. p: e8 z/ q- o* O

1. /**
   ; O, K" v4 U0 w5 `$ B, |
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   - R5 u+ @; u: U
4. */
   , h+ r6 C6 d: z. w
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   / @. s% z3 y- W0 `0 T/ X! r+ I
8.     {
   # I* {' Q+ g9 h
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   ( ^4 c/ O' a& a. r( n" p
10.     }
    
11.    
    0 O2 d' y1 E# V  M" w, \  ~! W
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    4 }$ E6 B5 y: m2 _% C2 C/ @
15.         old.unload();
      L9 e5 C6 X5 ]5 ^/ K8 G
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    + k; C8 }% j! l) N! m
18.    
    
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.     }
    ) y2 z* W' }: ^$ W
24. }
    - b7 _+ J4 X+ C) q' ]
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
6 y$ d  g% D" W/ Q  Y" n: ]ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.

" R+ W) f" s; a' T+ o/ E; M
0 Z* y" S' o5 e# n