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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
1 J' a0 c0 A  r( G# A# B
+ P/ A/ |3 f! X. L3 }8 A5 nРазбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
9 g4 j1 A! u# D) B' k# [5 PОсновные элементы
; A' p2 i" `  ^) _

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  5 J  a  a- n4 ]& N

QuestManager.java — управление квестами и скриптами.
+ Q0 r5 W( H  K9 ^/ VПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
3 F( L6 G; C2 q; I! |! f* y1 A! `5 d

Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
  J  _2 N1 _2 Y- r1. Лицензионное соглашение
9 d! T& Y9 v1 V" f  t

1. /*
   8 u' m* U& G! `  E( v0 O( Y+ o# ~! P
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
     ?  V  y6 e3 ]* o3 L6 j
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   & O  O) ^0 C) I+ b, b
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   " [$ A# u  r( w! h; D& \$ T1 Z
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
      e( ?8 b5 k" Z- C2 L) Q3 x0 u
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    + k  T' C; v6 u3 `2 r- Y
13. * Вы должны были получить копию GNU General Public License
    / X! D1 `* R! B: L( d
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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

3 m  P7 H' R+ S/ ~+ v9 p
8 u' U5 q6 k% b& f5 O3 i2. Импортируемые библиотеки

6 ^) U7 W" q7 Y9 E' B. G! S

1. package org.l2jmobius.gameserver.instancemanager;
   % C* T; i( h% h% o- R
2. 
   
3. import java.util.Map;
   : h+ M% }; s1 n- \$ C& H
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   ! |. C2 r1 [2 |; c
7. 
   
8. import org.l2jmobius.Config;
   
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 — менеджер для работы с игровыми скриптами.
, d- Q2 N9 {+ q3 U/ z- L
& ~% U1 J# l/ v1 h& o3 t3. Описание класса QuestManager

1. /**
   
2. * Менеджер квестов и скриптов.
   $ F$ \) ^* G2 }" v# Q; \( L- d
3. * Автор: Zoey76
   ' b& G3 m( N' e4 P
4. */
   8 Y, O' P- N! q" j0 Q! G; c% l
5. public class QuestManager
   2 r+ U8 l( G; @3 |$ T8 t" p
6. {
   : \) D% Q4 g) R  \+ w5 @$ w# a
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   / C1 r1 O0 V6 b/ z
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    6 p* E; a/ i: W) s% m
11.     /** Карта, содержащая все скрипты. */
    " M) I; O. c" U5 ^5 w; _* p, L
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    ! j! H7 r, L2 I% {& A/ p1 _8 w
14.     protected QuestManager()
    . o; f: U  Y$ t/ s7 R
15.     {
    
16.     }
    
17. }

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

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

1. public boolean reload(String questFolder)
   7 i3 K5 m/ Q; l
2. {
   ( Y* \/ T4 K9 F& N0 R
3.     final Quest q = getQuest(questFolder);
   8 j9 E' \6 m* t3 Q; [
4.     if (q == null)
   " a5 [$ O9 K4 x/ T' W8 Q
5.     {
   
6.         return false;
   
7.     }
   
8.     return q.reload();
   ! \- x" z6 W% y, e3 ]
9. }

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

( t9 v9 z  ^5 p7 v/ g% Y! d# w
+ M' C1 }; i& n7 G" LМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
& L0 r, Q8 H- k0 `2 x7 _Метод reload(int questId)

1 w) M, J. C  `9 \: A5 l3 ^

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   6 w6 _6 J  u: Q1 r& A6 r
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   
7. {
   3 N3 j7 E; r6 @) X
8.     final Quest q = getQuest(questId);
   ' }5 C# H' G# A$ Z1 k0 N9 V
9.     if (q == null)
   
10.     {
    
11.         return false;
    , w: n$ F! ]. H# n0 m1 r3 I' Y) `% |
12.     }
    
13.     return q.reload();
    , m5 s8 m* k* a1 O+ O
14. }

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

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

Метод reloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   . F% I+ X8 W+ ?0 o
3. */
   
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   6 I. \% Q+ S+ t, Z. J6 b7 L
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   " Q. |2 B- `# c
9.     try
   & H2 M8 |  A) Q' d, |" \0 \
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    " `$ G4 y6 ?- I4 e8 U" f
16.     }
    
17.    
    
18.     getInstance().report();
    8 m( e+ y. q! [0 Y; V
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   
5. {
   # ~$ |0 S5 ]1 ^  v; k5 S
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   . g2 e1 ?( d$ ]. ]
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    5 V! n5 G' K, x0 o" ]8 f
14.         }
    
15.     }
    3 t' f0 h: T2 _5 L/ q
16.     _quests.clear();
    ) Q$ m. l1 X0 b  v
17.     // Выгрузка скриптов.
    7 f' f. ^$ g% \- Q  c
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    % w* Y3 q3 Y' h
21.         {
    
22.             script.unload(false);
    7 d: _0 Q, n+ n7 J' l6 G7 C) P
23.         }
    
24.     }
    
25.     _scripts.clear();
    . `0 D2 ~- W  M
26. }

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

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

Метод report()

0 V; F/ R' \% t+ r7 a5 ^+ X! \

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   ) y7 A/ L" L( o7 D  Z) Z1 [
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   8 I& ?1 l2 `0 {* w
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   $ N: H% @  k- B$ w1 s4 @8 G
8. }

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

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

& D8 a2 J* Y8 B0 E  W/ }" U" ?Метод getQuest(String name)
7 O6 G( h1 y( S  p. }, `7 ?

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   . c/ q! p5 _$ a3 g4 c1 d& x8 ^
4. * @return квест
   ! z; n3 v# L/ n+ Y
5. */
   
6. public Quest getQuest(String name)
   
7. {
     F4 \: a# }2 L( ?
8.     if (_quests.containsKey(name))
   9 B, s& }4 [( Q. p2 V+ H, n' J
9.     {
   
10.         return _quests.get(name);
    ! Q. t2 E% o( [; j) `  |
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  . ]# o! n5 p* g+ \# g: H# U! I

1 {0 `9 {5 Z5 K  P! }( b. B9 [Метод getQuest(int questId)
1 b  U' t0 u/ B& G, W* M
6 M0 n, T! z; D' i' K* M$ O

1. /**
   ; |0 E- y: e$ q2 X4 o
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   ) J/ [0 ]: V# P. [; K
4. * @return квест, если найден, {@code null} в противном случае
   5 ^& K# @: c9 w& }7 ?& ?6 L" o/ O
5. */
   . U& h4 r3 ~. m
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   1 v8 Y% Y' ]% e& m6 H
9.     {
   & r# O& e0 z- B
10.         if (q.getId() == questId)
    
11.         {
    3 \7 t  l7 F5 ]0 _7 \( g- y- K0 t9 k
12.             return q;
    0 D1 u' O* O6 {! u- z4 M
13.         }
    
14.     }
    + _: y3 ]2 e; v- @" Z
15.     return null;
    
16. }

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

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

Метод addQuest(Quest quest)

1. /**
   ( m8 ]* j$ s6 @' I: P
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   ; [" l5 V. D0 m8 X. t, h
4. */
   
5. public void addQuest(Quest quest)
   7 Y5 i8 d5 a6 b: K0 K( V6 D
6. {
   
7.     if (quest == null)
   $ s" n8 L+ J% p7 @
8.     {
   6 ~- Z& \$ G* n! ^& v, M, E
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    ' T2 `- ~5 A1 H3 \, k
12.     final Quest old = _quests.put(quest.getName(), quest);
    , E% b; p8 Q. {
13.     if (old != null)
    
14.     {
    : e! L3 R7 _7 z( d( W
15.         old.unload();
    + Y1 p  ?0 [1 [0 z
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    - ?) X5 {+ D' m" H9 x% Q
17.     }
    ! o) w' C0 ]+ Q+ Y: s# [
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    6 h7 q4 ~7 B- N5 F/ |
20.     {
    * W0 {& f, U6 N# L- b
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
" f9 P$ T  N! ], t; P! k/ O# p- w


( n+ \5 a& v3 I( X) Q$ W