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

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

Разбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
& S" h! C, b0 ^8 I& M  s) ^' G7 fОсновные элементы

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

QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
1 S# N0 X# y" ^3 v: X6 a
+ \# Q! V0 O7 A4 `
8 _+ \% `0 t$ k8 S) C. d, kДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   ) w6 i# W: x& a5 R
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   3 K. W6 e( M2 `. a6 J7 a
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    8 s1 |+ `3 s& x
12. *
    ! P. p( ^% G3 R7 e' ~* V' Z5 j3 Q
13. * Вы должны были получить копию GNU General Public License
    ) ~7 |& ^" u; k$ v# g  v8 k- l7 `
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    ' F  C* d6 u& e) \, Q
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
: ^1 h5 e1 E8 c8 y7 ^  ~; ~
. T- d1 R. ~/ }. P! {. R! G
2. Импортируемые библиотеки
  |3 x" d8 d& U" R) H: F; k( t1 `/ P; `
- ~- `. d3 b$ A8 X

1. package org.l2jmobius.gameserver.instancemanager;
   ) A" w6 c6 w5 v1 f
2. 
   4 E9 q$ }- m0 k+ d, w
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   2 G! S" r. W. M0 P% p: O$ p& q
6. import java.util.logging.Logger;
   
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 — менеджер для работы с игровыми скриптами.

; p4 f: I9 C4 |! ~# T; M3. Описание класса QuestManager
' f" q: `9 V2 i, Z9 S

1. /**
   
2. * Менеджер квестов и скриптов.
   : V; g6 e! X2 ]
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   $ Y( ~! a4 k* f% Q' v( @
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   7 F8 \. q6 i  M9 ?7 n1 M
8.    
   7 f; `3 h9 L) B  `  d1 c
9.     /** Карта, содержащая все квесты. */
   " D. C" G0 r% Q, F6 g- B4 D
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    , l% b& P+ `  H0 R: h" K
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    3 o3 X: ~6 u, t% _2 }* |5 `
14.     protected QuestManager()
    
15.     {
    
16.     }
    
17. }

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

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

1. public boolean reload(String questFolder)
   + ]* m2 E' j% v; D$ t& M" n
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   
6.         return false;
   % ^; h+ f$ l6 w4 o# @6 K  P2 B/ p
7.     }
   7 T2 a; p* l  k, v% s. V/ H
8.     return q.reload();
   9 H6 s" `$ V" }" C0 W$ _4 d
9. }

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

( C. W4 n: Q5 j, X% y* _" B
( g" t/ f! n8 i$ ^' v5 UМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

1. /**
   . h+ _2 [) M$ T% |) `
2. * Перезагружает квест по ID.
   * S* e+ c$ [9 k) {3 `; s$ U
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   5 ?4 T7 {: n2 H) p# x
5. */
   
6. public boolean reload(int questId)
   
7. {
   6 ?" D) E! m9 F* Q6 j
8.     final Quest q = getQuest(questId);
   ! {7 D, Y+ |8 p/ D
9.     if (q == null)
   & Q3 u6 l+ a  j/ [: }# Q! P' Z
10.     {
    
11.         return false;
    
12.     }
    
13.     return q.reload();
    1 q8 h4 k! z0 a+ a7 a% G+ a
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  0 R. G6 ?) c6 ]. C9 O; P

: f% C+ @% }  C0 }+ B' s9 f( RМетод reloadAllScripts()

* r7 a2 J# Z& s

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   # x; I& w% o/ `2 L0 C' u0 h% V
5. {
   ' v; U  |+ T4 z6 c8 C8 i0 o
6.     unloadAllScripts();
   , N, k' _6 q4 e# L# q! `% X  l
7.    
   ( A6 V" R, A) a  U3 Q
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   : A5 l2 {# ?" _) v
9.     try
   ' I" Q" C7 k3 I$ r! P8 B0 n  {
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    1 R( k% t) c+ f
13.     catch (Exception e)
    8 P: C. y' }- B9 K4 g  N+ w
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    ; u" c5 ?4 h9 g3 {
16.     }
    5 X6 D* ^2 v5 v2 D- S( m0 N
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

1 I$ v5 H$ |; S5 d8 I& a' U8 V

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   9 ^2 |/ [* j7 I& q* f4 C: \2 ]
9.     for (Quest quest : _quests.values())
   & E% y5 _  e/ {
10.     {
    
11.         if (quest != null)
    1 R% l) I2 L$ O" S! }3 ^
12.         {
    
13.             quest.unload(false);
    
14.         }
    
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    & l1 ?7 b9 P0 U1 d
19.     {
    
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    8 W; }" j, X; g4 z* c- \* S
23.         }
    ! t) V+ k( l; D+ M0 w
24.     }
    
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ' X% l( W8 H" j

Метод report()

% m5 ?3 v5 i" G( S8 _5 {

1. /**
   + x9 _, j' V! s2 o) G) R
2. * Логирует количество загруженных квестов и скриптов.
   6 S! a3 f: ]' Q2 o. K! k
3. */
   
4. public void report()
   
5. {
   0 k4 }7 `  R3 z2 i. y: z5 d7 k7 s; X4 e
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   4 J& |$ L0 g/ m4 T* S" \
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   ( p* ~: Y& `' C# M3 k
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  * R# U$ ~- R7 v# L0 W

& a; U8 G( s, Y1 pМетод getQuest(String name)

* T: \$ n9 z) b1 U3 \! R% V

1. /**
   - r1 [9 l) g3 S; e0 u
2. * Получает квест по имени.
   ; g8 f1 M' ?6 {
3. * @param name имя квеста
   
4. * @return квест
   & @  E& C0 g: E$ z; G/ W+ c
5. */
   ( A4 X# d+ {4 P
6. public Quest getQuest(String name)
   0 o% V6 |: m8 G
7. {
   ) }/ E( @9 R  F& u8 K+ J
8.     if (_quests.containsKey(name))
   
9.     {
     A1 r  a# ]  v, Y6 d
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

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

Метод getQuest(int questId)

1. /**
   
2. * Получает квест по ID.
   1 K1 U8 E8 S7 N! [- K, Y  s
3. * @param questId ID квеста
   % R7 J$ A4 R1 A
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   1 f, V9 z/ b1 y/ ~/ q
8.     for (Quest q : _quests.values())
   ; y. j% \/ j( P) t9 y9 l
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    
13.         }
      G& K1 q4 y. K" t; k
14.     }
    
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  , q8 F+ ?( v  B( G, b

Метод addQuest(Quest quest)

1. /**
   
2. * Добавляет новый квест.
   , G1 M. k: I! @+ V0 y$ G: D, {# g& `
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   , p9 p. j$ p, D  _+ }) o" e
6. {
   
7.     if (quest == null)
   . `* j* W& N, L' V, ?. \6 m$ F+ U
8.     {
   ' q. e% h' q8 L; B
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    ( ^: j" Z% ]% R" |( |% T2 k
11.    
    7 p- q5 }; i5 c4 C7 _
12.     final Quest old = _quests.put(quest.getName(), quest);
    1 z: F# Q7 R0 U
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    * G8 _8 H, c8 X2 Q/ }
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    + d1 N: p5 J7 T2 M
17.     }
    1 i1 u7 D% o9 ^3 q$ P8 S
18.    
    # t( n8 H; m5 U0 e* `6 p" A
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
      r  w5 J, B3 b6 W1 B( O
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    ' ?: r7 B+ S8 `3 c) Z
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
- x  V6 @: n0 Y) k1 W$ RЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.

, ?2 Z6 l) f& n* c9 a
7 D; }0 Y" c9 g6 K; Y% g
( u" Z, {- M8 c4 Q( a" E! T