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

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

# X1 g" y- O6 y" tРазбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
# g" g, B3 Z9 ^, dОсновные элементы
  P1 s! q4 f( `& g3 V" T; @( u$ S* u1 s

• Лицензия
  # Z2 K, r4 k2 D! I
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    ' m; Z7 }& k) {. I
• Импорты
  

QuestManager.java — управление квестами и скриптами.
* ?- x( g* M4 R6 UПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
1 D7 _  C- y* l: y
! @' \# n8 K  m" U7 A% U- P
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
/ v& }# \7 `) I* a* U

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   + a( t: y. h" M6 u  _( n1 R
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   - T0 {% g# d! p8 m! T7 e" U
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
( R$ J  Q$ R; r0 k' Q; J
. m8 _  g) X" `4 W! n$ V& `
* r- s, l+ y" p4 _; g2. Импортируемые библиотеки
5 T6 s- k) d& X. a: [0 d* \( ]

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   ; t& A8 ]+ u. d* E
3. import java.util.Map;
   1 S1 M8 c* ^6 z' [& e" I
4. import java.util.concurrent.ConcurrentHashMap;
     N6 @+ b& v& ]. j. y$ S
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   2 C! T$ N# |# M) u: f
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   ) k. C1 I0 e/ f: M9 S. _0 u$ `2 G
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 — менеджер для работы с игровыми скриптами.
8 V. A' _/ G0 [
3 }) {, |, |7 U. U3. Описание класса QuestManager

1. /**
   * y6 L4 F" D" j
2. * Менеджер квестов и скриптов.
   + g+ [) C% |6 X
3. * Автор: Zoey76
   
4. */
   ' l3 B2 m; @  m( `8 d
5. public class QuestManager
   
6. {
   8 h6 w: K5 U- }1 K
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   4 }* _4 Q7 F5 w% P) C
8.    
   
9.     /** Карта, содержащая все квесты. */
   6 i1 K9 n2 Z' s. R" y
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    : m0 C/ ?7 \- ]8 ]& T+ D# @
11.     /** Карта, содержащая все скрипты. */
    1 Z% ^( _; a, h% R
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    + D  ]& W' c" G
13.    
    
14.     protected QuestManager()
    
15.     {
    : h  N- d" z9 {" `1 a7 z& b
16.     }
    
17. }

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

4. Методы
  V, r/ _+ @1 wМетод reload(String questFolder)
# c/ n( A" d8 w. X& q

1. public boolean reload(String questFolder)
   3 h4 M: S" [) `0 `5 C- U3 f% G
2. {
   . J  X' p& x% Y
3.     final Quest q = getQuest(questFolder);
   . Y  B7 D0 l5 n/ K
4.     if (q == null)
   
5.     {
   
6.         return false;
   
7.     }
   
8.     return q.reload();
   ( }; G4 L4 y  [  P! p1 q# A: V
9. }

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

& [8 v8 \" H! C$ J! Q! N
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
8 y7 p+ Q) n5 a6 W

1. /**
   $ t8 f% Q" N% t* I0 ^* k- o# ^
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   % [% k; Z1 W7 S
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   ( g1 O# X- T$ c# i7 ?
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   ' X: T. N+ [$ L% \' G* }; t5 O
10.     {
    
11.         return false;
    * ?' o* N: i# X6 i
12.     }
    + E$ @9 w; J- s8 H
13.     return q.reload();
    8 L" e4 f$ g5 V* x
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  ! m1 O3 B6 ]- V5 ?$ n

Метод reloadAllScripts()
3 Q: W; G+ r# _: N! N. C, U

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   7 D# k1 W6 X0 m) S+ c
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   8 k0 O, A0 ~  v1 W5 D
7.    
   + n$ }1 f4 r6 y+ v( f
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   : J" O* @" E" X% w% [
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    ) K% a, K+ D' t' j% l; p
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    ( I2 p: v6 E& Z  p! q' t
16.     }
    ! |# w- H* P& ^) v) Z
17.    
    $ q2 x0 X  O1 M
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

% e$ K/ N, R6 n+ Z* l

1. /**
   + h3 [/ d9 ^2 f3 e9 t6 y
2. * Выгружает все квесты и скрипты.
   8 R* w) Z0 B2 B6 p; j2 A0 p
3. */
   " X4 O" K" Z6 S# a8 B
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   5 c. I7 X% f" I" q( G: H0 K: Y6 F& L
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    + A& l( |1 l3 Q  o* c5 M2 {; ?6 n5 @
12.         {
    5 m  p; R( L) B/ w& I5 i& {
13.             quest.unload(false);
    - v. J$ Z" S) G" Z
14.         }
    8 x7 u/ U$ @9 I# H  f. N( O: F
15.     }
    6 p! v" d7 Z/ M! }. O7 V0 k! S
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    2 e  B' j3 f2 X1 Z( y. b
22.             script.unload(false);
    
23.         }
    
24.     }
    
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ( X' W+ g3 M/ r3 A

Метод report()

1. /**
   ' `7 |- T  ?5 m/ ~" o4 c7 O6 Y1 E3 ]
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   5 V0 C. Q; d; D: c0 e7 n2 }: ]# E
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   ) C- @! Q% d- @- r4 H6 G
8. }

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

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

Метод getQuest(String name)
, o0 N- L: E/ g, e: q" ~. r

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   ) T* s9 T9 D, b# W/ b. O
8.     if (_quests.containsKey(name))
   ! E/ k+ ?0 l$ Z" k: q( b8 ^
9.     {
   
10.         return _quests.get(name);
    : ]. ]+ N* V4 H" E
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  ! A# h4 {  |' `% J" P2 a

8 a( a/ v. t6 G7 f5 ^Метод getQuest(int questId)
' i( H6 A3 z, I# N: d

1. /**
   
2. * Получает квест по ID.
   9 `6 F& a7 x  O, C* B: r( i
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   1 E4 Q( A# t; S3 G5 `' w+ w
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   & w# _+ D! @5 F  H1 x
9.     {
   ; e  V6 b, O+ U
10.         if (q.getId() == questId)
    
11.         {
    1 c$ [+ |( T6 d$ ^& V& Y! [" P
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    / c/ p0 q) L7 b
16. }

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

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

6 C- h8 ~4 t8 yМетод addQuest(Quest quest)

% M2 e  k- F  T! Q  i

1. /**
   
2. * Добавляет новый квест.
   " t9 Y) H  _7 c1 U
3. * @param quest квест для добавления
   / Y2 j0 [. U1 P, ^9 W
4. */
   ) V' e/ t! o. J/ c' \5 X( Y
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   6 ], s% x4 x9 @# Q) J: U
10.     }
    8 k- d0 a0 }. W, e* U& s: Q
11.    
    8 I7 y) B+ N) G# o6 M* v, b, H- j
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    6 h/ V7 \( T  h' m
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    . l! p+ S  x; h" [' b3 U0 E
20.     {
    : n' ^$ s1 Z/ R5 `* f5 A9 V/ c& t7 }
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    ! V5 W, o; p6 l' d7 J5 D
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
4 @8 I2 T0 E) E' gЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.


) p9 J, g4 h6 |7 S