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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
- w- [. h, U4 r# @  j6 f* H
Разбор файла QuestManager.java

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

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    " ~& |( Y" q- m6 _) R* d. ]
• Импорты
  

8 S( q. p: }; ^: D, v  w* cQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

" l: \# k! |; |! q
0 e0 I, E; L' j* Q$ L$ h* rДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
/ J# _# O4 X/ [0 h* |1. Лицензионное соглашение

1. /*
   1 b" z$ G% |) S  O% m5 M* U9 I
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   , J" V% {( x$ a/ f4 n# q9 M% `
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   8 _- `! S8 ~! E; {- O: Y
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    ' U1 x; V2 X' K# u5 g: X3 R* l% }
11. * См. GNU General Public License для получения более подробной информации.
    3 r+ ?* \. i5 ]3 V$ Z9 G) h$ \
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
# S5 f( d' v, \' v2 K- O
* k4 E& p) X$ n" d5 ~+ n$ g7 ]4 w# }- m
8 _1 J+ v5 E( p: O; @2 e0 c; X/ |2. Импортируемые библиотеки
- z8 C/ M3 S7 t1 w  o+ a" n
0 \2 u; S  g5 Y: S

1. package org.l2jmobius.gameserver.instancemanager;
   . V4 y0 u8 o2 a
2. 
   
3. import java.util.Map;
   # v. {# s  y1 z& X) E" c9 i! ?
4. import java.util.concurrent.ConcurrentHashMap;
   9 t2 U7 N+ C+ d' A5 Z0 [  p
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   4 l6 a+ Z- |+ m5 {* L( b2 H$ m3 G2 h
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   / L" e' @4 h. D( ]) M
10. import org.l2jmobius.gameserver.model.quest.Quest;
    ! K+ {" g4 f9 _) J  L& {0 B
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 — менеджер для работы с игровыми скриптами.
5 ]; z1 a3 k1 K; O7 S! \5 y
3. Описание класса QuestManager

1. /**
   5 i2 ]: t3 B8 U1 B! X
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   
6. {
   + K* y! @* N# p+ g& q0 r- X! M
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   6 T, N* X8 l) f1 o8 W$ A
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    ) ?( O0 [# J- g) M/ s! t4 \( C. s
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    9 a( R) i# m/ i% u
13.    
      C( N+ K: I' j; J
14.     protected QuestManager()
    
15.     {
    8 q* l7 W5 S2 |9 b9 f
16.     }
    / B* t0 D; R  S8 ~, v2 d& F
17. }

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

4. Методы
Метод reload(String questFolder)

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   8 \0 v" T# ^& T( |  u
4.     if (q == null)
   ( ?+ a! H4 ^# p1 B, N
5.     {
     e; w* G" p( M% H
6.         return false;
     }* v) k* x2 q; [: w
7.     }
   
8.     return q.reload();
   4 K. {, x0 O7 K+ J  P
9. }

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

8 J% s, b/ H9 L  W" b4 Q' zМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

1. /**
   , {) x. v& D/ s8 K5 K. M: B
2. * Перезагружает квест по ID.
   - r6 K9 u- x% z& r
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   1 H; `8 N9 i  k# U
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    
11.         return false;
      P9 y: Y2 s4 v6 `; h+ o# g
12.     }
    
13.     return q.reload();
    * z; @, f( j# o! X) T. j8 M" n3 D
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  ) N* k6 S$ @+ |! z: S

% Z- Q4 u& R( m) gМетод reloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   9 W5 U3 U2 I. v6 m' d. l# {* Q
5. {
   
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   8 i$ ]2 B5 B1 C% P# C/ T9 a
9.     try
   
10.     {
    + F( h+ i  P6 }3 s% d6 G
11.         ScriptEngineManager.getInstance().executeScriptList();
    ' y8 h" }5 C# {; K
12.     }
    
13.     catch (Exception e)
    
14.     {
    $ u: v" w% p5 K* d: R7 W$ g
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    % Z* X1 o( m5 ]6 j5 y; P
17.    
    . \+ e: h$ s) c" k6 Z! u
18.     getInstance().report();
    9 J# U- h. ^2 L" X4 h
19. }

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

Метод unloadAllScripts()

1. /**
   . V$ A8 U+ `, \- X/ R7 t
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   / a: z- h: Q, t! ~
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   6 w; \# O' j& b! ^9 z- C( v
7.    
   
8.     // Выгрузка квестов.
   6 Z( B. B$ ?( \) O; b  r
9.     for (Quest quest : _quests.values())
   * ^& S# b+ o' D
10.     {
    
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    $ v3 h( [8 ?4 R  r
14.         }
    " J. S! f' f3 H+ H
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    6 p0 ?3 X5 V) v6 Q7 }1 ]- J2 ~
18.     for (Quest script : _scripts.values())
    " v6 ~; W2 ^' \" u+ S% y2 }! j- {
19.     {
    
20.         if (script != null)
    
21.         {
    : _% ^0 K6 |! G' s% D- A
22.             script.unload(false);
    4 E3 q4 ^. s  [7 L! \" _! _& H
23.         }
    1 j% u# s# d5 `1 f
24.     }
    , \3 z* e2 Q5 x8 [0 b
25.     _scripts.clear();
    
26. }

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

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

Метод report()

1 r+ I8 ]/ Y' y9 U! E

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   ) b- b; {6 t& v; D
3. */
   9 D2 ^; O0 b/ V4 O7 h
4. public void report()
   
5. {
   ! \8 v+ c/ k6 E( \/ O/ E
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   ( d. K, Q1 G2 U6 S& }; W# a" _
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  4 v1 o% _8 R  H! C- P3 Q7 H

0 ]2 m+ T# f  N. e( z' j! E( ?Метод getQuest(String name)

1. /**
   % f' i' E' [9 `2 W. \: Z
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   # K2 `% ]# R2 |1 _$ q
5. */
   
6. public Quest getQuest(String name)
   
7. {
   8 v; [7 v+ k3 \( n/ M2 |# F% o0 s3 Y0 G
8.     if (_quests.containsKey(name))
   
9.     {
   ) }5 `' M1 K5 }2 C8 K0 _1 E
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    4 {0 h* ]* [; B  ?# n
13. }

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

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

Метод getQuest(int questId)
4 A  P* A. \  y& {! {

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   5 E( C. b3 A: [2 B% I6 D6 K5 a* ?
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   ) J. Q& D5 z" q6 `! E9 V$ W) Z7 H
7. {
   , g6 [: c4 N0 L& z) q1 M2 k
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    
13.         }
    1 M1 D/ n' R' U( W2 r" }$ q
14.     }
    
15.     return null;
    7 y. R& Y; t8 q9 n; [% {9 i6 q. ^
16. }

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

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

Метод addQuest(Quest quest)
+ q, F) t* l1 S+ ~
0 M- B1 e2 |; y7 Q/ s

1. /**
   
2. * Добавляет новый квест.
   4 \8 N% ?7 s% O0 b" {
3. * @param quest квест для добавления
   ' w7 n7 O& X" p
4. */
   3 D3 \/ w* G: s0 g9 p7 W
5. public void addQuest(Quest quest)
   
6. {
   ' ^7 w( {0 x% [3 F" V8 p9 F9 Q" ]* g
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   . i, f( U& K, i! X2 ?" Q
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    9 ~1 U8 i! s  C2 B7 `  M
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    2 v3 k0 a, c* C+ t( l0 S
17.     }
    
18.    
    ' I, {5 y8 n; \
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    ) I+ S1 h$ e2 I
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    # Q& ]  B; ~4 Q: _; |
23.     }
    
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
$ s/ W& u; C6 P, K; F0 {1 h  PЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
; e/ Y4 C+ V7 d' c0 k


# A+ U8 W5 y; N+ \$ V