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

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

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

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
& E$ S6 }6 r& \* ]Основные элементы
! Z+ L; y0 ?7 T9 b7 ]: E8 t" P

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  3 n1 h, P9 n$ p* B, @

QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

+ @' n( F! M! |) m; M+ \% b
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
* ?8 m1 x) `, l( M4 c

1. /*
   7 w/ o3 r! f3 q4 f7 C; s
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   8 P' E% K, _, ~0 X, g1 N. G
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   / r# s+ q. o* J% o' z: H" d
5. * её в соответствии с условиями GNU General Public License, опубликованной
   # n0 w5 U7 I$ k9 W1 n
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   ' W5 y6 f( F0 |  i% v  D+ M
7. *
   9 `3 A0 {8 V0 A6 U' n
8. * Эта программа распространяется в надежде, что она будет полезной,
   & ?( k3 w6 [# j. V9 d
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   ( |' [3 q" K! ?6 r) ~' V; @. F
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    * ]" c! B0 `+ I- r/ y
11. * См. GNU General Public License для получения более подробной информации.
    & z: W. G! L4 P3 l  {, {" [6 U1 `. C" y
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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


2. Импортируемые библиотеки

1. package org.l2jmobius.gameserver.instancemanager;
   3 I# R% l4 ^9 k: c
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   1 P# V: ~. W( z& `+ z# [
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   1 U  G- X' E0 s* v' h# ?
7. 
   4 e& n. ]: G9 W( R4 a, H; R% p
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   
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 — менеджер для работы с игровыми скриптами.
4 W/ V  Q; v6 R4 P
3. Описание класса QuestManager
$ c3 g) m# s* C8 \, q& ~% B

1. /**
   
2. * Менеджер квестов и скриптов.
   : j7 d) v( [: m- u. B3 O5 |  e# S. K8 |, b
3. * Автор: Zoey76
   
4. */
   / T. n0 x) w- S. Q- Q
5. public class QuestManager
   $ c& `# P' {7 P6 w
6. {
   9 P" N( n, c- k9 B- s3 w6 m
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
     x8 ]4 T& [2 N
8.    
   - L/ [9 t( ^1 d1 K0 P* B
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    1 p* f0 x. R. T
13.    
    
14.     protected QuestManager()
    
15.     {
    
16.     }
    
17. }

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

4. Методы
. S7 \% e; h. i# pМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   $ i& H; @, {) @& p6 }8 [
5.     {
   
6.         return false;
   
7.     }
   + K( |& l. b5 |5 n
8.     return q.reload();
   . n$ h* ]! @# q2 F
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
( B1 }7 [7 d5 E+ S3 F5 z8 o! [0 B2 d  oМетод reload(int questId)

1. /**
   : [" W  q$ G" |% R" Y# V5 L
2. * Перезагружает квест по ID.
   . N  w( p8 O; q
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   # o2 ~& H8 [/ \/ l
6. public boolean reload(int questId)
   6 Q* y3 g" V, ~) I: u" t
7. {
   7 T: E& \7 l- U  ]% K* a
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    
11.         return false;
    
12.     }
    : V" q4 z- |2 d$ i4 F
13.     return q.reload();
    7 l9 n- {1 ^2 [6 Y7 J' ^
14. }

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

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

Метод reloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   & u: _, g9 y) n: P
3. */
     y9 M8 ~7 b+ @4 ^: `  T2 T. m+ j
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   
7.    
   6 d& M" R0 J- X5 n- ~8 F8 u
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   # d9 {: L, `1 {
9.     try
   ! Y- k* ?1 _& U& e% {  v$ i
10.     {
    ; }0 c$ E6 n% d: h7 s
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    ! l: A! f% t+ O6 i4 g; |
13.     catch (Exception e)
    4 d# m( ?# r! L) _
14.     {
    - E! r7 F8 Y* S0 h0 O) r- `
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    2 m* _0 i7 G- ]& B' l
18.     getInstance().report();
    5 a# ~# W' S1 A, p& @# y, n
19. }

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

Метод unloadAllScripts()
% s6 C2 y9 ^/ S/ J0 T

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   % |# {) |' O, h0 |, g0 \
5. {
   " F4 B5 I, E" _6 Q% a
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   1 S5 p0 l, n# E7 L: k
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    3 T* T" }; x$ o7 a
11.         if (quest != null)
    0 o: |& S( f) O: l
12.         {
    % G3 W$ F$ |/ G- x& o8 N% y
13.             quest.unload(false);
    
14.         }
    8 F9 N% V/ y/ h7 {
15.     }
    ; y( G& O& P0 C6 _' b
16.     _quests.clear();
    6 ^6 k: X1 R8 e! s+ B! Z3 h* I
17.     // Выгрузка скриптов.
    ) p; ]3 l  A3 q0 p, `: K( u6 Q) G
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    * i$ |6 ]+ C! d3 |% F
21.         {
    % ]6 d" Q: c% m5 y9 F+ K
22.             script.unload(false);
    
23.         }
    
24.     }
    
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  

Метод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   
5. {
   . O! S; i' J$ W5 {
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   2 d0 G$ O  c# @
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
    q2 S  |3 f1 ?; u- I

Метод getQuest(String name)

/ P" ~+ E; j# G$ W

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   / \  t, l# {2 ^) H: h" O
6. public Quest getQuest(String name)
   ) s. y. {/ B# x6 p
7. {
   & k4 R# |0 }4 F8 a5 s/ [- M
8.     if (_quests.containsKey(name))
   
9.     {
   " N( x" L, U- W3 ~$ C
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

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

Метод getQuest(int questId)

1. /**
   - P3 F% `6 @" G" K
2. * Получает квест по ID.
   5 d  g) a0 X. O  R% W# y5 E: S, j
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   8 G( N, u8 b- S" v
5. */
   ! ^/ ^  R& n1 O
6. public Quest getQuest(int questId)
     k1 E2 ]4 ?& H
7. {
   2 D9 Y, Z1 K" a5 I
8.     for (Quest q : _quests.values())
   , \: _4 R1 r3 k: X, n1 G/ s' c) S
9.     {
   
10.         if (q.getId() == questId)
    - k. A  j& b. v5 X0 V  x6 o* _4 q
11.         {
    
12.             return q;
    - [" b7 s$ y5 d" ^& V9 E
13.         }
    , U( L7 E. b% \: S" `9 M0 Q' c1 i0 D
14.     }
    ; o0 _1 n: ?1 m2 v
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  0 K9 S8 ]( T( F4 b

Метод addQuest(Quest quest)
- W5 S( v7 T9 [* R' U

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   ' J2 ~6 C" P/ Z4 ]3 G! J
4. */
   . u' e! Z+ @; W& A% C2 P2 I
5. public void addQuest(Quest quest)
   $ Z. E* X$ \. c3 Q5 I
6. {
   " l8 C$ c/ K5 ^0 T  f5 U
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   2 L2 d2 w9 w" Y# b9 l$ I' n1 L! C
10.     }
    
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.     }
    ' J. K$ F: H! _# U% N8 [
18.    
    . y. x2 G8 Q  _# T
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
      K7 `0 e( ?1 j* \
24. }
    ! V: z( g+ |! Y* L, ]
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
, B" s! v) b8 q0 F) ~3 DЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.

# \: m5 U: G0 q5 ~4 x8 }
$ f* K; z" i0 d3 |# R