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

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

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

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  . L0 C+ y5 O& m1 a" }
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    % z" W) }; Q* c# B. X
• Импорты
  0 d; w8 n9 Y0 u4 o& S; \. [/ A3 N! y

8 k; h2 ], y9 U+ t/ [' cQuestManager.java — управление квестами и скриптами.
! j/ b( l/ n+ B$ ^; mПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\


Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
0 p& V3 C6 R6 x; B* d1 W& ?

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   6 H9 l, o) n  R
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   3 _6 y: c: o' x$ a
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   . i3 k- c* S- l7 B
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   + W8 h  x. ]* \8 `
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   % u5 w  c0 v* a! D) h5 g
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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


/ T; Q& k* h# u9 q- C3 T2. Импортируемые библиотеки

7 j& f0 R* B; k

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   # ]' E  E  z2 R. L- J
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   ) I0 g5 a0 z1 H2 Q: }
7. 
   
8. import org.l2jmobius.Config;
   2 Q, F, K  w1 z! Z/ c
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    , j; y5 k! ]$ o' }
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 — менеджер для работы с игровыми скриптами.

5 e& P) m# G9 B/ M, C3. Описание класса QuestManager
( W4 `9 X8 o; F9 R; W

1. /**
   ! i* h, C; E6 w/ s
2. * Менеджер квестов и скриптов.
   " }7 g, Q5 R" K- a/ ^, `" T; V
3. * Автор: Zoey76
   
4. */
   , B: C, A  X! j7 i% ~3 O
5. public class QuestManager
   9 q- h2 b+ F' ^( H# K: W
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   ; ?9 E+ c3 F: w
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    " K& ~( g8 d( Y, a& z
11.     /** Карта, содержащая все скрипты. */
    - J% o, U% y- \8 Y
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    2 ]. E- Q) N0 z+ D, m
13.    
    
14.     protected QuestManager()
    ! Z8 _9 @, c- a* M9 O5 L! g
15.     {
    
16.     }
    ) @+ T( H4 p. ?6 w; J# n* H
17. }

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

4. Методы
Метод reload(String questFolder)
% H2 x  m8 n' Y7 h9 k7 k2 E* O

1. public boolean reload(String questFolder)
   5 b" i1 C2 U7 m; Z" Y
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   - L1 l7 r* z6 e$ b9 W
5.     {
   
6.         return false;
   
7.     }
   1 c, P( b2 x, g: v5 u
8.     return q.reload();
   
9. }

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

# e+ ?/ B6 E6 W& k9 W  Q  YМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

1. /**
   
2. * Перезагружает квест по ID.
   # ]- X7 ~0 x+ G: \. y* R& ^
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   - J7 U  {6 {5 k0 E! l: T
5. */
   
6. public boolean reload(int questId)
   7 K3 k' r/ w: K/ R# w
7. {
   3 G. @: O, T/ m$ z7 }
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   % C$ b3 m4 o6 z" a! s
10.     {
    ) H1 o/ e& e9 ]# q2 V- {
11.         return false;
    8 Q% O8 _$ B$ G& |6 @+ M$ b
12.     }
    3 |3 z, g! h5 p6 E
13.     return q.reload();
    . U& L4 ?% v5 l" s8 n
14. }

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

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

3 p4 W  [: q, O, @$ |Метод reloadAllScripts()
0 ]4 \- W9 a. T4 w# c
: s  G9 P' _7 b0 j& X* N( ]

1. /**
   8 k7 H  ~1 G! H7 a# S, s
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   
5. {
   1 j1 G. f3 w' e+ r4 r
6.     unloadAllScripts();
   
7.    
   - ?1 x6 j2 D( C" d+ @
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   7 q. p1 S3 W, v" x' W. B2 w
9.     try
   ! l; ^  w% \  j0 F8 \/ ?
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    / D$ R0 p, s; K& G9 G" b5 v! b& |; w
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    . O# v3 I3 J( [. O
16.     }
    + f. k$ m  y0 p7 [+ M- r
17.    
    % E5 u$ E8 ^% f0 E, P! z" b( J
18.     getInstance().report();
    ' a+ U. ~0 H! O; D$ q$ a
19. }

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

Метод unloadAllScripts()
8 j8 _$ @) d' U. C0 O

1. /**
   
2. * Выгружает все квесты и скрипты.
     o$ b5 s" z3 x  \1 z% @) n
3. */
   
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   5 L% v5 z" g  h# S! @7 q' z
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    * u$ ]/ L  U$ b2 y
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    
14.         }
    2 K* [$ [- _; K3 i6 V
15.     }
    & |. Q) o4 u, Y7 {
16.     _quests.clear();
    5 S* }1 r9 l+ S$ ]% E; {8 k
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    8 m. `6 k8 ~$ H
21.         {
    
22.             script.unload(false);
    
23.         }
    
24.     }
    # g5 a* h) O+ {3 o
25.     _scripts.clear();
    " z% y* z6 `# H. |9 ?+ w
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  1 ^" F4 b3 {+ S( @# y6 o9 R

Метод report()

. B$ T' x: W* I3 \, {

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   , L2 \- s) m8 b  c3 i
3. */
   
4. public void report()
   , l+ D" f. @; B; ~, c* K: |
5. {
   ! A8 a& o0 s/ b; V" Y" }1 E
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   0 P" r  ^, x# j  I. b
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

( B* z, @0 b* IМетод getQuest(String name)
8 ]. Y0 U$ I; G: O  c1 v
9 T7 x2 r+ ^& ?& k

1. /**
   3 p, U: n! }* n  |( M" \
2. * Получает квест по имени.
   
3. * @param name имя квеста
   & a5 U, E. V. j# m  D5 T
4. * @return квест
   
5. */
   " K  x8 P; L. u- G( v
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   - T1 y$ Y* m/ k+ Z% B% U) @
9.     {
   
10.         return _quests.get(name);
    ! g8 A1 D$ s) }% l
11.     }
    
12.     return _scripts.get(name);
    & b' }3 |+ Z0 l6 m
13. }

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

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

Метод getQuest(int questId)

1. /**
   
2. * Получает квест по ID.
   # ~( |) H3 P, M# l; z
3. * @param questId ID квеста
   / ^4 B1 O1 f7 H/ O  g( F
4. * @return квест, если найден, {@code null} в противном случае
   " }" d5 K' q2 n8 a5 \: \! y# @
5. */
   - P: n6 s+ H( T1 w7 P
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   ) }$ d' f$ a/ i' M0 f8 |) ?0 ]
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  ; U; S- B" f7 \" L7 n

+ L& i8 ~$ N' iМетод addQuest(Quest quest)

1. /**
   1 d$ @7 z. B! p
2. * Добавляет новый квест.
   8 E  o( }) N, M8 n, _& K3 T
3. * @param quest квест для добавления
   % y9 W3 i9 c. l6 _$ m, @& H
4. */
   1 w: s9 x+ C2 L$ H& w
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    8 q( C+ ]8 o" N
11.    
    # C7 A( n& @: D! E7 p
12.     final Quest old = _quests.put(quest.getName(), quest);
    - e* b2 U9 {4 L7 e6 Q. ~5 K
13.     if (old != null)
    5 M2 i+ ^5 [& |2 U( O0 C- R, }
14.     {
    
15.         old.unload();
    0 x: Y6 ^. Z0 s7 E$ t: U
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    + Q& h( j1 A6 c4 N# j: C% z
17.     }
    
18.    
    ; X* o9 _7 D* S- N
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    % p! Q+ O/ ?/ e$ c" f6 N& v9 z1 K
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    9 i: n" a5 {$ W, o
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
      {$ O, s0 |' F$ k- `. h
23.     }
    * z; J& [7 ]4 x* x
24. }
    , O) ^( V4 ]* M/ r! b. {% ^( G
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
% H8 b: [" M! y+ r/ m; Z


! H( u7 ~  e* c