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

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

! M/ t8 Q+ c/ V8 ?, i/ b3 q" oРазбор файла QuestManager.java
$ E: o% t/ S, b- B, ~
Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
7 Y1 E  C& n, e: Q" F9 l6 V1 D

• Лицензия
  . d8 A- L1 o. ?- {! s- `! g6 t
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    ) F* g4 w/ ~& I0 b( }  f
• Импорты
  

! A; n; R; R$ b5 y' Y& ]- EQuestManager.java — управление квестами и скриптами.
. U! S8 b. ?9 W+ \. e. lПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

* X6 r- l& E& }. C4 _" j
5 C3 i' o  D, R3 O) qДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   0 V2 c) h2 H; @: n( i" t" r4 Y
3. *
   : ]$ Y# c$ H6 b6 i; \( n
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   - c. Y3 [) H1 v
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   8 i* ]7 w3 ]6 v8 S% E. n1 t( B
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   ) v0 ]& F. K5 F2 U5 w3 G
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   2 o8 N* X4 p5 P  p$ D* n# i# ^
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    4 ^% w* k1 y! i, ?, u- v
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    . i( F  N; B; d% s7 G4 x
13. * Вы должны были получить копию GNU General Public License
    ! T: t4 V$ m, c
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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


9 k4 m5 v& z- a6 T& ]! b+ D! D: p2. Импортируемые библиотеки
9 E3 a/ _1 F3 i) {% I& `
* C' b+ e6 l: h$ I4 F$ U* f' `

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   ! y1 `. H4 y# g, `/ `0 Z
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   . Y% c/ \4 Z- r( q, o
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   ( S1 o- P* Q' @* ]5 d1 w  `, @
7. 
   
8. import org.l2jmobius.Config;
   ' J9 ~4 S) Y7 ?: L; g* v6 P
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 — менеджер для работы с игровыми скриптами.

3. Описание класса QuestManager

1. /**
   
2. * Менеджер квестов и скриптов.
   ) H  W- M- p0 E
3. * Автор: Zoey76
   ' S. P7 _3 |% Y" h
4. */
   
5. public class QuestManager
   0 r: p5 W- @# S$ B2 O. M8 c
6. {
   2 ^+ w4 D8 V3 I, l9 v8 n, T% g
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   : y1 `: m: j7 Z( J5 w# X
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    ( V; z( f" y) `3 _. T& o$ z) E7 |
11.     /** Карта, содержащая все скрипты. */
    ) @5 R  E0 m2 I) N
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    + ^2 I; V1 s. I7 U( j  |
13.    
    
14.     protected QuestManager()
    - j: `& S5 m' c; h( z1 L8 B
15.     {
    
16.     }
    
17. }

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

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

1. public boolean reload(String questFolder)
   , g4 }4 R4 P1 ~$ {) v
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   % z* r" B. G4 X$ I6 a
6.         return false;
   
7.     }
   # W% k( v- c1 o. M( J& R
8.     return q.reload();
   6 c7 G4 n$ S- c$ v
9. }

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

* M' H$ b  ^8 ~3 x2 g
" {$ h! h! z6 O; a: K$ w/ g5 cМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
+ u3 J3 Z: B! B( t! r; h

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   ! e* y1 c, B% G$ T
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   6 z7 k0 d' o2 u) L+ G# s- i
5. */
   
6. public boolean reload(int questId)
   
7. {
   % W* j; t, _) ^; A4 ~* Q1 z" b
8.     final Quest q = getQuest(questId);
   : S' T: j5 Q& [3 Y$ @3 n3 B
9.     if (q == null)
   * w- A( c7 l7 K+ n4 t% K
10.     {
    
11.         return false;
    
12.     }
    
13.     return q.reload();
    8 |) k& u0 c' |5 Y
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  / ^  B7 v' w! p3 I

/ l' G% ?9 l9 [4 f/ o$ rМетод reloadAllScripts()

1. /**
   $ h8 |2 ^) D! x! H& q
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   , G1 t1 k+ a3 q
5. {
   ! O  g# V6 n; W2 @5 z
6.     unloadAllScripts();
   
7.    
   , Z$ H3 W  {* s3 K; x/ B2 @# k
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   ! n8 [& a9 [3 i; G. h
10.     {
    ; A4 y: J( ]1 j3 F$ n
11.         ScriptEngineManager.getInstance().executeScriptList();
    ( p' c+ S" h) i& X9 B
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    
18.     getInstance().report();
    & @, v- Y/ u) u' F
19. }

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

Метод unloadAllScripts()
& H% e* K. u% F4 `( z( m: X# d

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   8 L( V8 e* {) V! F
7.    
   
8.     // Выгрузка квестов.
   $ Q! u. r+ v1 ]; \! O/ ^
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    8 F" _, g6 J! u4 k' K
12.         {
    5 ^/ M- B# _+ F2 r# E, p1 D2 S
13.             quest.unload(false);
    * ^( }% N3 I; N& {6 A% Q
14.         }
    1 {3 H: V" Z4 W7 L* Q  C7 V8 g# x; {8 s
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    7 C$ T: F$ Q% s1 N: E( p6 r
18.     for (Quest script : _scripts.values())
    
19.     {
    $ v' M5 Y/ R( r. g8 Y0 b3 R: j
20.         if (script != null)
    
21.         {
    2 h8 v1 \0 N& s8 Z2 B/ _
22.             script.unload(false);
    7 a; C* S& [) C( {0 ?
23.         }
    4 j4 n: b% y( S# y
24.     }
    
25.     _scripts.clear();
    
26. }

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

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

Метод report()
6 \/ O8 b  ?' o4 |9 X0 K  A% W+ `
3 U6 L' j- s6 y! U0 j' @( I8 P

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   1 h) f* z4 H3 _0 ]  l6 }, A
8. }

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

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

' ^. l& p8 d* A4 CМетод getQuest(String name)
8 D$ U, F7 f/ z6 b: R7 E$ k7 @6 s

1. /**
   - H9 S: L6 \# K! E! {
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   * x; A- J( O* X' H
6. public Quest getQuest(String name)
   + ~- a" @3 N4 P# }
7. {
   , V: l9 X7 H+ l
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    
11.     }
    7 |7 W- ^$ m; A$ s5 T% T
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  , j3 r; C; _' S+ L: {" F* K+ i

Метод getQuest(int questId)

$ O3 k; r' l; ~1 {

1. /**
   
2. * Получает квест по ID.
   $ }8 f5 n2 J7 }1 o' _! G
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   + V4 ^" D- I3 ^& {
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   7 u+ ^) I0 H4 r! R! B2 V% f
8.     for (Quest q : _quests.values())
   
9.     {
     I! ^4 v' R3 D6 q& c
10.         if (q.getId() == questId)
    0 M  n% A8 y: o) }- [; E3 Q1 {
11.         {
    / H- G9 c* g! `7 R' X% l  q! _
12.             return q;
    # V; f' A# B0 U1 m& B1 \6 ]+ A$ E
13.         }
      d+ T+ Q, x+ @' l, i
14.     }
    ! W( {* H% ]3 R6 _
15.     return null;
    ! j! q3 N0 U+ A( x1 Q
16. }

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

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

' y& e7 q; q3 g& wМетод addQuest(Quest quest)
0 L8 S) ]! O* A" ^# |
) o3 M/ t) L, v, L

1. /**
   
2. * Добавляет новый квест.
   # e  b  {/ z  c. C% H
3. * @param quest квест для добавления
   ( O  N) P% h9 ]* X6 l9 o( I, o
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   9 k0 @' P! G8 B* a$ D# {7 b6 L
7.     if (quest == null)
   4 f! m( D& ]1 v0 h; P4 V
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    4 x' o1 i5 N; N9 i/ V& j/ r
11.    
    ! A& Z0 G. L! j+ ]/ u& v
12.     final Quest old = _quests.put(quest.getName(), quest);
    3 D7 i% n. ~3 V. C3 q( p8 F
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    8 B$ Y! ~  k7 s" ^, c% M
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    & s- D# v+ W  P. h9 S
17.     }
    
18.    
    4 U/ Y' c9 s4 H, ?0 C: H# u! N
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    - O7 i8 L. T4 M1 M
20.     {
    % q% I. v3 H/ T( b5 `- Y% b- A
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    ) T7 p( g, R) Y  I
23.     }
    
24. }
    
25. ``

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

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