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

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

  j2 w# L. J. r' nРазбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
* a* N! E6 Y, p! M! `; j2 z

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    3 B2 i; G' G* Q4 Y
• Импорты
  

QuestManager.java — управление квестами и скриптами.
( a9 Y4 n* D. X& ^9 a0 X; RПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
; P" r  e2 {' D7 z+ m; k% K

Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
- A. P2 N0 k9 Y; q+ m+ ~& `2 a1. Лицензионное соглашение

1. /*
   & x6 ?' N" G" Z0 Y: C# z9 C/ p
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   + t" v  H) ?  z* `
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   ( Q2 X8 h$ T* X) R* ~8 Y1 i9 M
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    3 v& ^* Q% o3 V; m2 X+ ~9 l
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    " A. N, D% O5 K9 S' R
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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


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

$ }! O6 u/ g& G

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   & T! ~( o% d0 b4 |, U
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
     r9 c4 G7 ~- [, f6 K+ O* H% v
7. 
   , Q0 M5 H8 F& S( s# A
8. import org.l2jmobius.Config;
   6 d4 q- t* V" q
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 ~1 O$ q7 F7 u3 ?% Q: b
3. Описание класса QuestManager
: C4 j! T9 G4 q% ]* S) }( t

1. /**
   # u+ S# C6 B+ k5 E/ Q3 o  j$ D
2. * Менеджер квестов и скриптов.
   ( t- X- _4 H8 d0 V3 K
3. * Автор: Zoey76
     [: |/ \9 K: B
4. */
   % Y) ^" h: g5 [* M$ k$ \$ @
5. public class QuestManager
   ; b5 r/ Q/ o" g
6. {
   : F( U2 `! J: h: A' _( D* R' d9 r. v
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   * t& _( r6 l0 Z
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    ) s, W2 z( z# o$ q( F( h, z
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    7 V- p5 `; ~! _2 J& [- V& H
13.    
    
14.     protected QuestManager()
    
15.     {
    
16.     }
    ; T$ T6 I" m5 i2 ]# B
17. }

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

4. Методы
Метод reload(String questFolder)
- \( j* Y  `0 ^" U, p  }

1. public boolean reload(String questFolder)
   5 D0 X' D: f+ a7 g2 h
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   
6.         return false;
   
7.     }
   
8.     return q.reload();
   % r  A/ N7 I  y" Y8 d5 m; A
9. }

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

3 o  T1 T& |- i) e. J& A' qМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
- h/ z% L& s7 n6 I3 ~- n) R0 o
' y8 u+ e1 L8 X$ C  B

1. /**
   . b6 N; W5 J: E1 E
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   ! Q8 m( ~5 k" y1 A
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   " ^/ i: C4 ?' ~' A
5. */
   
6. public boolean reload(int questId)
   * l& [5 s, K% `. e" D
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   % j$ j3 S& h+ n+ `4 t( A
10.     {
    ' u! b, q% V" z% ]
11.         return false;
    ' x1 @8 K; [/ G' m# y& f0 P
12.     }
    
13.     return q.reload();
    
14. }

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

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

Метод reloadAllScripts()
; ~9 c& K% c3 v* L5 g) T
5 n/ a/ r7 k/ G( S, E. _

1. /**
   8 E7 N% W* q  C5 Y
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   # A+ O! ^+ E3 u  N3 f7 h
4. public void reloadAllScripts()
   6 @% A) L' Q- R% w( a
5. {
   
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   # i7 J& E; L( \4 Z* I  K7 d
9.     try
     p& Z4 |3 ~9 L
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    , S' B1 \9 C6 a+ o
13.     catch (Exception e)
    
14.     {
    7 ?( I! I! t9 g, r& H
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    2 U8 J4 I1 [* q8 E6 R
16.     }
    
17.    
    ; Y; N1 D2 z1 Z6 n; m4 t
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

0 h$ w' Z& W0 l. J. G

1. /**
   0 f7 _" n7 q  [! i# v( S
2. * Выгружает все квесты и скрипты.
   6 h9 @6 w; J8 f! x: A2 _
3. */
   
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   0 J2 N  C6 K7 q
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   ; N4 p) k5 u- g" v$ l0 I8 _0 L
10.     {
    ) G. Q( A- W6 k; K# n2 t& V' U
11.         if (quest != null)
    9 O) S' g& I5 R
12.         {
    
13.             quest.unload(false);
    ' d( F+ F. S+ E' a7 ]
14.         }
    
15.     }
    
16.     _quests.clear();
    : C) U5 b- _: a
17.     // Выгрузка скриптов.
    * Y( V  a- ~" k3 [  Y
18.     for (Quest script : _scripts.values())
    
19.     {
      Z! G4 T+ H3 b  d
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    
23.         }
    
24.     }
    / P4 A; ^+ f0 ^  S
25.     _scripts.clear();
    
26. }

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

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

3 }3 n( n! P+ W1 w" K% i1 UМетод report()
$ e4 ?  t. ^1 d$ _$ }
/ t9 V4 _0 n  d" r. F) ^) e

1. /**
   ; W2 x9 Y) m/ l) E
2. * Логирует количество загруженных квестов и скриптов.
   * `. W! }9 g' H  U
3. */
     q: N# X. L; `  E
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   " ^8 O' v2 Z0 M0 A
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   # N, {- S9 r) i- w  [  N3 X
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  6 D; r; G) W4 Z- _2 h2 a( I

Метод getQuest(String name)
& i. d% ^+ u! ^5 }5 ]
1 i$ h* X2 m. k3 A

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   4 _% M4 @/ q, Z
8.     if (_quests.containsKey(name))
   ! U  X2 p. {# \% D
9.     {
     z% C5 Z1 r6 u+ W0 l; g
10.         return _quests.get(name);
    
11.     }
    " c7 V( ^$ I& s: D# @1 R" ?
12.     return _scripts.get(name);
    & a6 ]0 _' p+ X- W& ]
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  3 l: N- B. t. b5 I" K: J2 g  l0 {; A

Метод getQuest(int questId)

& ~1 L7 M( X( W; R3 K0 `' O+ |8 [

1. /**
   
2. * Получает квест по ID.
   ( g! G  C: q% n6 z/ o5 m
3. * @param questId ID квеста
   " [" T; q# T6 \# C8 T' }- Y1 `
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
     N; ?' L1 ~( y/ h
6. public Quest getQuest(int questId)
   $ b$ Z# V( f( @/ G* K
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    * B' l9 N! e6 V1 [
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    ! F- h! q7 K! I
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  / N2 q; ?: m/ |

- ~) `. x) y5 t/ zМетод addQuest(Quest quest)

1. /**
   
2. * Добавляет новый квест.
   4 O( X, M4 M. x
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   : p* R& g+ \0 V6 ?+ t
6. {
   
7.     if (quest == null)
   ! A' S3 [. R+ @3 V* |$ D
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   " X  A$ j  O1 V" A8 Y
10.     }
    1 l+ f! e& t0 m5 v# y
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    * X2 j/ N; r' l
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    5 i7 k) v8 }$ T( T, ]6 D( S
17.     }
    
18.    
    7 \7 l: V6 K) ?7 R/ N
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
      s: m) L! v9 Y5 C: v4 d6 l, X
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    6 [1 T1 L& _; L3 @5 c3 W- X
23.     }
    " d, C3 o9 w) N2 H6 [9 W* T1 g
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
' A( e1 l+ u4 M" k6 \ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
4 Q; i- f/ O7 z
' q" u( j6 m3 p; P( X& {