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

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

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

4 ]1 q  s; G0 [7 AЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
$ S! g" w9 O$ T' v1 H2 u5 ZОсновные элементы
0 B* {, x$ T$ X- [( z

• Лицензия
  8 b$ U: V! _( c2 N% l
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    & S) P" j, e) ?7 L9 R2 j
• Импорты
  $ y* h+ q1 W# N( U5 ]

QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
8 n  P# u$ o' w5 S8 v  C
- Z7 S" N3 |6 K+ r
; U3 R/ B! P& p/ N9 }' T5 }Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   ( u- p8 y5 h: T
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   , Z9 W* k: Y- s; P6 i7 [8 L
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    & I. O$ P, r6 T) ~2 s
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    3 ~1 t9 S3 l5 B: k  `( ~9 H
15. */

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

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

1 K, x8 y/ K5 P8 ]! `5 \
2. Импортируемые библиотеки
7 u! M, S/ e6 J0 A# G% t* d6 j; r
; W8 y( ]1 x) ~$ z

1. package org.l2jmobius.gameserver.instancemanager;
   9 ~1 j: N$ u+ \- j0 t
2. 
   1 y6 w* }* E6 y* V
3. import java.util.Map;
   1 h9 i/ G2 N$ S5 r$ t5 [' U
4. import java.util.concurrent.ConcurrentHashMap;
   " h9 ]0 q! ?2 G  N8 w0 }& s
5. import java.util.logging.Level;
   # G# C. b& m! M# l: X
6. import java.util.logging.Logger;
   
7. 
   3 j/ I  u  Z: w) S7 ^
8. import org.l2jmobius.Config;
   : A  a9 l$ j2 x" O% W
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    + {% V1 k! h7 W0 w! ?
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 — менеджер для работы с игровыми скриптами.
0 ~5 V7 O" U& D4 U  f
3. Описание класса QuestManager
8 @9 `) j& r( n$ m/ _$ o

1. /**
   
2. * Менеджер квестов и скриптов.
   # F0 I. C$ l! J3 V
3. * Автор: Zoey76
   5 b) c# A  x  Q7 j2 ?0 j
4. */
   
5. public class QuestManager
   : Z" k- R# R1 C
6. {
   2 Y2 E* }% M- Y. }) \( W$ m
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   # S# a/ c0 W! z* h+ k
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    
15.     {
    
16.     }
    
17. }

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

4. Методы
" Q( r3 \3 }: a+ Y& q/ ]! rМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   
2. {
   ' X1 \! c0 q% f; j  i
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   ; }3 B4 i- k6 c1 p8 {! A  N5 J: v
6.         return false;
   ' m$ M; v3 S, l2 o8 A( K: a
7.     }
   
8.     return q.reload();
   ! W+ S$ Q& g' ~
9. }

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

4 i6 o: \0 S5 v/ n+ Q
* ^% d* S$ k, d7 M4 ZМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
+ a9 [: A% I5 a( t5 \1 y2 VМетод reload(int questId)

1. /**
   # H- n- Y# N- O4 Z+ u: k. J5 ^& J
2. * Перезагружает квест по ID.
   ' z7 c/ K. s* ~5 j( U5 K! u1 E9 d8 P6 ?
3. * @param questId ID квеста для перезагрузки
   1 T# H! C1 K  G/ G% K
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
      A. l8 ^9 Y$ q( v3 S
11.         return false;
    - G3 z/ T2 x# o& D9 Z$ j# @
12.     }
    
13.     return q.reload();
    : {1 ?& x# b& Y& E5 g
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  8 O3 ]5 ^  Z/ J, r7 T

Метод reloadAllScripts()
+ w' d9 _  Q& s) W0 Z
1 Y8 Z5 a) Q1 O! ~# z

1. /**
   1 b' s& l3 h; u9 k
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   ' \" {+ E: X/ M4 y( b* q1 K
3. */
   
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   - {; x% V+ C+ R' \5 X$ o
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   2 l6 r7 I& V! t1 ~
9.     try
   8 W0 F5 Y0 M$ F/ O, V/ l# w
10.     {
    / \! R! G7 I4 A5 G( s' P$ r+ J
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    3 Y5 H6 H0 c7 j+ G( n) ?
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    , I4 x5 r8 W- P
16.     }
    & I3 M* z) ^  v  D7 N. j
17.    
    6 ?% t3 H# W1 L/ Q6 K1 h" h
18.     getInstance().report();
    : D0 h6 ?; z* Q$ {% {0 q# H9 l
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   % }, l) e& ~; \+ d) Z
3. */
   
4. public void unloadAllScripts()
   9 p0 a; U: S+ {
5. {
   ! M+ U$ A/ F/ [2 r7 {0 p
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   ' _1 I5 C; `4 x6 L1 g' L1 _
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    : X5 ^4 [6 e: [# l
14.         }
    9 a, Z8 ?9 Z! y
15.     }
    - b. D2 j  J) k- B3 ]
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    ' L/ y$ _8 F( U3 ^9 X& f" y
19.     {
    
20.         if (script != null)
    
21.         {
    & Q$ g- j9 G: g. j; j
22.             script.unload(false);
    
23.         }
    
24.     }
    ' O; b! w" _5 ^+ {# s, G8 _
25.     _scripts.clear();
    ' C; B( a3 O- @  t; d+ G. ~: s
26. }

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

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

* `$ m0 I' H6 @5 hМетод report()
+ D1 a7 L$ Y. n# Y7 Z
" ]: v; A7 M+ i+ v/ L) o1 ~5 H, @

1. /**
   + M. z. f8 Z0 ~( v$ Y9 K7 j: r
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   
5. {
   5 B  j0 {& W5 x* @4 W% c
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   " ~5 x0 N# S5 Y; t8 L4 O, {. E* \
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   ( W6 j3 {( X7 c" \& |
8. }

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

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

9 w) p0 H1 [8 ~! _6 M1 u! T! QМетод getQuest(String name)
7 O. f- S( r. T- H% h2 d  u" U

1. /**
   
2. * Получает квест по имени.
   " e: [* D' j8 O1 S, ^
3. * @param name имя квеста
   4 p. a, ^$ K5 S7 U( j2 ]# t" g# V0 g
4. * @return квест
   " Y0 ~. ]1 ~+ t' o) ~9 S
5. */
   
6. public Quest getQuest(String name)
   : F  s. X# k4 T2 B! b# ?4 k
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   ( j5 y3 c9 c0 D) B. I% K% a  g
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

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

Метод getQuest(int questId)

; }- B, L- }0 o; W

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   & q$ n6 i8 t3 @! |
8.     for (Quest q : _quests.values())
   8 g1 _+ Z5 U" e2 w7 q
9.     {
   
10.         if (q.getId() == questId)
    ' i: s0 y. P  {8 k
11.         {
    
12.             return q;
    
13.         }
    ( J9 y5 E0 m5 A( R) A
14.     }
    
15.     return null;
    
16. }

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

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

Метод addQuest(Quest quest)

0 U+ a& I/ G# ~) S

1. /**
   ( T& U- D* _  S! ?; s
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   0 v& C/ a0 j  }+ L7 A' t
4. */
   8 F6 z3 t1 g) y5 `+ C
5. public void addQuest(Quest quest)
     ?6 g+ M  ^2 O) J6 v8 k6 [3 P
6. {
   3 a: I& B; v) @8 H- d1 G. u4 _! @  u
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    + @: P8 Q; f( n' G  e6 e4 |
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    * c4 |% a" X: v8 c
14.     {
    8 g! _& [6 Z% i) G# O
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    5 ]' w- w7 @. ~$ e5 j
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    . W% ~5 ?/ ?- K4 ^$ i4 z2 ^
23.     }
    ' G& |2 a  Y! M) n  w
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
* u8 t& f- H& S2 {ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
4 b. ]. K0 o9 _' T5 e

1 b' o/ u9 f/ _- j% a" r
& O1 v( n% [& t- }5 j' e+ Q" E