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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
5 U3 b3 f! [% U3 T8 H3 y$ m
Разбор файла QuestManager.java
% z& H: [& {" n) ]% m
Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
' Z, l4 t; j  N- T% X2 ~

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    ; E) G# n5 W9 I" U2 c2 }2 S. E, E2 {
• Импорты
  : X* s+ x& a6 _! R1 z( E0 L0 d& i

+ e1 M( g: k1 VQuestManager.java — управление квестами и скриптами.
& a& @4 I2 C5 ^# y" E+ M+ F: \( H/ l8 IПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\


( V: ]# m( }, _Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
6 m+ x# @! `! I; f1. Лицензионное соглашение

1. /*
   ) d, a# x+ y7 d
2. * Этот файл является частью проекта L2J Mobius.
   7 h/ [' s3 T" ]) ~2 e! R# x
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   ) L' L8 p) i7 X8 ^1 p
7. *
   . O% N6 D* }' u4 I
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    6 |: u$ E' O3 z' b. ]
15. */

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

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


2. Импортируемые библиотеки

1. package org.l2jmobius.gameserver.instancemanager;
   : {9 w$ t( \% s1 C. E
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   : v# E3 ]- @% r" I1 o1 I
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    4 _% j6 o- F1 l% [% e0 z. k) h
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 — менеджер для работы с игровыми скриптами.

1 u( d4 ], j5 z# h  ?+ y3. Описание класса QuestManager
5 C! \' I" I6 U6 U

1. /**
   
2. * Менеджер квестов и скриптов.
   * F1 h, C5 p$ _& @
3. * Автор: Zoey76
   8 M3 k3 j2 f9 f6 b  C4 Z' x
4. */
     h$ T5 J/ K3 R
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   ! b. L4 K9 k! a4 j5 R$ J( m
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    # F" E8 O) A3 o+ r  w! r
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    
15.     {
    ; l9 T+ o- t# }- E7 l5 l. F
16.     }
    ' o$ |2 E8 O+ s! x6 T3 ^6 F6 @
17. }

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

4. Методы
5 D9 Z: F/ f. x8 D5 ?4 ZМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   - p. q% n4 @  H4 h9 c, L
2. {
   8 i) W& d; c. ~8 A
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   : ^/ g' I- D) `% I7 ]: d6 w
5.     {
   # B3 B* h6 j/ b3 ~5 Q! p  F4 c4 U
6.         return false;
     d3 `3 f- i2 b, l) @: L/ G1 D* M
7.     }
   ( }: q# l+ ~# M0 l/ v4 G8 \
8.     return q.reload();
   
9. }

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

: B2 u2 p0 b+ k/ c7 DМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
' A+ ?) l7 B: t. u
$ G0 t5 t& A5 d- u9 W

1. /**
   7 D6 |4 M; [. ?/ m. s
2. * Перезагружает квест по ID.
     {8 P" s* I) {1 v  m8 ]0 G* b
3. * @param questId ID квеста для перезагрузки
   , X4 m/ @- x- X$ U; y5 i  F' P& ^
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   8 w1 h" P3 u9 [8 E" r
5. */
   
6. public boolean reload(int questId)
   1 G, h' l# z" O( o! E
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    6 L9 l. @: T6 I# }' z( M( H0 j
11.         return false;
    
12.     }
    0 A) [3 e. q( V  k$ h% A
13.     return q.reload();
    ( t; T5 u) ?- V2 {- @# H6 u$ h% r8 a. Y
14. }

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

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

% [$ u2 T2 k1 WМетод reloadAllScripts()

1. /**
   4 M" N8 l- x& T) S
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   ' ^& ~& Y1 N1 l2 c1 _
3. */
   
4. public void reloadAllScripts()
   
5. {
   ' @/ c/ z' [7 I9 @3 ]4 M
6.     unloadAllScripts();
   
7.    
   % Q7 f% K; k. R9 U1 `# T! d( \' s. h& N
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   " u) X7 q" A9 p4 b, m
9.     try
   % ]3 l. B% x  Z# ?" m
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    ' K! S; @$ T4 [0 i' c" C" H
12.     }
    
13.     catch (Exception e)
    ) p% V+ c+ l2 B
14.     {
    # G4 R  V+ i3 G* w: t2 n$ i0 c& q
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    . ~, G5 U% ]( x: H+ {) H5 a9 |: d2 @
16.     }
    ' x7 B4 b; H* O
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()
. r+ R% x# T, a4 [/ D
! u$ N  r& B" e& J: m# M

1. /**
   3 W7 w2 V4 P+ w% u% E
2. * Выгружает все квесты и скрипты.
   
3. */
   % q7 x+ p8 S  Y9 O1 Q; a0 [$ o: e
4. public void unloadAllScripts()
   * G6 P8 P1 y+ K; ?% E) b. K
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   " y6 o- W7 ~5 ?. a8 w
7.    
   : X; j1 r0 L) s' h
8.     // Выгрузка квестов.
   $ \. A& Z: b6 }$ J
9.     for (Quest quest : _quests.values())
   ' z6 z6 B; [/ Q! g9 X
10.     {
    . I7 B- K) _/ Y  J' B3 [1 X
11.         if (quest != null)
    4 o" q5 O5 ?9 Q
12.         {
    ! ]- A% I0 r1 h7 C9 a; k- L
13.             quest.unload(false);
    
14.         }
    5 B- w& r; D1 ~% ~: U* i0 G
15.     }
    
16.     _quests.clear();
    * \- a7 T) k6 Y9 T% s
17.     // Выгрузка скриптов.
    : L0 x* I3 e6 {8 B
18.     for (Quest script : _scripts.values())
    6 s8 E9 s) F6 S, A( }( `8 T8 q
19.     {
    
20.         if (script != null)
    & j  j! @0 ^8 x# r. O! Y! R9 ~, p
21.         {
    
22.             script.unload(false);
    
23.         }
    5 i6 w' S$ {( u) W' }$ g- w
24.     }
    ( [( }$ q( a, w" y' i% B* V
25.     _scripts.clear();
    
26. }

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

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

Метод report()
0 X( a1 K$ K  B; N
! O- G) u+ p) n5 a6 y* f3 ~+ l

1. /**
   # F& z, t* q' R3 R; |
2. * Логирует количество загруженных квестов и скриптов.
   $ j+ H' b3 B! b2 e
3. */
   " [8 ]: t) j. m3 X' F7 I
4. public void report()
   
5. {
   - C' B2 o4 s& L0 P0 O: Q8 X4 L
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   6 D# J5 p+ s' E) M: R
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

; b3 n5 m/ U4 x  W4 _- PМетод getQuest(String name)
" ]; G: z, Z; Z% y# r
  }# U3 _$ @9 N9 |

1. /**
   2 N" O3 c1 h, l/ {) h; e
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   7 R# z4 L& F% L1 _
5. */
   % K! I7 _) J6 a6 o% q% W/ l
6. public Quest getQuest(String name)
   
7. {
   ' g8 J0 N# t- v$ c* U, V. J
8.     if (_quests.containsKey(name))
   ' s# W1 i& I& R" ~2 m2 r% K
9.     {
   ' f9 q, y4 f4 X% k
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

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

4 M: C' r; {5 |$ w5 @  n6 hМетод getQuest(int questId)
3 w3 \, J/ ]; A) c) J

1. /**
   
2. * Получает квест по ID.
   - v" m" B4 R* \# a/ c& _
3. * @param questId ID квеста
   & ^: [1 Q) X6 @  w9 _( k) \
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   7 t$ H$ s0 g3 _" M! |0 N0 E
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    / H, {" u+ v) V0 ?6 e
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    
16. }

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

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

Метод addQuest(Quest quest)

5 L' x5 W, k) Q1 Q

1. /**
   
2. * Добавляет новый квест.
   4 R) J0 |! R4 z  b# E+ y# ?
3. * @param quest квест для добавления
   
4. */
   1 K% K& K' R+ e2 |
5. public void addQuest(Quest quest)
   / H4 o! s! ^1 W
6. {
   
7.     if (quest == null)
   7 t' a: r# t( X7 m
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    % @( Y$ V) o/ [" F7 ?1 z
14.     {
    
15.         old.unload();
    ; ?  w! l6 X" o2 D
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    % b6 _/ J6 F( i8 y5 I. ~
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    0 x) a- S; A6 O5 P, T8 c
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    ( y' z6 J% i3 \0 z6 P
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    ( o* M5 ~; T8 x
24. }
    # H' w, m4 n* [$ ~: Y% [+ m+ j
25. ``

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

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

; a' i9 S) O( d  @

% S; R  ~4 i; `! w! C% b0 Y( ?