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

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

7 ]# |( m5 N4 j' [) E. pРазбор файла QuestManager.java

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

• Лицензия
  8 o  M2 S9 x3 [9 Q( A8 J5 \& G, s, J  \
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  

QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
  c. B, [  ], J3 j
! A8 q7 g/ H, `0 V- @. T
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
$ T  Y% o% y) _$ r) m1. Лицензионное соглашение
5 e& x: \2 e8 @' o/ H3 T3 a

1. /*
   . K; ^, t: t& z& s2 \1 S8 U
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   9 ~* j$ ^+ q& O
5. * её в соответствии с условиями GNU General Public License, опубликованной
   : [7 H' X4 x' t1 _8 }1 s- C
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   ! c4 j( l1 ?% s: h& v$ C
7. *
   ( H9 ?6 _# O- P. _  t
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   - S1 K: G8 R' V6 R
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
      F+ b$ \& P$ X2 L
11. * См. GNU General Public License для получения более подробной информации.
    / J1 s% S' ?& q0 h7 w+ v/ i5 I
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    : G: q; u2 t( J) l% c
15. */

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

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

) e8 E6 d8 h" w3 c4 N0 Z8 a
2. Импортируемые библиотеки

% L0 P  l/ k3 r! p

1. package org.l2jmobius.gameserver.instancemanager;
   ; V! r* h1 t* \! ?2 B; M5 O
2. 
   % C8 v/ k8 S) u& E3 h4 L( ?3 a4 E
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   # t2 R" N) z3 d: Y& T' [
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   + E+ @& r8 j4 e) B
7. 
   8 r4 i  i2 d9 M" n/ a
8. import org.l2jmobius.Config;
   , J) M9 w# z4 S: l/ `- w8 W
9. import org.l2jmobius.commons.util.CommonUtil;
   . u& D5 }  I6 f
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 — менеджер для работы с игровыми скриптами.
/ \: w- H& B) z) g: I  x
3. Описание класса QuestManager
$ L6 ^! e- X( ~0 b: \

1. /**
   ' p& }8 f" F+ Y, }
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   7 }- g0 p: E" S
6. {
   7 r$ o" S. E' {8 Y5 x" l
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   ; q. J0 `' }& F! R- j: e- a6 Z
8.    
   
9.     /** Карта, содержащая все квесты. */
     j/ f) {% g! f: j: D4 k( C$ x
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    3 Z1 _3 F3 o+ ?2 ^% g/ g* D
11.     /** Карта, содержащая все скрипты. */
    / G% T) ~( P" Y+ w
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    + [  x6 a0 H2 @/ ]
15.     {
    
16.     }
    9 p) L% V6 ]5 ~2 o( j$ Y& x
17. }

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

4. Методы
5 O+ p! ?! K7 C) j* aМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   ( H& B6 w, x/ l
2. {
   
3.     final Quest q = getQuest(questFolder);
   6 T% J( k9 G: t# X1 j! W& m
4.     if (q == null)
   
5.     {
   4 i; c' u4 n1 f) Q4 ?: [+ U+ D
6.         return false;
   ) R1 ?# b: {( X7 S% d
7.     }
   4 T7 I* f2 c( }5 O9 h, @
8.     return q.reload();
   ( I) n! c  f; p: o  l9 }
9. }

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

  t7 R+ i/ [8 Q) C4 a, P+ P
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
" D0 e. h5 d% h% T) {$ A, P7 k+ P) T
4 l; V3 p. O- ^6 n7 i0 F' w

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   ' D3 u% N; z% T+ H) p4 j
7. {
   " j& ]3 [4 i- r5 M3 w' [
8.     final Quest q = getQuest(questId);
   & M. q% X9 W1 `1 n6 ^
9.     if (q == null)
   
10.     {
    7 N; q- H# o2 G1 H" c
11.         return false;
    ) X# H4 E) V- ?: v% M* B+ K1 [
12.     }
    
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  , ~, n4 ]' }5 e. u1 C2 b  G2 @* t, w

Метод reloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   
5. {
   + N' f8 ]' T' c' a( F7 m% ~
6.     unloadAllScripts();
   0 {) ~$ W, s/ N( N8 O
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   2 G6 i" K1 @3 b! ^, x
9.     try
   % q, Y% ~4 K6 g7 y2 Y5 G; a
10.     {
    ; t7 I" r0 b3 I
11.         ScriptEngineManager.getInstance().executeScriptList();
    9 U* F! T. c$ @6 H/ |8 _+ B
12.     }
    
13.     catch (Exception e)
    
14.     {
    ! G- [" B" g+ c4 E
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    : f, O  [) v5 a4 @. d
18.     getInstance().report();
    , j" p6 {. j$ `" s1 Z  x8 x
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   . K; }  u) V$ S3 q- E: u# {
4. public void unloadAllScripts()
   + R0 [% L3 V: w! u9 O
5. {
   ) c" @$ ]: V8 j' c5 {
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   7 B& y/ v" r# U5 T+ x. w; O
7.    
   1 k$ d$ c  A! W% N
8.     // Выгрузка квестов.
   / b7 g0 P1 q& H3 F- F+ l4 i
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    2 }+ A; o$ N" V0 p6 S
12.         {
    
13.             quest.unload(false);
    
14.         }
    6 o4 [, J5 O0 d, a
15.     }
    ! q6 X+ u* d9 D
16.     _quests.clear();
    # h8 Y+ R: ?  M; |' T7 H( Y" \
17.     // Выгрузка скриптов.
    + X$ R2 H$ D: U. ]& X
18.     for (Quest script : _scripts.values())
    / b" b6 H  E7 ?( h
19.     {
    ! _* p( n% X' p: G( d& T
20.         if (script != null)
    
21.         {
    ; c2 S9 l3 i( {; t) n) j
22.             script.unload(false);
    + u" @. g, E1 D
23.         }
    
24.     }
    
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  2 e" c( b: @* z

! [4 T* X. T5 y- k5 d- cМетод report()
- M: |/ `7 X2 W& B; N5 f& n

1. /**
   + B% b0 V  e/ D
2. * Логирует количество загруженных квестов и скриптов.
   ' J& r/ g+ J1 I* o/ g9 b( c# D/ H2 S
3. */
   
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
     y1 {' _$ B8 B; Y. s% P
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   # q7 T. j3 H  N) T) T
8. }

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

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

Метод getQuest(String name)
9 K* v9 p. S2 ?8 |1 w+ d

1. /**
   
2. * Получает квест по имени.
   * I- H# R, c0 P0 n% S4 m! l
3. * @param name имя квеста
   * X0 ?) b  L0 k  K2 m' j: \
4. * @return квест
   : i% P7 k+ D# l% p4 H" w! d
5. */
   , J2 v# g7 P7 y9 m' E% h* k9 b1 a
6. public Quest getQuest(String name)
   
7. {
   2 p7 q, ^: K4 \8 ]
8.     if (_quests.containsKey(name))
   
9.     {
   & @1 S  @9 e4 K6 b1 O4 t& y6 A
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  % @( |" ]" r# q$ ]+ `+ ~' k  S

Метод getQuest(int questId)
) ?' P$ z- Z! O4 P8 _6 r& b

1. /**
   
2. * Получает квест по ID.
   9 \. N; }$ u4 J% s8 Y; I
3. * @param questId ID квеста
   % K; t& e" a6 z' L; o
4. * @return квест, если найден, {@code null} в противном случае
   . I' f& ^" ]; y; U
5. */
   
6. public Quest getQuest(int questId)
   5 J6 s0 P. c3 X4 k8 Y+ A  u
7. {
   
8.     for (Quest q : _quests.values())
   # k/ i* y$ ~; R$ z
9.     {
   1 w* o* u. F6 K& |
10.         if (q.getId() == questId)
    
11.         {
    4 T. p( a$ ~& p5 C
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    " D& t" g9 U9 G, a
16. }

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

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

5 a) V1 A- K( O' k! S$ g/ QМетод addQuest(Quest quest)
5 y" Z9 r% Y( U& Q" v7 B
3 y: i; [9 n) q1 `0 P$ S1 m

1. /**
   
2. * Добавляет новый квест.
   ! V  Q  E5 l1 t( N! E0 Z0 }
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   5 @: ~/ z7 A8 S% x, E
7.     if (quest == null)
     g7 Q9 ^" u: C" V9 G" S$ [
8.     {
     y$ X' r% a: g# r  C4 V; v1 c
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   4 h! ?; U/ I+ A! A
10.     }
    8 K! \4 {$ c1 V/ \( _
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    8 \' o# Y) n0 n5 T
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    & X+ m: t2 |7 |5 Z+ ~8 `7 k
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    ; f$ g! Q% @' o* ~+ f  F
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    " q5 W" I! P% l6 ?
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    , I2 H  ~6 f$ |, N5 n
25. ``

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

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


. O( c. ^  w1 L2 E. u