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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
, G9 w( j5 m" ~  K
Разбор файла QuestManager.java

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

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    4 l( n- i1 D# v8 }0 X+ X2 c( v
• Импорты
  

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

2 c7 t/ ?  R( m5 H
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
' N& b; p3 z( b- f. F( r

1. /*
   : C( F( [/ K  i! m
2. * Этот файл является частью проекта L2J Mobius.
   4 m0 a- `8 u  ^& r! ?, e2 I6 D
3. *
   3 y  j9 i3 t3 d" r
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   0 w9 \2 r& @+ r# b9 I" R
7. *
   " U; T. [5 W6 d7 _
8. * Эта программа распространяется в надежде, что она будет полезной,
   - j3 n+ c, \# M9 C* X# }
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   / y2 w5 K- Y7 x, P
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    ) T+ u2 d0 ?6 Y; J+ f4 `
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
1 a) f+ O( g4 q# B& H0 b% h4 m4 c

2. Импортируемые библиотеки
, k6 T- V" [2 D$ t$ j* c
; Y$ g; ^: \, M( S, J7 R

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   ( a8 t4 O4 Q% o; b, I
3. import java.util.Map;
   ) a6 z$ @- }! s0 ~# Z0 V
4. import java.util.concurrent.ConcurrentHashMap;
   " O: z7 V4 S% ]0 p6 X0 ^5 X
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   9 R7 v: I" n! \  U1 P
8. import org.l2jmobius.Config;
   5 @, P0 J7 H1 j- n1 E6 n. W/ c1 }
9. import org.l2jmobius.commons.util.CommonUtil;
   ! I% H8 `) J; Y
10. import org.l2jmobius.gameserver.model.quest.Quest;
    ) `. G: l1 G) A# B6 Q: B0 K
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 — менеджер для работы с игровыми скриптами.
: g; n9 F- n+ M
3. Описание класса QuestManager

1. /**
   
2. * Менеджер квестов и скриптов.
   9 q- ?% v+ c' ~: A( u
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   
6. {
   ' M4 n$ J: Q% d* r- O
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   5 A( h  x/ W# [1 X
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    4 L, w1 R: i, ?  }. u3 C4 p
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    
15.     {
    
16.     }
    * d5 p" z, o5 b
17. }

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

4. Методы
7 i; ?; ?0 a" @7 k6 Q' lМетод reload(String questFolder)
: w% H9 z# v3 l% z/ b* w/ u& g& T

1. public boolean reload(String questFolder)
   6 e- n3 j/ v& C9 ?6 c
2. {
   " x& I) p7 C. k
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   4 a. ?5 i& n7 u& \% K* Q' r
5.     {
   
6.         return false;
   4 @: m* @9 E9 h1 u, V. l
7.     }
   . f8 u8 R+ Z; c# x# o
8.     return q.reload();
   . J3 ?, P( X! ]) M, B6 \1 O2 S' z
9. }

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

4 b5 b/ c) G+ g$ k; B  z9 i' h5 u! d; @
0 Y: y! e; E% ?8 [! gМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

1. /**
   # x$ v- V* R- P$ }/ H
2. * Перезагружает квест по ID.
   7 S4 l: }- |4 g5 e- k6 q
3. * @param questId ID квеста для перезагрузки
   3 X( j' c2 C/ A% W
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   6 w/ k/ \& z$ K+ K
5. */
   ( ]2 b* p7 h) U/ U3 ^2 m
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    
11.         return false;
    - }) I+ T8 Y& h! _9 u5 b
12.     }
    
13.     return q.reload();
    , s4 b# Z" B3 r+ U
14. }

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

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

Метод reloadAllScripts()

( R6 N" P" ]! A% h

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   7 t6 u% P% t3 ^$ l9 K
4. public void reloadAllScripts()
   # A; {% j; v5 y1 R. m5 `
5. {
   
6.     unloadAllScripts();
   
7.    
   + u7 _7 e  R6 h: {' A9 E
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   / J' F  b. V4 x( {4 P& e+ D0 K% ]# W6 V5 a
9.     try
   
10.     {
    2 k' {& _3 L4 h% P6 z, b" @, e. p+ M
11.         ScriptEngineManager.getInstance().executeScriptList();
    " `+ A* K' b. S& h7 q0 V# c! ^  A
12.     }
    7 [6 s+ i4 a  }# b0 K6 _
13.     catch (Exception e)
    % [- r( Q7 y1 b" r7 g7 T* E
14.     {
    ' W5 F5 _! C' O; e
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    5 V' S- d  t$ f6 n' u) }4 u
17.    
    0 }8 t. T; L" B6 i% ~9 X; e
18.     getInstance().report();
    , f, t5 X) m2 r1 U7 l; u
19. }

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

Метод unloadAllScripts()

% a/ S+ A8 _: O" t9 r) G7 p

1. /**
   , X0 |8 G* }+ m, L+ F
2. * Выгружает все квесты и скрипты.
   
3. */
   ; ~3 U5 ?* [  q3 r. s* J4 f# b
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   5 B2 G7 {' h! R$ C% F# `" T& \, S
8.     // Выгрузка квестов.
   7 Y) k: E# p& |% v6 n8 ~
9.     for (Quest quest : _quests.values())
   2 r* U9 G; e) T
10.     {
    ' b) ^7 y# o0 t5 l
11.         if (quest != null)
    . |4 ~$ M, x9 A1 N) ]( ^
12.         {
    5 v% J9 j  {4 I
13.             quest.unload(false);
    ( o8 A' L, v( `2 N; H6 e- `
14.         }
    9 |- }  p9 W) a- ]* c
15.     }
    2 J0 ^, N( L9 N% y, O/ @
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    . w& d/ T/ S! u' v. O$ q' N
18.     for (Quest script : _scripts.values())
    * ^* X- r$ C; h
19.     {
    
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    9 C9 i# T3 c+ p6 h- `
23.         }
    
24.     }
    
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  * e! V5 m0 ^: V# X2 v1 w! M

Метод report()
$ i' V6 w/ X* l5 J& B8 h# g6 Q
+ |" J  C. U! V/ w  B* i9 y

1. /**
   ( d, B7 U, W) v
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   , O% O  m# N2 R3 [: E
4. public void report()
   . D4 i$ ]! i* s
5. {
   % h  M5 g' Q7 D. |6 K( H
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   * k# T* U2 T& u
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

Метод getQuest(String name)

1. /**
   
2. * Получает квест по имени.
   % c  f( o5 ~* s6 A; H; O
3. * @param name имя квеста
   4 p% _5 I. T$ ^4 p6 g
4. * @return квест
   6 q& z" f2 ~' r3 p* S
5. */
   # C$ D/ B4 n- q) W$ N; K- y
6. public Quest getQuest(String name)
   
7. {
   * }( Z8 [  R5 q! q
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    # p: p/ B/ l- p, Z/ f! t
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  7 [, L& a- k4 O8 Y, Q: b

5 M, U: p5 k- a0 M5 V6 L) u' G2 zМетод getQuest(int questId)

1. /**
   7 T+ I- C% x# E
2. * Получает квест по ID.
   8 V; Z3 n6 g4 _! W% V+ U- q
3. * @param questId ID квеста
   * [' S0 C, I. Z/ E5 T
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   , y& n6 u9 I) b* _+ ^
6. public Quest getQuest(int questId)
   
7. {
   6 R1 p+ C, L& {1 U6 Z
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    ' }) D; Y  G) ^- B. p/ h
12.             return q;
    3 S6 @1 i. u% _* y5 K; A
13.         }
    
14.     }
    9 h" }% I, y8 Z
15.     return null;
    ; J8 G5 a/ I" w$ G9 ~1 Y+ i
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  9 i* q+ e( G- D+ b( x

Метод addQuest(Quest quest)
% _9 ]# C: U2 Y8 E$ o6 t& M2 W+ g
# k. {( Q, c2 m) Q+ U% q% w

1. /**
   - [* D  v5 |5 R8 D
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   ( u( A3 [# M; R* H
5. public void addQuest(Quest quest)
   9 N# d0 g- K0 L% {1 Z4 ~% t( H- L8 S
6. {
   
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   ! j/ [5 I3 a7 }  A6 f$ q. o
10.     }
    
11.    
    # i* t. H, s: S2 T1 S
12.     final Quest old = _quests.put(quest.getName(), quest);
      M+ m$ h) ]6 o3 E5 p$ L
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    . N; }, C- X+ `" r& E3 l0 H$ K
20.     {
    ' v9 R; G  s/ N# [0 t6 u
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    " f9 y- l5 u2 _6 M
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
) k) L9 l, D' m- F( \% I; fЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.

$ m; c! p: m2 `4 S

( O; ~; J; p% k5 h/ R