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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
& e9 X% s3 K9 F7 Z, b
Разбор файла QuestManager.java
; ^9 \! h% i1 g% m  F2 `% `
Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    8 Y" e# Z$ T: b. R+ l: \) K
• Импорты
  

9 v& N+ i; @3 XQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

, \9 Z9 E- J) R- S8 i
8 ]0 ?6 w2 y& @4 Z* V$ p* p* v0 `Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
2 j6 j9 Q: ^) ]. X+ N% j

1. /*
   ' k9 c6 A# O. }! t3 K
2. * Этот файл является частью проекта L2J Mobius.
   6 ^5 U, N, f6 ^" M
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   - h1 _8 \; w! a: c- L
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   : `4 I9 k# [0 Z# w$ B& q
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    % N" n. A* W$ Q* x5 H# c
11. * См. GNU General Public License для получения более подробной информации.
    ' i" r, i' j. n% s
12. *
    ' o2 `3 F) t  {! `- E( i) H
13. * Вы должны были получить копию GNU General Public License
    % w1 z% e5 P# C4 }8 }( ?6 ~: ]
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
1 @& V0 Y; j" P$ a5 A0 x
4 w& X, Q/ r9 j$ K% t5 s
2. Импортируемые библиотеки
% U. W# x' F! C' Z/ x
+ v" `8 u  |7 Q% Q5 w' [/ A

1. package org.l2jmobius.gameserver.instancemanager;
   + [# W2 ?9 C5 i' K6 m
2. 
   0 x, F; \2 x& H! P: |* _
3. import java.util.Map;
   8 @0 z7 N/ H: |0 i
4. import java.util.concurrent.ConcurrentHashMap;
   ) T/ P" K  N( Y  z6 l
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   / H0 @' T5 q2 M) V1 H4 p
8. import org.l2jmobius.Config;
   % i. V% q# A/ X5 n2 g
9. import org.l2jmobius.commons.util.CommonUtil;
   # u( l2 ]( v! |8 a8 \
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
: n1 @4 x# b6 _6 ~

1. /**
   4 b1 V1 w. ]; z8 I+ t/ Q
2. * Менеджер квестов и скриптов.
   " k& }4 Z! Y% v$ ^$ [1 F, Q
3. * Автор: Zoey76
   ! v, H/ x; x2 R
4. */
   2 p# \5 A' I) o& ^" l$ E# Q
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   # a1 E/ o- v! k" D3 g
8.    
   1 {5 ?: |  _/ U, V1 P- L- j9 l4 u
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    - P( |( d2 R0 [
14.     protected QuestManager()
    3 Q7 |( t1 E1 R' ?% `0 O( Y& Y' N
15.     {
    & U& E/ P# R( R1 t6 N. p  B- x
16.     }
    
17. }

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

4. Методы
Метод reload(String questFolder)
; u& t* c1 B; j1 x

1. public boolean reload(String questFolder)
   - a7 S- a6 O0 a* c. ~! P, ^
2. {
   
3.     final Quest q = getQuest(questFolder);
   $ j7 h; A  j- Q) }+ ^' W
4.     if (q == null)
   
5.     {
   
6.         return false;
   ; s; r3 K) }  l' S$ S
7.     }
   
8.     return q.reload();
   7 V! U# o% E, r* m! s: _( b
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   ! X+ [4 S! U# h( z4 _
5. */
   
6. public boolean reload(int questId)
   
7. {
   7 _) q- W; X( P9 u! f3 @- u' n$ U
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
     _8 V$ L( i! I7 [) s( A
10.     {
    : T2 A. `2 m; T) q3 ]* a
11.         return false;
    
12.     }
    
13.     return q.reload();
    / g$ n$ A5 M3 ~& Z$ w& y
14. }

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

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

Метод reloadAllScripts()
$ I) O) r+ N; \
* \9 c; F9 u7 _- }! _6 b- i% }

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   / H0 W5 M! m) ^) ^, @. }
3. */
   0 C7 x2 |6 b& z6 {1 G6 z
4. public void reloadAllScripts()
   
5. {
   ) H  T7 e4 U6 _9 C5 b' P
6.     unloadAllScripts();
   
7.    
   . I) I& V/ \- O! X
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   3 Z: h  i) m2 K
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    # X8 j& b8 X5 [+ A% t7 q1 {4 {
16.     }
    / d' _5 H# o  z; N
17.    
    
18.     getInstance().report();
      O* s; P" a7 n8 n% Y
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   * U# P3 I* O0 q" w
3. */
   
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   * t7 k! ~" L5 G' Z( f" i1 ]
10.     {
    7 q8 {% |; Y, f
11.         if (quest != null)
    ; u! j3 j8 U1 W# K* y8 ]8 F$ S
12.         {
    
13.             quest.unload(false);
      y4 I5 z7 _- J: j6 l
14.         }
    " [4 J( v* _' j& q+ X# N$ P
15.     }
    
16.     _quests.clear();
    9 N( k8 b* \5 Z1 Z6 Z3 z5 s
17.     // Выгрузка скриптов.
    + J+ |) E) c! p
18.     for (Quest script : _scripts.values())
    ( h$ I3 y. x- ]* Q
19.     {
    ) L1 Z9 g1 j* I, C( l2 ]
20.         if (script != null)
    ; S! A2 s3 R) x5 ~* s% Q* k1 M
21.         {
    % N+ @0 g$ l1 Z/ M) U
22.             script.unload(false);
    + a0 e+ W( A) A$ d
23.         }
    3 |+ b( D! G/ g3 o* e
24.     }
    
25.     _scripts.clear();
    
26. }

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

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

Метод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   4 l8 `% @' P0 i+ M( Y
3. */
   7 V5 t! u1 E& m5 N' J) ~  B6 l3 |$ ^
4. public void report()
   
5. {
   - M& _+ X9 W' e# O8 x6 Z8 \
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   ) m! A0 p2 {- F. r( [* K3 ?- F: \
8. }

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

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

Метод getQuest(String name)
. Z4 n% z$ V1 w/ w( n6 ?$ o/ @4 U

1. /**
   4 c. G) i5 \9 d. r
2. * Получает квест по имени.
   
3. * @param name имя квеста
   9 c" J2 K1 Z+ h9 i' A) @
4. * @return квест
   7 [+ C* g$ L8 ~8 \5 y" `6 `7 f
5. */
   ( S# Y$ h' H5 J
6. public Quest getQuest(String name)
   , `( F+ {2 u" f0 ^; I
7. {
   
8.     if (_quests.containsKey(name))
   $ R* E5 r$ X9 C" F1 F, ~+ M* j' M/ v
9.     {
   
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  , {) d/ t+ r: U0 R- q7 D$ \

Метод getQuest(int questId)

1. /**
   ' m' V. V4 l+ F
2. * Получает квест по ID.
   / }+ z2 t/ d' w8 U: g" h  y
3. * @param questId ID квеста
   2 U4 t+ M* C; e, V& k0 T
4. * @return квест, если найден, {@code null} в противном случае
   / s! |. ^3 ^* Y3 m6 \
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   7 k) W' |* O- F0 |% d  A
8.     for (Quest q : _quests.values())
   ' M- F9 e  E& H1 S- M. T- |" z
9.     {
   * W3 j! o0 M# {; z5 i8 G
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    
16. }

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

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

: _- [+ j6 X+ \# L9 UМетод addQuest(Quest quest)

1. /**
   ) b& Z/ z3 P) i8 u
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   2 u7 p8 [; B1 T8 A: d
5. public void addQuest(Quest quest)
   0 p; `5 n# D0 @8 ^  B+ b
6. {
   , d, s% @0 v6 V0 q% g% H
7.     if (quest == null)
   2 r$ e% o9 D/ _9 g, s
8.     {
   # o3 F6 Q7 u  a+ x" e3 M) Q9 L3 G
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   + w, }/ w# z; L  b! R# u
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    8 T: b' b/ V. j1 C
13.     if (old != null)
    % z/ P1 T# j2 g2 S' O: H& }
14.     {
    
15.         old.unload();
    7 q0 D& h7 n5 \: i
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    + T# G# {# g* O9 t
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    6 Z: t1 Z6 r! `) g
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    # t5 F7 x$ w$ p
23.     }
    6 c8 g* t& U# g
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
+ p, [5 Z% K6 Q/ }* ~ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
! ]0 b0 E# \: U2 S% C) A8 @
+ h( S# a7 H1 M& ^$ j
6 ?; p& D. F" w# ]& @+ v- ^