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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
/ W# j/ [. R% c# U
- m6 |: S% T% }4 hРазбор файла QuestManager.java
+ a% b: o. B, l# F* H$ }' L( F
Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  ! z) j: h% x% b9 ]1 R
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    & f# O' `( t2 x1 e
• Импорты
  4 m) T5 w2 O2 Q) Q

4 I; z4 p' a& }; H% C0 eQuestManager.java — управление квестами и скриптами.
. G" y0 L) s; v7 u4 |Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
" j) j* f- r  J& O% Q8 }
7 `' f1 t! W  y$ _
7 ^! N: e* B& ]& f! D# \Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   9 m  ?, ]* r% o+ m
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   - e) O# j1 R' k8 P: ]& Z3 }
5. * её в соответствии с условиями GNU General Public License, опубликованной
   $ k7 d/ D" L# W( `+ z! P
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   1 Q0 u4 s7 ^9 ~! S* T
8. * Эта программа распространяется в надежде, что она будет полезной,
   6 S" J+ g* d/ z2 H9 n
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   ; |3 E; o. }& y" O
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    # y( j) Y" f: g' [' u
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    : M$ |0 I: a# n  g. p
13. * Вы должны были получить копию GNU General Public License
    8 c- t, r& G* Y; Z
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    3 f9 O: S3 N/ L9 A: f/ V/ A
15. */

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

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


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

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   5 O! H% e8 a$ j
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   & k1 {/ K' u/ F( D& D6 w
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   # j  B# ^1 |: h+ w
10. import org.l2jmobius.gameserver.model.quest.Quest;
    ( `; \; M) R$ a
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 — менеджер для работы с игровыми скриптами.

: M6 V& b3 h. S) `5 S5 V3. Описание класса QuestManager

1. /**
   - W$ L6 d- o! V" O# L' k' ]  Y' u
2. * Менеджер квестов и скриптов.
   / z* {! n* l- G2 H
3. * Автор: Zoey76
   
4. */
   " G, p" u# a3 ~1 A; U' O
5. public class QuestManager
   
6. {
   4 q# A, A3 r& y8 G- z) b7 Y; _
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   ; C( O0 p" V9 {' Q/ A* Y
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    2 C% b. e6 {$ L5 U# ^. X4 [7 A4 ]- J2 W
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    : B1 k& b1 ]( h
13.    
    6 T5 Z/ p% j/ z
14.     protected QuestManager()
    
15.     {
    
16.     }
    - j+ z& u5 }2 u. L5 }$ ~, d, g
17. }

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

4. Методы
Метод reload(String questFolder)
. N0 }' z+ u1 y

1. public boolean reload(String questFolder)
   & w1 @0 U+ E: z7 @- h
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   ' L& c; X' i' c3 f! ~/ Z0 B
6.         return false;
   - A- R( n( @. l* Q
7.     }
   ! ?- m+ H1 Y3 ]7 @* C8 ~( Q# p% r# o) m
8.     return q.reload();
   3 {% V7 y, `1 C9 P2 ?
9. }

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

. y- B4 R$ ]( S1 T* C9 fМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
& o2 K' I* l* Y% R" t: n" w2 sМетод reload(int questId)

1. /**
   , ^* M% Z  R; @% ^; i* t
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   
7. {
   6 Q! T/ v# Y0 m. b- @& Z7 ]9 b
8.     final Quest q = getQuest(questId);
   ( g! E6 }0 g% b% x
9.     if (q == null)
   
10.     {
    2 y, K5 Y7 Z- J  J
11.         return false;
    
12.     }
    
13.     return q.reload();
    . a( N9 K' N8 [. `
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  9 _8 o5 P* t! u

. ?+ J: D5 M/ I7 z9 \  h9 F/ g- {Метод reloadAllScripts()

1. /**
   4 O5 W* W) Z' Q
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   9 P) j, w. A. ~" C( A% R$ V
3. */
   
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   
7.    
   / ?- v5 @5 q; ]: z$ X
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    + e, e, f  }& k9 H! |  K& d
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    9 g$ L+ ~' g5 t: w" j
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    3 E, w& w, u4 V# c, }8 T
18.     getInstance().report();
    & w0 J6 ]" J6 _& i( S, o
19. }

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

Метод unloadAllScripts()
  {  y( o, ?( T8 ?8 w

1. /**
   . ~7 n7 ^4 ?; A: Y; U
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   ) F% v) W1 O* w
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    $ A; ?/ a- n2 z
11.         if (quest != null)
    & p: X, i; _# \) S
12.         {
    
13.             quest.unload(false);
    & J/ z' }0 M& z3 O. e; V
14.         }
    
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    2 P7 V7 P; l# ^, g* C  T9 h
19.     {
    
20.         if (script != null)
    . w6 c) L5 s* _& o
21.         {
    
22.             script.unload(false);
    2 y) D0 v7 h- P. b9 x
23.         }
    # @* N# \' a: \( C
24.     }
    
25.     _scripts.clear();
    4 I  E0 d* ]8 B6 A2 B, d6 Y# F
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ' p; Y4 @- O4 l/ n8 @$ p

Метод report()

) S8 A2 v  j* C

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   / U* ?( N# x9 o% I* W7 K
3. */
   
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   ' x; N" n, l- q4 D1 a" E3 \
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

Метод getQuest(String name)

! U: B- s5 u2 k5 ]

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   - A7 [( [) E  j9 l) E; ]
5. */
   
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   / _$ Z& w3 U! \/ P( P
9.     {
   % k" @3 V9 [2 D( L) ~
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    " l9 d! A% ]# @4 f' ]& ?
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  ) _9 j- B% W4 g. o" R

( W6 v' L- ~, `, j8 E. [' V" KМетод getQuest(int questId)

1. /**
   8 @, L2 [/ u- f- s
2. * Получает квест по ID.
   1 m( Y) q# r* X: {  Y! |0 C
3. * @param questId ID квеста
   4 [; g+ I7 o9 E% W6 r$ n; G
4. * @return квест, если найден, {@code null} в противном случае
   ; S; c; U+ W. P5 ~( Z
5. */
   
6. public Quest getQuest(int questId)
   8 Z) _$ R  h" ~  ^3 \* |4 r
7. {
   $ P& t/ ?) M& y% {. D  l
8.     for (Quest q : _quests.values())
   
9.     {
   ; U) B( G) l# o  e7 h' T
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    9 j2 L  D) T8 Y$ h: o. P4 m5 q
13.         }
    
14.     }
    9 j* x( k/ H* {: y% n" p
15.     return null;
    " P: K9 U/ U+ l1 m
16. }

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

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

# \" ~$ ?8 Z* i" `# WМетод addQuest(Quest quest)

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   6 _. V. f1 [! |
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   ) c$ M$ E: J& p! W
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   3 ^+ F0 o  z! ?/ Y& F3 G/ g# C
10.     }
    & I( v4 g" f, Y
11.    
    2 E+ ~! a( {8 ]
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    - Z2 r2 Q5 Y* b0 [3 Z$ @% ^
14.     {
    $ K; O8 l4 D9 Z* U
15.         old.unload();
    ! C9 ?3 f: H0 ?2 V. @
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
      C, U, p/ S; n. X' e+ L, L
17.     }
    5 i% [( K6 `4 j" J1 t, Q5 c
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    2 _- z3 k8 I) S* Y
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    $ Q$ t! q: T! m2 D9 ?
23.     }
    $ z8 P2 W, o9 K
24. }
    ; p- M9 w. x0 T! y  ]" s3 v% {% j+ q
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
0 p1 ^' m% w! j5 {. J
9 P. c: l8 B; P& Q