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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
' i) N; s5 z, S( t6 Q1 j4 U
6 I* Z4 Y  E! o' w2 Q) O/ EРазбор файла QuestManager.java
( W6 }1 e/ y$ O1 f$ n1 A: X$ Q* Z$ K
5 N2 Z; v- |3 s" ZЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
1 G. o! \, |+ u" w5 u( M& LОсновные элементы

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

5 o" z2 H/ k# e% {QuestManager.java — управление квестами и скриптами.
! Z9 |, i8 c- P( F3 v. `Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
; F" ^& j% L8 n3 _4 ^3 a" y
1 O* E3 P5 V5 S! ?
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
7 A2 M$ |# Y9 R: G# r  l* A1. Лицензионное соглашение
, m: ^3 K: h8 H4 ~0 B- i

1. /*
   2 m7 ~" I- U6 l
2. * Этот файл является частью проекта L2J Mobius.
   + Y- b1 \& P) f7 N
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   - p, M+ {/ [9 a5 d0 M6 P1 `) I
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   8 B; w4 ]$ l9 E; l8 i# ]
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   6 H9 G3 d8 H! z. V8 S+ X# |2 [
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   ' y5 o: P+ V9 V, ]
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    + g& m" M# K' i. h3 i3 }
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
7 i; u4 L/ E  r' Z3 b0 V

/ @3 I2 G8 }6 f' Q: a# k2. Импортируемые библиотеки

9 y; t/ n7 H* q6 C1 I" }' {' |

1. package org.l2jmobius.gameserver.instancemanager;
   $ A* u0 E- v+ i; x, R
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   # E3 L; {$ ~5 x& A
6. import java.util.logging.Logger;
   
7. 
   ( f' C  o4 N* z8 j
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   $ K6 }! I+ t/ P" ?8 o9 q
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. /**
   ) [5 v/ B  |. |. h  p
2. * Менеджер квестов и скриптов.
   ( k8 w! }# M0 `
3. * Автор: Zoey76
   
4. */
   4 O# @% }* H( Y- @
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
      a# Y+ o& t( \# a9 v2 f- `) |! B
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    ( @' x# u: Z/ J; X; n
13.    
    5 K* n6 \- t/ `2 a
14.     protected QuestManager()
    7 _$ b& y2 d9 f0 y
15.     {
    
16.     }
    
17. }

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

4. Методы
4 _( q8 I4 P& K# C- ~3 Z7 ZМетод reload(String questFolder)
/ w; t: f0 |4 a; n# O0 C) y

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   ) T/ [- }% Z: ^1 f" D
6.         return false;
   1 B8 t% K# F, r; G& r# I7 l5 f
7.     }
   
8.     return q.reload();
   
9. }

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

1 @3 J6 Q  j) ~$ G( w
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   ! Z+ e. b: O, B$ J! ?  Y+ }- a0 I
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    
11.         return false;
    
12.     }
    ) i+ C8 m4 ?4 O5 n
13.     return q.reload();
    % _4 E3 t8 `$ {2 x0 \% @
14. }

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

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

, x1 T% I& q. i7 j. T( G' lМетод reloadAllScripts()
% n0 r* E: Q; Z0 O  f' Q
4 ^4 {2 c; h4 r* g) A: Q5 C3 n' P

1. /**
   # K$ \( r* ?- X! s1 Z) _
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   8 m5 P, n/ n! P6 s  ?' x
3. */
   + M: w5 p2 L" x" t, v/ P9 h
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   ; `! g: k8 }: D% @( ]6 X! h7 M
9.     try
   ! K& A0 r! J- |! j1 y: ^9 E
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    . n' k6 |( e& l
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    ) I2 X. q; `2 ]$ ?6 |( k9 s' h- W
17.    
    
18.     getInstance().report();
    0 n& ?! J( [6 E; k
19. }

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

Метод unloadAllScripts()

, ]% x4 Y2 o" u& y" c+ w3 Z3 J, m3 ^1 e

1. /**
   
2. * Выгружает все квесты и скрипты.
   7 I2 M/ o  o3 c! ]
3. */
   / y& o; T% B$ ~( K' V  M2 ]
4. public void unloadAllScripts()
   / I8 Q2 z. ]8 e+ V0 C: k1 p7 q; |
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   " t1 s" Y9 T! B
9.     for (Quest quest : _quests.values())
   
10.     {
    ) I% n4 g0 _+ c  m
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    # m% l) D4 r$ y5 Q
14.         }
    
15.     }
    % [% K4 a6 X& T) Y" s
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    7 F2 v0 r  h* n7 d+ ?2 B$ z% n
20.         if (script != null)
    
21.         {
    % B  X5 a7 ?9 N% s
22.             script.unload(false);
    
23.         }
    
24.     }
    ' H% x  G2 v- Q! [! l  Q
25.     _scripts.clear();
    2 O4 h: K) k" o. G+ P' f; u0 j+ H, u
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ! C* [7 H) E& R& m1 P' r: D

, [0 Y3 g  L+ B/ eМетод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   0 |5 O6 g' s$ H. J2 c  C' k2 b
5. {
   6 R1 H# ~' K3 Z
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   , P! s9 A: Z9 \9 G; s1 t; v
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  * q8 i4 S6 w+ `/ ?

Метод getQuest(String name)
& S9 \' L; i+ A1 k! K  ~
5 m* z6 b1 x1 T/ A: o8 ~) F' E, A

1. /**
   0 L+ i. v6 v: y2 s
2. * Получает квест по имени.
   ) b- [# z- a% \& _
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   3 w0 {, q. o/ U
6. public Quest getQuest(String name)
   " s3 e1 Q" @0 C4 n% ^
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   ! U8 G6 x( e/ k" s: J! ]
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

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

; G) J% k! _: |+ c2 G1 N) i7 GМетод getQuest(int questId)

1. /**
   ; G! h1 a3 p$ V  w- E9 H
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   - E5 i0 L5 i  w7 U& M+ `. ]! g
4. * @return квест, если найден, {@code null} в противном случае
   2 ?) t  x2 d3 A( C1 v
5. */
   ) ~9 i, f. R* a' S! p  r8 Y
6. public Quest getQuest(int questId)
   
7. {
   " @, h& G% v2 H1 ?* ?1 H8 S: k
8.     for (Quest q : _quests.values())
   
9.     {
   ( ~( R8 X$ g# F1 U- U" |
10.         if (q.getId() == questId)
    & F1 V& _4 v9 p- {. ^9 l
11.         {
    
12.             return q;
    * x( w* ?) f" |: T% a, G- e/ U
13.         }
    ( G. ?5 `, o, D" L4 i4 L
14.     }
    
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  9 G4 [" u$ C' }  h0 V* v0 z4 A

Метод addQuest(Quest quest)
* `2 N- j. z) [! \4 d
7 \6 n4 L+ Y; S: N$ k/ `

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   2 M/ T5 N5 d2 ?( U
4. */
   4 N% ~% y0 Y5 A$ }6 P  ^* m. B
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    , T3 c3 N) c2 C4 t
12.     final Quest old = _quests.put(quest.getName(), quest);
    2 D' B* u0 w1 C# G8 s. c( J* A8 i
13.     if (old != null)
      }2 Y+ {; ^- U& ^9 V0 ?" l* k8 Y' j  f
14.     {
    & W  X; E7 B' [% M7 c
15.         old.unload();
    9 r8 x9 U9 e' o; l' M( M8 y
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    8 x( W1 Z* s. q; |- `, U3 r
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    ' B1 ], {$ {/ v* ~* Z
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    , y2 w- v* A- g( X- J) d4 p
25. ``

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

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

" J# _" H) h: H
7 X, m+ Y4 z3 Q$ ]$ {
( a& Z. \2 `4 M  _6 o) H) a