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

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

Разбор файла QuestManager.java
8 o4 O( A2 h2 h8 S! R- t& _
1 _) {* O! L0 p7 M# ~Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
9 \* I! i$ ]1 `! R! |- K1 Y3 IОсновные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  $ o: F* \9 }* l' a0 f* Z$ t$ t

QuestManager.java — управление квестами и скриптами.
; N1 t& s2 f) X3 k. HПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

1 `+ F! x0 s3 }9 @
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
+ i$ N0 D/ W3 h: k4 r+ y' P" }' G1. Лицензионное соглашение

1. /*
   " Q* V; K0 q0 Q. u; o# x% D5 {  i
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   8 p2 }6 M6 w$ o
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   2 e; A' \; i: ?2 w2 }
7. *
   / [2 r3 L+ v0 H2 p
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    & N0 v% f' w- `3 O! n* c
11. * См. GNU General Public License для получения более подробной информации.
    8 _  T3 F# s' ?( [0 b7 ^
12. *
    / z6 ?. K! m& ?+ E5 t
13. * Вы должны были получить копию GNU General Public License
    " x$ O9 a. Q( p3 j" ]' g1 Z( @
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
- R8 `0 f6 u# d9 _
5 |6 ~' r0 @# h. Z$ u2 V
0 ~! m: z" L0 `( L, M: L/ }* f2. Импортируемые библиотеки
! p$ C4 X) ^+ @" q

1. package org.l2jmobius.gameserver.instancemanager;
   ' ?( U( Y- |+ b# ^5 V
2. 
   
3. import java.util.Map;
   + T" A% S+ \7 Y' d
4. import java.util.concurrent.ConcurrentHashMap;
   ! A. {+ P% ?  [4 A$ Z' J0 ^& x
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   ; O- @; {6 X4 a- e/ i, R
7. 
   - D+ p) g7 e0 V
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   - E) \7 @& [3 y. y9 W! y9 H) w6 V+ `* ~
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
  ~8 j  Z# e, v7 a: x" u# }

1. /**
   
2. * Менеджер квестов и скриптов.
   ' y8 Z5 X7 L9 W
3. * Автор: Zoey76
   : R, D) @: Y- G2 Z' q3 x( v
4. */
   
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   1 R: B& M: Z( s$ p+ a
8.    
   
9.     /** Карта, содержащая все квесты. */
   : C  q2 R6 i) C& \) m
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    % \2 [% [7 g. y! e* O9 V3 a, A) |
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    : i. H2 ]7 H- z6 ^9 _* C0 v
13.    
    : U9 A. Z! I* O* Q" q
14.     protected QuestManager()
    
15.     {
    & C" \& g8 e: ~) W
16.     }
    ) D7 [7 {; b$ ?7 O- o$ ^+ @4 M+ b
17. }

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

4. Методы
Метод reload(String questFolder)
1 x# t& I2 X5 u

1. public boolean reload(String questFolder)
   
2. {
   ) ~. E4 Q1 D. v. w: n
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   
6.         return false;
   
7.     }
   
8.     return q.reload();
   2 g1 q0 w6 |( N8 P  y; O
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
3 k  U/ j- Y+ c9 S9 h0 J# h
" i% Y( U9 w; R9 u' G& X8 I) A5 i1 A

1. /**
   
2. * Перезагружает квест по ID.
   6 u, w3 a' L9 e! D  m
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   , [! x: w# n+ O0 d# `
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   5 @9 F& O) n, p" v2 X  `; Y
9.     if (q == null)
   
10.     {
    
11.         return false;
    2 w+ ~; g% r6 _+ `6 v, k
12.     }
      y4 V0 q) w) J8 u/ y
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  1 T* h, B' R0 X1 S2 r) y2 H

" A. f& q' r' C# b6 |Метод reloadAllScripts()

' H9 A3 ^2 o* @$ C! f1 ]

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   4 J; o) U( N1 \$ [) J
3. */
   + N: M' ~. H& q- P6 C, W! L
4. public void reloadAllScripts()
   
5. {
   + {6 _) @( {2 O" x; r  j6 M
6.     unloadAllScripts();
   / N- U, u; b! m$ k! e
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   , s" t( S, w5 A0 i) Y9 z
9.     try
   9 ]+ N9 G/ n0 q! J8 F
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    6 |- T& P0 k9 B' }% y
12.     }
    
13.     catch (Exception e)
    
14.     {
    % s2 e% Y8 o3 V
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    $ S& A9 Y* r* g& p, ^: W
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   ; M+ @% ^1 Z$ Z; y
8.     // Выгрузка квестов.
   3 u) E( o8 j, o& X6 U5 m
9.     for (Quest quest : _quests.values())
   
10.     {
    4 w( f; e1 @4 _
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    
14.         }
    
15.     }
    5 R$ n+ M' O. f9 y; [9 N
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    - C6 P  O, v6 |
20.         if (script != null)
    
21.         {
      }( B/ x4 g3 f( i9 ]# e. [
22.             script.unload(false);
    
23.         }
    1 r% F! q$ y) L1 _& N2 B
24.     }
    6 }+ a7 l9 a7 t( @$ r6 C9 \
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  % f5 j( F! n. {& C

3 ^: o$ w1 Z7 M; b& a) KМетод report()

! N, `: n- I7 Y

1. /**
   % f- Y, p' c; a6 Z5 w( w/ z& r
2. * Логирует количество загруженных квестов и скриптов.
   $ h  p0 T! y% z0 I$ T" |+ ?
3. */
   # J6 s; N& E$ j' J3 e2 }
4. public void report()
   . W9 q) ?% ~! r1 z: Z
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   ) l  q* B8 B* I9 ^2 ~& K
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

Метод getQuest(String name)

( Z& `% v! y0 k+ S7 [# o

1. /**
   
2. * Получает квест по имени.
   ( @) S9 a0 A' S6 S4 o( ?4 L
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   9 P5 e  r0 s5 b+ T9 D0 q$ Q! k
7. {
   1 K7 W+ l  V4 |6 }
8.     if (_quests.containsKey(name))
   
9.     {
   ( Q! b' B9 W2 o8 D- `7 X
10.         return _quests.get(name);
    9 S) B6 r7 u5 v% f
11.     }
    
12.     return _scripts.get(name);
    1 C6 S; e2 o4 q
13. }

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

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

5 Z' z/ ]/ _' M  P3 A9 PМетод getQuest(int questId)
. \$ y# E1 K3 f/ {
2 C4 b  m, P/ Q; K

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   0 W( o. c7 a% p/ J; t3 Z
5. */
   5 H: w5 f6 U# V& ^9 Y+ f$ X
6. public Quest getQuest(int questId)
   9 x1 M6 O) E8 @. \$ }
7. {
   
8.     for (Quest q : _quests.values())
   " H. ?' J- J  }! a% m! k( g' z5 P
9.     {
   
10.         if (q.getId() == questId)
    + _2 }) {* {& f. m/ `7 |* U
11.         {
    * v1 i9 K9 ^- P$ H% D' ^! p1 F
12.             return q;
    ' k3 E" `/ q# O: ]0 F1 z) |6 Z0 F
13.         }
    
14.     }
    
15.     return null;
    ! X2 y) R+ B! i  U( e
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
    E% ]$ Y1 ^0 \3 k

Метод addQuest(Quest quest)
0 U: B# J/ B4 M. K7 I
) L7 d- t; ^( M

1. /**
   
2. * Добавляет новый квест.
   ) T7 ]& B( B9 T  b/ i6 j4 a
3. * @param quest квест для добавления
   
4. */
   2 H. E3 Z3 a& f$ t8 a, u
5. public void addQuest(Quest quest)
   5 [% i8 C( W2 x; F
6. {
   
7.     if (quest == null)
   7 x0 h: K0 i, `
8.     {
   . h* D: s& X* k
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    % c) r# z- L5 g% r. \
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    ; Y. t' c7 [  \5 Y- Z  l3 `$ r% v) |
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    % C' c1 S( r+ B. K$ M
20.     {
    - l% w. x$ D' U$ G% S) w
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    & v+ _" w  @% h+ i% \8 b# n+ o& _
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    0 A" M0 B7 B+ [- f! }
23.     }
    
24. }
    
25. ``

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

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