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

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

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

) c$ K% _' O: w3 i+ d: sЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
7 f; H6 O" Z7 ]+ y) g2 \$ iОсновные элементы

• Лицензия
  8 H+ [+ u- D7 V
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  1 `" ~! v! d4 x6 e  a5 K

# b6 ?+ f% z% y9 H2 F; k( G* R5 NQuestManager.java — управление квестами и скриптами.
8 n$ n9 \  [6 F, n% P* FПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
, U8 a# W* p) B1 F' r& r- ?: `  A+ e* W
& G7 _" c9 [0 Q; n! F# H
5 I3 W0 j% L  A+ jДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
, I' u- R4 T3 A, J$ m( V! V

1. /*
   4 s, I" h" p* ^( Y
2. * Этот файл является частью проекта L2J Mobius.
   $ R, R  F! A* c
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   $ S2 @  D. b" W/ Q, ]
5. * её в соответствии с условиями GNU General Public License, опубликованной
   " B- d' d$ Y6 m/ `% O- N) Z# b9 N! H8 R
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   1 l. A0 B5 A0 i+ \- e+ q" g2 Q
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    & S3 E2 w2 F2 A6 g$ M
15. */

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

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


2. Импортируемые библиотеки

1. package org.l2jmobius.gameserver.instancemanager;
   ( B/ ?' Z+ P9 O5 v4 A
2. 
   
3. import java.util.Map;
   ; i! \* ^6 t% E6 G* J
4. import java.util.concurrent.ConcurrentHashMap;
   . P! J: U+ F* U
5. import java.util.logging.Level;
   $ Y* V; [& s) g/ y% A
6. import java.util.logging.Logger;
   
7. 
   ; q. X! K& G7 P
8. import org.l2jmobius.Config;
   ( L! ^* q# F3 r
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    , J* f: R0 }9 X" {" r  q9 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 — менеджер для работы с игровыми скриптами.

3. Описание класса QuestManager
" z8 j6 Q9 @% Z2 N! o" J; o; f2 n

1. /**
   % ~( I- u- W0 l7 u
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   2 W% _6 B( s" C6 y( e: @( q
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   6 `+ S# J6 N: W' ]9 L# @1 v
8.    
   " k1 u4 [" V0 p' \0 ~# i! z+ t
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    ( h5 n( r+ a  O1 o- _
11.     /** Карта, содержащая все скрипты. */
    $ d/ K9 V2 r; c% f
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    9 e! y; X# A+ }9 Z6 v6 C
15.     {
    
16.     }
    ! m! Q; C2 E: }8 i
17. }

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

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

1. public boolean reload(String questFolder)
   0 Q: O/ W3 S( d/ o9 c- t% C
2. {
   
3.     final Quest q = getQuest(questFolder);
   7 W4 o3 W4 a: @* O1 ^( @9 }
4.     if (q == null)
   
5.     {
   7 @' M2 s4 b+ s! x
6.         return false;
   . {( p$ D/ h0 R$ I: R" R7 s
7.     }
   - P8 w" v' G7 Y$ t2 [5 m, @
8.     return q.reload();
   , P+ o. N$ X9 K6 u3 e
9. }

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

$ ^& s: A# Z! X6 q8 n3 I: i6 E  s
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
9 D* d8 l6 h  I) N+ P' Z" a
8 ^0 b/ p; S; T. r7 i* U; ~3 Y

1. /**
   0 R4 G0 l+ D% ?* J- Y( }  p7 p0 D8 i2 Y- _
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   " j0 Q$ M( M' i( j! _" m: y& K
6. public boolean reload(int questId)
   ( P: k: y# U' }& L
7. {
   5 l# O3 c' b" k2 ?) n3 H7 Q: |8 w
8.     final Quest q = getQuest(questId);
   # T/ e: _& j+ g, E5 j& O' l  r6 h
9.     if (q == null)
   # D1 z. N6 ^* k% c$ I! q( |
10.     {
    
11.         return false;
    
12.     }
    2 K' Q, G% W' M8 X% b0 D$ w
13.     return q.reload();
    
14. }

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

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

6 R1 v8 S4 k* f; wМетод reloadAllScripts()
4 I5 ^9 Y( a; {. W8 F" p# _

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   . U  e$ }( W: M! R1 @! ?
3. */
   3 u! e0 m# o" @0 p* ~% b$ L
4. public void reloadAllScripts()
   & v# D" v) F0 w: Q6 G7 }' k$ s
5. {
   ) u/ ^" m- T: Z: u  |) U3 E
6.     unloadAllScripts();
     o% k2 x$ \5 o1 S3 U
7.    
     c7 s5 Q4 i. y
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   ! k4 E- s5 ~( r$ x3 X( K# V5 I
9.     try
   5 }2 j" W- S. M5 N3 _) v4 b
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    * p9 a7 I3 @# d, F7 L5 `0 @4 n9 ^4 h
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    8 F* C$ p* h' O: `! h
16.     }
    " g. @0 {1 ?) e  C& E
17.    
    + ~6 e0 j4 n/ |( D& s/ F
18.     getInstance().report();
    - L) J( M* I1 ^. M4 M$ f& ^0 o- }( J: I
19. }

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

Метод unloadAllScripts()
+ y; r; T# U/ F: @( V- o
4 c" y, L$ K( h. u- w$ \

1. /**
   4 N4 M% K3 G, [3 h. n* g$ [
2. * Выгружает все квесты и скрипты.
   1 P4 l' V+ n6 r" ]7 `9 X
3. */
   - W* y5 D+ {( S; ~
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   3 N% \) F# F9 t8 i' Y4 X
7.    
   5 `% x5 f; \5 b, {! c6 _
8.     // Выгрузка квестов.
   % f' K  Y$ c& F/ P( u1 n2 z' j
9.     for (Quest quest : _quests.values())
   
10.     {
    + c3 O$ v+ j. T# U: e. g
11.         if (quest != null)
    3 S3 v) p: s: T& m( A) Y. V0 ^
12.         {
    
13.             quest.unload(false);
    6 p, ~8 ~5 s$ L* o" f( E; N3 V% U
14.         }
    
15.     }
    " N2 u* e9 b  q4 ~
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    0 Z% v3 p' z$ t& I, f' K. S1 A
18.     for (Quest script : _scripts.values())
    1 P& j) I, z3 e0 z
19.     {
    % j5 e# G5 g+ o1 u* z+ {, N: l- C! u
20.         if (script != null)
    " H6 N0 l+ p( H3 t: N9 }
21.         {
    " y! n. S3 a& V! e. e* S
22.             script.unload(false);
    + }7 X9 U5 I( O' B8 @
23.         }
    
24.     }
    8 p* }- J% J' ?2 Q( c+ U+ G
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ' }. `8 l6 k0 ?. z: l) G0 I* _4 M

! `4 g+ t3 R( `4 JМетод report()

( G' ?  C& N  p

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   $ f2 Y* ^! f4 n7 V( w- p
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   7 g4 b; k& X5 n' a, n
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

Метод getQuest(String name)

9 k. H) K  S/ }- }2 X6 P

1. /**
   
2. * Получает квест по имени.
     y; @, e- J. A4 s0 {6 ]4 K
3. * @param name имя квеста
   4 S4 E; a2 N, {+ ~$ }( y$ K
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   8 v) V+ F: F3 }$ O* ?$ L6 @/ L
9.     {
   
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  ) b% ]" v( N" J' T5 C2 a9 r8 Y

Метод getQuest(int questId)
, I7 [2 d( a; `) ?
1 l* o6 K: T- \' r' F, K; P7 @! w0 B

1. /**
   ! i2 j4 t' i7 I5 _" p1 r+ |
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   5 `1 H9 r5 N, ?6 ]5 e6 ^/ G- o
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    
13.         }
    ! j. `7 e# O; r
14.     }
    
15.     return null;
    ! t$ c1 j  N) m9 @* X3 \
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  4 O# b' I& a) h" X2 ^

: I( u7 L5 n( y0 `/ f7 w* ?$ `Метод addQuest(Quest quest)
) M. Z3 f1 }- ?. s4 C4 B$ r9 D

1. /**
   
2. * Добавляет новый квест.
   " K' Z$ g6 z8 \- P: J% t
3. * @param quest квест для добавления
   & D% U% _# @) S: g0 h# j
4. */
   
5. public void addQuest(Quest quest)
   ' u" W) ?  P+ a8 `+ s: b
6. {
   
7.     if (quest == null)
   
8.     {
   : t% J' j; v. `
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    6 U5 Q9 F$ i! c3 ^
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    7 }' z' F+ u# i  h( a- c
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    & V( G% [9 K* v7 `* a
18.    
    " D# ^: T" k/ x; `: K# q+ S
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    # B) S; D: m9 t. d
20.     {
    1 a) s' Y0 K; o0 b. q; p+ s
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    & ^6 G" o, Y9 d7 M7 h; C) Q
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    ! y/ j, H' y& o- ^* y
23.     }
    9 E& X4 q# ^( J# Q3 [1 j" ^
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
; h  L: k  y/ \' b2 n
' Q# ~8 |& u% b9 k# _) C
/ n& t% E) Y( \" O5 L4 |
) Y/ _2 ]4 k0 t  n+ H  y