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

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

1 b5 r- r0 e, L& I7 j( sРазбор файла QuestManager.java
  F1 }! L- [7 ?4 n+ F, ]
+ `* f# K6 f5 Z+ }. {# SЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  : K- I0 B! o/ J$ t
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  

% [1 W# {& v; @4 q& iQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
' B+ j( j; E& Z$ X- E; |
4 z9 k% `. V1 h8 e
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   6 s' m' y* y5 M3 G- x, U- w9 _8 j
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   ( Z: t  m7 r# K
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   : d; k# e/ c$ @, z
7. *
   & O1 _4 }3 H  u/ }1 T
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   - w  Z- t. a# j
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    9 m) _$ T9 ?" |+ V7 a+ V! N+ {
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    . K2 p! W! q) `+ i; a
13. * Вы должны были получить копию GNU General Public License
    1 \% e4 @3 C$ }* B& |4 S: g* t
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    ! ?* S* p$ k& ~) d- }
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
# G* u  Z5 h/ V& R) I
+ P* X) L  Z- z
2. Импортируемые библиотеки
/ V1 b* z% e  P7 {' \: e# H
5 J1 n/ r' V; H: r, H, C5 v. [

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   * ?, s' o. u. `* N6 C6 r5 Y0 e
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   ( m, T8 K  ]2 D; a
6. import java.util.logging.Logger;
   # E* }$ f/ I% @, A/ I; K
7. 
   
8. import org.l2jmobius.Config;
   9 S$ N/ x6 G2 b3 v4 ~
9. import org.l2jmobius.commons.util.CommonUtil;
   2 b) ]3 _3 ^6 x
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 — менеджер для работы с игровыми скриптами.
- A! Y% ?" C" C0 g- `- V
5 m& \! D) C0 |* W3. Описание класса QuestManager
# {9 h  T% N) {* i' e7 D7 q

1. /**
   8 ~; S6 l. }% W% Z' y& I
2. * Менеджер квестов и скриптов.
   " P' K$ @5 u9 \
3. * Автор: Zoey76
   
4. */
   ( R) e( x" u/ c- `7 X( `8 \0 }
5. public class QuestManager
   ' X0 R) j% T6 u; x& X% P" C7 R$ b' B
6. {
   0 t: \. j8 ]/ G6 V% `; |& C  x5 z& R
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   $ c" \, d% {! ~; z( }
8.    
   
9.     /** Карта, содержащая все квесты. */
   1 T  s6 g) a4 Y- W' p7 P& H7 n, [
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    + c2 I2 c' p# b7 w0 Y
11.     /** Карта, содержащая все скрипты. */
    6 V4 e4 i  ]' V+ p: H3 ]: x) o; k
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    / A- e9 [# w1 f
14.     protected QuestManager()
    ( Y' l# r0 K; \' i, _
15.     {
    ! R$ ?! K, @( O/ N$ P: }4 @( N
16.     }
    
17. }

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

4. Методы
0 x( `1 ~% r6 h* ]! g. v/ i+ {6 P* iМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   
2. {
   % d8 @0 l4 F8 X3 P9 H
3.     final Quest q = getQuest(questFolder);
     m) b7 t" n% o0 I8 A# Z
4.     if (q == null)
   . Q4 O* O9 L! z) ]
5.     {
   
6.         return false;
   
7.     }
   
8.     return q.reload();
   & X* |! C) T# m. J4 m
9. }

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

3 m/ S  t% t4 O' H; E5 i4 KМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

1. /**
     C1 ^# o. t. \
2. * Перезагружает квест по ID.
   ) s+ F9 y% s% B
3. * @param questId ID квеста для перезагрузки
   4 r& e) c3 @/ b+ M1 L; g
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   % A; X! a) t2 n9 J0 l9 C
7. {
     q- c$ D: C9 _6 x
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   ' @  f7 c/ h) F( c: Q- ^
10.     {
    : C  O+ r3 S' L( ~7 a
11.         return false;
    
12.     }
    " N: H0 |  I* `7 Q9 T1 q
13.     return q.reload();
    ! F1 L" ^1 C5 }% e" F8 ?
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  & @% e$ _- Y; x% {0 s0 q$ G$ }( Y* r

+ C, q2 X( ]+ a# P# BМетод reloadAllScripts()
0 d* J0 k. w! E: j
1 T" C  T3 {' {- P! I

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   9 m. f% k( E+ Y3 }& P5 L
3. */
   
4. public void reloadAllScripts()
   
5. {
   ' m% T" n: P$ T' r& ?9 V' z2 R
6.     unloadAllScripts();
   1 W4 \7 R# z% R% ?8 B+ A
7.    
   $ t2 D9 p+ x; d
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   4 f' M. X) n0 B. t2 D; @+ u" C3 L
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    " J5 z/ J5 S# ?2 e
12.     }
    2 }' @2 o; \! |7 |
13.     catch (Exception e)
    ) R* ]9 p2 U2 R% }! ~
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    9 q% R3 Z. Q% z0 q2 F- q' D2 {) k
16.     }
    
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   ( L; ~% J8 \9 o
3. */
   
4. public void unloadAllScripts()
   ) B5 D, R9 W* c. t. A+ [
5. {
   * l8 o1 T. \- F: B7 {" |7 H
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   ( [" N! o/ W6 N' P' J
7.    
   
8.     // Выгрузка квестов.
   3 \7 h9 {% M- P0 N* B) K, c9 T
9.     for (Quest quest : _quests.values())
   
10.     {
    " D" |- i: s. {/ v5 q3 s9 a+ c& _( K4 U
11.         if (quest != null)
    
12.         {
    # P, ^* z& Q  p/ u) p
13.             quest.unload(false);
    & |6 L0 {* k% E7 k' g
14.         }
    
15.     }
    
16.     _quests.clear();
    , ^' O: C. i# @6 u9 F4 V6 I( e( M
17.     // Выгрузка скриптов.
    5 N1 M4 Y: n! {- w9 C6 k' D
18.     for (Quest script : _scripts.values())
    # t. ^  }. \4 i) `) W1 o( j
19.     {
    9 T+ i5 a( {: e8 Y6 m5 u
20.         if (script != null)
    : C5 f- Y4 Z+ A  c( \" a4 G
21.         {
    ) }) p2 \7 o2 l) u, |! `# k  K
22.             script.unload(false);
    
23.         }
    ) A. K3 x  r) t1 O
24.     }
    
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  6 Z. S6 f( E0 I2 o; B! q

! J6 T( ?. ^. D4 P7 g$ GМетод report()
# ]- U5 ~. U& G# M
% t' ~) r& j) }0 s9 S1 i' |8 ?

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   " u2 ^1 e+ c. h
3. */
   
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
     v9 R2 S  i) u8 w* p7 F; w: v" [0 `
8. }

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

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

Метод getQuest(String name)

1 E2 m" c2 g( _. Z# M7 B

1. /**
   
2. * Получает квест по имени.
   , p( d4 ~# i- e8 k" i
3. * @param name имя квеста
   
4. * @return квест
   ! D3 w( r+ H1 r/ z  l6 C* ]
5. */
   % `8 g8 S+ o" ^, l
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   . d: j' B# A5 y5 F
10.         return _quests.get(name);
    , e5 h* s( f, d
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

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

Метод getQuest(int questId)
& w( Z9 `7 f  b0 _5 n
# N( [) @" G# ~" u

1. /**
   
2. * Получает квест по ID.
   ) S8 T. {6 M7 y2 y  W% C/ Q2 c
3. * @param questId ID квеста
   / b  B  L  Z4 Y$ F. [& k9 z
4. * @return квест, если найден, {@code null} в противном случае
   ! h3 ^& n1 R5 l' o( Y2 Y$ h
5. */
   6 `' Z( [1 y: Q9 M
6. public Quest getQuest(int questId)
   
7. {
   % N5 g- a* H; g! ^5 x5 V7 d; S
8.     for (Quest q : _quests.values())
   
9.     {
   $ a, Q* c+ L8 l/ a% Q. o
10.         if (q.getId() == questId)
    6 c$ V9 r! c& y6 _. D+ h/ {' \" L2 w
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    & N* d+ w1 s, y
15.     return null;
    % @. T5 u# ]/ o& t8 k) H# Z
16. }

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

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

5 k2 T8 y5 s* Q7 B5 EМетод addQuest(Quest quest)
) y0 ~% S6 V* y! W1 |3 f

1. /**
   # M: W+ k& l, i+ N- m: J
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   2 [; Z6 F3 B0 l5 u
6. {
   
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   3 D6 N/ w8 r& r' @  U: q) V
10.     }
    * _6 v1 C3 P! Y' a+ N& t- p( k
11.    
    1 V  V# |# v5 g' R" }( z; Y4 A& _# V
12.     final Quest old = _quests.put(quest.getName(), quest);
    + C' e5 C5 @2 F! F3 j
13.     if (old != null)
    
14.     {
    6 D' N% x2 \5 x# C1 ?# F
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
      m! {4 \* i1 t; P0 |& d# F
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    ) S! O- s: [6 x8 n
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    - D" b6 @* i  t0 a( v6 o
24. }
    
25. ``

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

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

* a' j0 Q3 _" `+ V% w

+ @& R4 J' _7 S# z7 Z# e