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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
$ z, |/ a$ K) O4 w6 E& `
Разбор файла QuestManager.java

8 T" i9 I3 b! N  LЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    ! h( u4 _6 @0 I$ M' \
• Импорты
  . c$ k' F4 Q' g, x+ y

  w$ B  _. ]2 g/ t: k! pQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
0 U5 X& A& D0 Q0 |
2 a5 \' b$ j) ]# l
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
3 b# ]. B8 u) c9 v$ ]

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   % w" y+ Y' t) O! {4 p+ V6 r
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   ; \" {  }9 }8 i. i+ q6 K  p% i
7. *
   4 P) Y+ {" M$ ~! F: T, X
8. * Эта программа распространяется в надежде, что она будет полезной,
   . F  b( a- ?* k: w9 T' v
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   ) P2 w: l3 {+ L
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    2 ]6 \, [, D4 O  @
13. * Вы должны были получить копию GNU General Public License
    * G7 }4 C% g8 R% @- z) h; \
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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


. M) n  k& q: N7 w3 i2. Импортируемые библиотеки
; |. i) E/ ]8 R: \8 Y% W

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;
   1 v) G# L/ R. R0 {  K
7. 
   
8. import org.l2jmobius.Config;
   - n" V& s( |6 L5 R( p
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    : T# P$ ]$ g$ k3 G0 F: H
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 — менеджер для работы с игровыми скриптами.
& F3 Z* d8 ]2 F* N$ o( S1 C
& f- A/ I$ v& E/ I; ]' Y0 i9 p3. Описание класса QuestManager
+ ~6 J6 y; u' l- D

1. /**
   8 t6 X. N  R: M$ \: Q6 l/ }
2. * Менеджер квестов и скриптов.
   6 F! l  R; j8 g; l6 ^) W/ F
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   + [; b* ]: J- r9 t0 c
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    ( w7 M% J  n4 {
13.    
    & n) h! O6 Y+ m& N, c
14.     protected QuestManager()
    
15.     {
    
16.     }
    3 G; Y' m" d( ~0 K/ u: Y, }6 V* n
17. }

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

4. Методы
& t0 r3 a+ `/ v3 V% GМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   / k* L- M7 H. v$ l9 g
2. {
   
3.     final Quest q = getQuest(questFolder);
   ! e' t7 v# m1 i9 ^6 _* J
4.     if (q == null)
   % i! h' ]8 C* k; ^/ u& _
5.     {
   
6.         return false;
   
7.     }
   
8.     return q.reload();
   # C# K$ y4 p# ?. x. a! \* w
9. }

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

1 p3 y) b2 }& A$ H, a
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
! a9 s8 e) V$ r* f

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   4 [: |6 c# L4 S; }: k
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   " c0 i% |/ D- [3 I8 r& O
6. public boolean reload(int questId)
   
7. {
   ) }: L2 z, H( V& d" r5 b
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
      P* ]0 _3 O3 K/ n* }8 h
11.         return false;
    
12.     }
    
13.     return q.reload();
    . |  F- }5 n  Q9 W
14. }

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

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

Метод reloadAllScripts()
/ l4 ^, Z' H+ \- O9 N1 \+ E3 o

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   ( y: B% k7 {( _1 W' v9 k8 |9 q
7.    
   + I% j3 v2 C  e
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   * e! c. N: Q7 j. H0 o
9.     try
   
10.     {
    ' o" P( l+ d6 t/ j$ p, |7 ]+ k
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    . ]* r$ o, c3 K: C9 U( Z$ D
14.     {
    % o% A0 C1 J2 K; S- K- q8 C
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    3 L; `6 ?/ a& y6 [
18.     getInstance().report();
    9 g: D/ |5 B4 H' X
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   " l2 x/ {6 E3 s4 O, P( c4 x* ~
3. */
   
4. public void unloadAllScripts()
   
5. {
   0 E& C8 B4 y! M9 o
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   1 r- ~* Q, j6 y1 e* g) O5 H
10.     {
    # {6 q& d0 _  y5 X9 s2 C+ ?, g- Q
11.         if (quest != null)
    9 N$ x- J2 M' ~) o
12.         {
    
13.             quest.unload(false);
    & }! D0 w) L0 c* a" q, e0 I8 Z: o- n
14.         }
    
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    ) m, U/ N1 M: w# X4 O+ H
19.     {
    
20.         if (script != null)
    
21.         {
      a$ e% v- X- g# ?0 ?" @0 B
22.             script.unload(false);
    
23.         }
    ) ~# h7 z& D5 O/ X* l! Y0 j, k
24.     }
    5 F% E& i5 T. e
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  9 }5 s4 w7 X6 A9 p1 `6 X

4 J2 ?$ d: Y* X+ A2 oМетод report()

1. /**
   " \/ F4 t1 [1 X' O1 S8 C4 s- k4 Q
2. * Логирует количество загруженных квестов и скриптов.
   # ~+ \6 ^, l# d3 ]' k% ~: U. @$ a
3. */
   6 U$ E1 ~. V) m- X
4. public void report()
   * h3 y8 Q+ c# F7 n1 ~# J
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  1 L* w% S3 S) K+ s2 v, V

Метод getQuest(String name)
+ q7 d2 `* t# U  F" i+ b; {
6 Q: \$ w6 ?  R: q' z

1. /**
   
2. * Получает квест по имени.
   - _0 w+ \+ v3 {; }+ G
3. * @param name имя квеста
   7 {# Q& N( T: L& d
4. * @return квест
   
5. */
   2 D9 m! ?" x) d  h! s
6. public Quest getQuest(String name)
   : n+ I/ Y9 s  t% b0 T' D
7. {
   
8.     if (_quests.containsKey(name))
   " e& b& a8 I9 W1 `' k
9.     {
   6 y8 u; ?) W+ t7 l9 J' m& G" q7 N
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    ' M. ~8 S  A3 O7 X& C' C% p( t
13. }

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

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

Метод getQuest(int questId)
5 T' m, h4 ]+ a$ D% [( m

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   0 P* Q. L  C; N% b% q: M+ G' S
6. public Quest getQuest(int questId)
   
7. {
   . ?/ h* A8 M8 Q: d' T. t' T, L5 t! H
8.     for (Quest q : _quests.values())
   ( K$ d5 }' n/ g$ v: c' H
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    ( Y% H$ z0 _6 u. ], \
12.             return q;
    9 i% i; a8 K+ n' H6 N
13.         }
    ( R4 U2 \6 C7 ?8 e! K
14.     }
    
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  % @0 Z% U% Z; G' x1 ]; A7 J5 F

Метод addQuest(Quest quest)
1 a8 D5 r) c1 a" {* L
; n" i; O0 J3 o

1. /**
   ) V9 v5 q8 M( I' u2 K$ A' T
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   2 X" k7 ~7 L5 n( c
4. */
   
5. public void addQuest(Quest quest)
   ! a# W( R4 U  _" O/ N
6. {
   / w7 X3 f/ {+ X/ y$ F9 v3 \
7.     if (quest == null)
   * I  ~6 U* f; x5 t- u* ?% z3 \
8.     {
   $ u$ @6 |$ W9 F
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    " J9 j, }8 _$ e% a6 m
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    9 h6 |6 Y. _! c! O
17.     }
    
18.    
    2 n2 ~9 T  ]" y% \/ N
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    - e/ L! q9 b7 q
20.     {
    7 r0 U- `4 o: f* s4 ~0 ?
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    1 I, }% n( g6 F7 o' R: e7 K
23.     }
    ( }7 C1 i5 D! }* l
24. }
    . Q( l9 G: C7 c
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
( o. d) i+ v6 s( k- b' P

" i$ p/ W  L( U* i/ Q' y