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

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

" z' o  J6 p; G) v5 ~* xРазбор файла QuestManager.java

+ |2 f' S7 F+ y/ I; V/ e& _/ tЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
) |# H2 E  V0 p

• Лицензия
  / b) K9 h3 q5 e2 I7 d$ I6 m
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  

QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
" o1 l6 P4 [0 F% Z4 z( n
. o! C3 ]* x  T& z. ?% W
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
6 G/ A! [7 V# }2 n! f1. Лицензионное соглашение
1 W* ]' M0 ~% U. o8 n, Q" q

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   5 r. X' W. h" r  a% R  Y
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   5 g7 i7 l; {- |/ [0 J9 F2 h
7. *
   3 T! R# O; o7 P
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   1 y7 U3 W7 y& t+ `  v
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    / w7 L2 @# r- f" [4 G
11. * См. GNU General Public License для получения более подробной информации.
    % p" D! D. M- ^- l* W/ Y4 c
12. *
    6 c- H5 }+ U% c  u- u' d  m6 F
13. * Вы должны были получить копию GNU General Public License
    0 t1 N8 `1 e$ B) y1 F0 M7 S* `
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    / j5 l6 r5 [4 O' I0 v  X  v
15. */

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

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

  S& h8 `$ u! W+ h
' d8 O6 Y- s" L5 N2. Импортируемые библиотеки
8 ^4 V" v# P/ E9 q; ^4 W1 n# f0 G5 [
$ Y+ z7 R( x7 q1 f& D

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   / U9 E% t1 L# @3 {4 j1 p4 |) \4 ?
3. import java.util.Map;
   6 S, V. C5 T- l) s2 F
4. import java.util.concurrent.ConcurrentHashMap;
   9 S" Z3 b% s. O. d/ o! L3 J' m
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   
8. import org.l2jmobius.Config;
   7 y  V: ?/ D3 f- j( l) a
9. import org.l2jmobius.commons.util.CommonUtil;
   : ~; J) x0 Q7 Y0 F$ Q3 |5 g
10. import org.l2jmobius.gameserver.model.quest.Quest;
    * C1 \. O$ J2 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 — менеджер для работы с игровыми скриптами.
. s8 {( D) ]$ `, h
, \' W# }( }2 j3. Описание класса QuestManager
0 y& ~3 t9 z4 n! Y( f9 Z8 V+ |

1. /**
   
2. * Менеджер квестов и скриптов.
   8 _9 x9 t4 H! d% I# H7 p
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   * V: D. Z% k0 {8 K7 p4 q9 J
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   % u8 X8 l' E( M' {0 S
9.     /** Карта, содержащая все квесты. */
   , V* A- e# p: D
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    - [/ `  f0 }7 B; q0 f; o) s. Q9 K
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    7 e3 S- F4 x4 @/ i; r  B: y$ c
13.    
    1 p% Y: v( P3 V. t
14.     protected QuestManager()
    . _( C- H/ {7 Q' ]1 ^9 N! k  M
15.     {
    : b( C- P1 Y2 J; K6 n
16.     }
    
17. }

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

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

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   . i: f5 ]; ]. d8 Y  u
4.     if (q == null)
     n9 ?8 O* [/ _: N/ D
5.     {
   9 E2 A( {3 a2 W% u" l6 _
6.         return false;
   
7.     }
   / k# g3 q1 a4 O* J! ?* y, t. x
8.     return q.reload();
   6 R( p0 \) J3 m; p0 ^
9. }

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

$ X+ w$ x# J) ?' f% |Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
9 ^8 w/ k) A  G3 }
# w8 X4 @9 y3 j8 t/ m

1. /**
   . B* m" `# [, C5 U
2. * Перезагружает квест по ID.
     w1 U) {# u# u4 y- \' R8 y; ~( k
3. * @param questId ID квеста для перезагрузки
   # {- l2 V$ x& z- c; d4 P! N
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   / d9 v! O0 \( L: \- r
6. public boolean reload(int questId)
   
7. {
   - C8 |& [7 A8 n+ q& e; Z
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    ) W3 O6 p, M$ W
11.         return false;
    
12.     }
    
13.     return q.reload();
    
14. }

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

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

Метод reloadAllScripts()
" D7 j' K4 ^4 W* X" b. o9 A1 j* o  P

1. /**
   5 ?+ q. }, U  |/ E
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   8 t8 k7 g9 ]8 V" _6 G( [& X
3. */
   6 X/ P8 y* @* y/ x. e& \# l
4. public void reloadAllScripts()
   # e- y) y5 p" u/ R3 Q, p
5. {
   
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   : {  r9 R9 ]/ `4 _
10.     {
    % q0 N% c) v8 Z. X( T" }
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    ' g) A! g: Z' {# b2 a
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    : }5 e6 z( M; n) W/ s+ W( Y
16.     }
    5 E$ [9 s7 L) D& ~3 W
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

8 W! h( M  g# f" s0 N

1. /**
   $ v9 ^0 W0 T. L
2. * Выгружает все квесты и скрипты.
   - o. P3 U9 ~  s/ z3 {1 [6 N- p
3. */
   3 r- W0 P# a4 Y0 J, K6 `5 ]9 ~
4. public void unloadAllScripts()
   " \# h7 a2 W; d9 N" e) D/ ~
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   ; I, t, }8 h+ U) K4 f
8.     // Выгрузка квестов.
   3 y& Z5 Z+ [* {6 R
9.     for (Quest quest : _quests.values())
   
10.     {
    4 U! ]( o1 I' W
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    ! G: v/ e4 f0 u: M* |/ b
14.         }
    
15.     }
    
16.     _quests.clear();
    ' I6 W0 M/ w2 m7 z
17.     // Выгрузка скриптов.
    & ~2 T$ n% V2 r6 O
18.     for (Quest script : _scripts.values())
    " D( K' q5 A0 F. k6 B
19.     {
    3 O$ I5 ?) p+ Q2 c, A% \! {
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    2 A" v+ m: p6 W
23.         }
    ' S0 q# f7 n% z5 B& r8 G$ O& O9 G
24.     }
    
25.     _scripts.clear();
    
26. }

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

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

0 F" s0 d0 k: i. y, h6 t8 `: XМетод report()
8 @0 O4 }" h& D4 A
+ A) z2 f3 J. d4 x6 K! g

1. /**
   0 s) A3 a. z% P* D+ \# C! d) F
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   - q# k2 R1 W) P, A# v$ w
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   ' |5 K" q+ H; m
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   : a- m% r" O& e3 [
8. }

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

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

# ], Y2 a! ?$ ?3 y( O; ^' y3 s5 `Метод getQuest(String name)

! p# E) x2 z7 k' l4 p) p

1. /**
   7 o( v8 k! J  ]$ Y6 ~8 b# X
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   - q9 `  W$ N% j; F; H8 ]
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  * m, M9 L1 L4 R9 }- Y+ Z" L) I

/ O2 Y7 M( E9 P- h% b2 _. VМетод getQuest(int questId)
8 n" b. z; Z$ v- H
2 Z) \$ T7 ]9 S0 \  }7 \0 b: ]" R

1. /**
   8 {9 O/ W' i. p, Z! t! u* i
2. * Получает квест по ID.
   ) r! y' ~: h9 K8 h  F
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   ( b' p' G, C! f; a
5. */
   
6. public Quest getQuest(int questId)
   0 _) U' b$ s. P/ y7 T* y; U
7. {
   
8.     for (Quest q : _quests.values())
   ' c2 K' _& |( R1 N1 z5 {
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    ; a, a( u; B$ h( I4 Y2 G1 K
13.         }
    
14.     }
    9 @! _0 \2 g7 o7 S% \! |/ ]1 j) X
15.     return null;
    
16. }

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

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

Метод addQuest(Quest quest)

1. /**
   # f. m! h- o+ W; m' Q* W! Q
2. * Добавляет новый квест.
   8 {! R+ T# p3 J
3. * @param quest квест для добавления
   
4. */
   # j( G0 h6 e- r" Z$ E" `. z2 _
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   4 W) [  F3 J0 v% V7 ?' w
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   5 X4 R$ X' L; R- S4 I7 ^8 N
10.     }
    0 e+ E9 J& a- d, y: W+ Q% L% v
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    9 W0 C% b& @* e. M8 H
15.         old.unload();
    & \; X' Z# D; N- l$ V  \% c
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    . V1 F$ k: l2 j. |, X; X2 ]! _
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    2 K! I5 m, g9 A6 j
20.     {
    5 ?% `1 s( E1 Y! B
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    " n! t" Q9 a/ s+ m  e
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    1 Q* p  \; X  j, u4 X0 I; X
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
6 M) u. t5 o1 i4 f$ y
# ^; Y  s. _! }# @: F. H: ?+ i

! v9 Z" G; Z9 D- N* s