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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
" w) D6 Z  n' g( z- m. Q; O
6 F, e; v/ B0 ]/ }' `: m, j" Z& F5 oРазбор файла QuestManager.java
0 a1 U/ M" E, E7 ?8 e# x, _& k
2 E1 o9 l7 K7 T4 q/ bЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  6 y, S; {# ?( d8 s1 O
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    ; [& f/ q% X1 w( u' G2 y" l
• Импорты
  

QuestManager.java — управление квестами и скриптами.
5 }$ `" y, J1 {' tПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\


Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
+ m. j. u, x, _1. Лицензионное соглашение

1. /*
   3 ?) |; n2 Y! ^
2. * Этот файл является частью проекта L2J Mobius.
   5 h# A' I/ K+ S) U: U1 c2 @1 ]4 q
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   . F3 N) i8 K2 R% K' d
7. *
   7 P0 b3 v, @& {  [5 P
8. * Эта программа распространяется в надежде, что она будет полезной,
   1 u( n2 u- C4 c3 o7 ^$ V" k
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    8 Q& I( ^9 b- u% w& z; i: {3 y. q
11. * См. GNU General Public License для получения более подробной информации.
    " B! s# y* K3 Y) s0 q  s
12. *
    / Z3 n" @' D' [: E) u
13. * Вы должны были получить копию GNU General Public License
    ( j- c" G6 D& X8 U+ c4 q$ s# C( Z
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
9 W. k$ z, _2 q7 N! }7 K
- H$ B, \" k" K
' s+ o+ @# e' A2. Импортируемые библиотеки
2 E: V1 \- J+ t* a" i6 S

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   8 ?; z  F! F6 x0 j  g3 I! R
8. import org.l2jmobius.Config;
   ( [  V& a6 w$ u
9. import org.l2jmobius.commons.util.CommonUtil;
   4 N% n8 q1 `% q, V' j
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
  d! Z  K. b8 N- F+ s$ D+ g

1. /**
   6 d5 }2 e9 W( ~* v! U  Z
2. * Менеджер квестов и скриптов.
   " M3 M1 \! n, ]; ?4 |
3. * Автор: Zoey76
   8 @- ?9 u) C; k) a; s& W7 j
4. */
   ) I( o9 I( e; _( c/ B( o
5. public class QuestManager
   : \- {/ u! P' W3 {5 |8 T: Q
6. {
   8 m+ ~$ ^' T2 W8 H- B
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   4 ~. D+ {. E3 o0 M
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    2 m. o1 X/ Y1 ]3 a) K% C
11.     /** Карта, содержащая все скрипты. */
    ' A+ e3 u, Z) Y1 J1 K  L
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    + o" l& l- J' p! ]: ?* C5 R  f; Z7 u
13.    
    
14.     protected QuestManager()
    4 {/ h8 t7 `# n7 H- Q
15.     {
    " ?8 n5 J0 @; d
16.     }
    6 v5 T( `$ U) C, M
17. }

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

4. Методы
5 {6 E) e6 V+ w5 n8 fМетод reload(String questFolder)
9 d" y6 w0 o* c5 {

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   , z0 C$ P$ f2 i3 Y5 o" h
5.     {
   
6.         return false;
   
7.     }
   
8.     return q.reload();
   0 Z  O$ w3 I& h% I, c0 w
9. }

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

, s* h# m5 E* x/ _
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
( x" I1 |0 l2 i
) X% h. C% e0 e) ?

1. /**
   : s' s7 g4 k3 O! Q9 |7 q4 [
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   6 h( ~3 Y7 k) g- Z* E5 H7 W
5. */
   * x! V! M* p4 Y; R: m
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   # z2 c: O, s. G' o3 j
9.     if (q == null)
   1 M, ^' R$ D+ e
10.     {
    
11.         return false;
    
12.     }
    
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  ' K+ y- d* l% V) t" U: S6 l7 V

! O. r% U! P4 S7 E0 f4 I% TМетод reloadAllScripts()

( ^2 r6 e* Y6 T- E7 `6 L# m

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   $ }8 d; C0 b7 C& j
4. public void reloadAllScripts()
   
5. {
   " [  i9 w/ t. x1 U& A
6.     unloadAllScripts();
   4 H9 E9 X5 N, R9 J8 e
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   1 T9 I; {" O2 B7 e" w$ q" h
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    7 N; U: h5 Y8 }8 N$ E  Z2 W
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    & \6 _1 m$ j0 U8 G1 q
16.     }
    * M+ P8 |  I- F& o. ~+ K
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

1. /**
   0 R5 @& o: B& \$ v) h5 E
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   9 j# S; P" `; A, K
5. {
   * j( A) \# F3 e# X/ s& G1 v9 F' n
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
     ^2 O4 i& F  `. S
7.    
   7 v% ]3 C! O) q  P" |% n
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    3 ]( \' B9 N& b3 @
12.         {
    4 U; s# m+ ?" B7 n, ~
13.             quest.unload(false);
    8 h. g7 p# h' f! M
14.         }
    9 V/ @  {1 [8 ?
15.     }
    & q; Z9 H4 t  \$ J
16.     _quests.clear();
    0 ^  @: Q  H$ y
17.     // Выгрузка скриптов.
    6 ^7 f1 \1 N! v7 O, f
18.     for (Quest script : _scripts.values())
    / R7 {- Q+ F* K* j+ C
19.     {
    7 V4 T1 h- r6 ]1 M5 D2 t
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    
23.         }
    ; E: v- H1 f' _" n5 q
24.     }
    6 V$ W9 G" I6 E  L; ?9 O
25.     _scripts.clear();
    ) _1 u$ U4 ]& K- D1 |& j
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  / m$ q7 W# f8 I, I3 o9 W$ i+ w

Метод report()

( e3 r0 ^0 Z# z  P

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   % h% T0 u3 E! N  B0 f
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   + h7 ^7 P' L+ ^4 y. K) {) h4 G
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

Метод getQuest(String name)

4 s3 _0 r# b( L- v. w+ t6 }' A

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   ( q+ W) u3 m$ w# C4 u8 X' E
5. */
   
6. public Quest getQuest(String name)
   + r+ I  p# R2 @$ w: ]
7. {
   ! t' E7 }4 L& ~' o
8.     if (_quests.containsKey(name))
   ) ~1 h* K" [0 @  n6 S  ?* |
9.     {
   . I/ L9 w" A. e2 M' c- W
10.         return _quests.get(name);
    
11.     }
    2 c7 x" e7 N) g+ J8 }/ Z
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  3 X- e; i' J$ a2 |

0 {# J+ i$ E6 w0 h+ ^8 xМетод getQuest(int questId)
6 }) I6 w7 c$ x% L  w/ H

1. /**
   
2. * Получает квест по ID.
   9 T7 R# Z; ?& \8 \" ?! ~; T  Q  ~
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   : @  n) `3 |2 W* o6 Q" q
5. */
   - M# [) ]6 W4 ^$ _, m
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   ; z* j0 }8 r! l" j. v
9.     {
   
10.         if (q.getId() == questId)
      c7 Y. R( d# E6 f/ F$ Q
11.         {
    - @+ s" |0 D' k: y
12.             return q;
    * }/ Q! J) P$ h
13.         }
    " g- I# R- i3 k1 ?  m
14.     }
    - l3 d$ y' W; h8 b! \
15.     return null;
    . W. k9 I& M& |2 `
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  ) S6 @2 F; w& K1 ?7 j/ x

Метод addQuest(Quest quest)
! f* J* F6 B! C% T: n9 S. Y
# N3 x' N6 E+ u9 U5 I6 l$ q

1. /**
   8 F6 ?* e0 y4 f2 }% H
2. * Добавляет новый квест.
   , ~% T, V0 H7 k# D
3. * @param quest квест для добавления
   : h3 i8 s; D, X! Y
4. */
   - ?1 U7 y% V0 E4 k8 v, n" U/ T
5. public void addQuest(Quest quest)
   1 W# |% P# o) E& S  Z% C& A4 |
6. {
   7 }' ~4 V0 p- a! c  V+ X
7.     if (quest == null)
   
8.     {
   9 m4 T3 U4 E& r) E
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   / j1 s) D9 w) l, S. h
10.     }
    
11.    
    1 p; p: p9 @3 M6 m( i
12.     final Quest old = _quests.put(quest.getName(), quest);
    0 J, W: |" B) R0 z4 u
13.     if (old != null)
    
14.     {
    " q3 U, `8 L7 u; j5 \$ g& u% H( x
15.         old.unload();
    ( s; L$ F$ p+ X% A: W8 t+ C
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    4 O1 a9 m, F. F
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    : J- |% N& }* T. n; }# Z
20.     {
    ; V9 [0 B3 _7 D0 s7 y/ `' P
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    2 f& C- e! O( S6 M
24. }
    $ O6 T$ _7 m. O; M& e0 ^+ r
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
( [$ P# o' b5 xЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
8 N: D; c  Y& r
+ X& q; {! F9 N: i$ v4 O
. W5 e  o; \! x  [3 ^; t, n; B