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

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

! M8 j9 [6 f  z) t% CРазбор файла QuestManager.java

/ V8 N' F8 x% O2 A! FЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
: t4 y1 E! ], \8 [' BОсновные элементы
% o; O, Z$ i8 x

• Лицензия
  " L" ^. F& s6 s4 W) T. B
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  

QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
# W) ~8 @' c/ i4 @* Y" c7 s

- c5 U( z- F" G& c3 A; T, b1 }Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
5 J% j8 z  f, I  i* \5 ~- X" q; c1. Лицензионное соглашение
) ^* e8 [0 e% _$ E

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   4 L! V8 f* x  F* v" J8 `" s! |" Y- r% X
3. *
   . O  H. i, m+ e+ t7 R" \
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   - v  J( F2 A: f& q" y! s9 ^+ `6 _
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   : r; P% ~  M3 F$ H2 V" O9 I
8. * Эта программа распространяется в надежде, что она будет полезной,
   2 h5 ~& i- M* @: l; M( x/ x
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   : E4 f/ g/ P, F4 N
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    . s# u2 r, [, L8 f7 o2 d& w
11. * См. GNU General Public License для получения более подробной информации.
      s/ w, e- D) ~% h% k. g) J
12. *
    0 e5 t. M. Z) F, [
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    9 M. n' U' Z% s" U: ~" Y% z
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
* i2 @2 f9 F0 C. U! s4 a

, U5 D' z- u& o; ?! f2. Импортируемые библиотеки
1 r4 t/ W! F& p& Q! w9 g
, `* q7 p: l9 Z5 b8 w  p2 Q

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   3 h" N, S2 R" p. `6 C$ ?
3. import java.util.Map;
   ' @8 m% M/ Q$ c' ^7 z' h$ Z
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   5 g* O3 h; U2 p; g- j1 W, n
7. 
   
8. import org.l2jmobius.Config;
   + M* D9 Q7 ^) ^% u+ `; s
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 — менеджер для работы с игровыми скриптами.

* x  f+ J0 q2 P& N+ V$ M6 |) P, L# Q) r3. Описание класса QuestManager
& y) @* P0 m7 }

1. /**
   2 l2 Y* R1 t- \2 n9 C( f8 r
2. * Менеджер квестов и скриптов.
   ' l% M8 X. o4 {) W! M7 a9 h, C
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   
6. {
   0 X% F0 N' {2 R
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   ( s. X$ S6 k. B# e5 x
9.     /** Карта, содержащая все квесты. */
   ! O1 }2 s$ S  I  ]! p
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    ( z' ?+ o  _9 l, t
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    
15.     {
    
16.     }
    9 a* P$ q8 W7 ^! Z" \
17. }

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

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

1. public boolean reload(String questFolder)
   " B1 s5 ?' `# V
2. {
   4 Y& v: k+ N  S' v: V
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   & w' t9 _4 V' }4 F9 S
6.         return false;
   2 G- q; K0 `  }) X) c: C+ U' ]
7.     }
   6 [# T- t1 y9 I, O
8.     return q.reload();
   
9. }

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

0 {, G6 h( t3 A$ Y% i; k" i
+ j3 D/ t7 N2 U6 i4 sМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
% d; O7 i0 Q+ s# OМетод reload(int questId)

" f* N# m9 m# m( P

1. /**
   
2. * Перезагружает квест по ID.
   % P, g# L) ~6 w. X
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   4 e, Z- W1 g! m5 |2 T1 j4 E% v
6. public boolean reload(int questId)
   
7. {
   ; i8 `) T) Q, c' b9 H
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    
11.         return false;
    0 v( u% F, z6 e+ [/ c$ S
12.     }
    
13.     return q.reload();
    
14. }

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

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

Метод reloadAllScripts()
( L( I* y( ~% {# L5 ~: ~/ S, C

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   
7.    
   7 [3 O: ]5 J3 o$ w6 X8 Z: f! H
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    9 Q+ N5 B; Q7 k4 l: ]
11.         ScriptEngineManager.getInstance().executeScriptList();
    ) j% n& ?4 X+ p; y0 V
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()
2 Z0 Y, X  ]7 k. V' Y( n% I( b! _

1. /**
   
2. * Выгружает все квесты и скрипты.
   8 |- ?1 ]! b2 h1 ~
3. */
   0 j% n$ `+ E+ o- e0 Z- I
4. public void unloadAllScripts()
   ( k, A# S- x# F' _  {8 @- @
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   ; h3 z* ]" ]9 _$ R
7.    
   . j) [1 ~7 m- K; I/ A# g
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   ! i% _7 V, H; O
10.     {
    - G; Z9 {2 e* F0 X
11.         if (quest != null)
    
12.         {
    1 J* @! \0 U6 J; P! L! U& S/ C9 H8 A
13.             quest.unload(false);
    % _2 F3 c+ F0 {& J7 e' a: {
14.         }
    
15.     }
    ; [+ D( w; C7 i& y( H0 W2 i; \/ _) ^, o
16.     _quests.clear();
    $ {+ x5 ^, s& F. l+ |8 \- u
17.     // Выгрузка скриптов.
    / D: w+ X, }0 G3 r+ s
18.     for (Quest script : _scripts.values())
    
19.     {
    . D* v- a  p- X, o. x
20.         if (script != null)
    . o0 u; x1 Y: m& H  f0 a
21.         {
    ; z" [$ m  {; C" U/ Z. b
22.             script.unload(false);
    ) m: O5 q$ P4 h- v" P5 m
23.         }
    : r7 j1 h$ g+ L  X- p& {6 J
24.     }
    
25.     _scripts.clear();
    4 W9 V0 Y# n& g: z% u0 j9 _6 w
26. }

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

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

- _1 g) h1 X  N% uМетод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   1 u  H) `: A5 @9 p2 p8 B6 L
3. */
     P( e1 _1 T0 i% r1 f( O
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  ! M0 r; a! ?5 y5 o* ^$ K( U

Метод getQuest(String name)

1. /**
   1 ]/ y* ~: b5 S) Q
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   + s8 b8 g* E1 D) h
5. */
   
6. public Quest getQuest(String name)
   : L+ e- u4 V* i1 l- I0 B
7. {
   
8.     if (_quests.containsKey(name))
   ; p  D  M$ I% ^5 S& `) ~5 ^7 i
9.     {
   , ?" h! @9 {- }$ G$ m: a$ C
10.         return _quests.get(name);
    
11.     }
    4 K) q6 ?5 G: e7 I
12.     return _scripts.get(name);
    
13. }

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

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

! p) d. V( H6 x! P% m) [; \2 q2 Y+ gМетод getQuest(int questId)

1. /**
   + v4 W, x9 ]$ o% ]/ r8 `: }
2. * Получает квест по ID.
   " B* j) O- R/ P1 p, `; Z1 U; I7 V% e
3. * @param questId ID квеста
   3 e+ i( f( W7 o$ E$ M, p0 w
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   4 p! S6 T3 w4 w- m- U) p1 A6 Z
9.     {
   2 h- }2 u/ |3 H! U1 B% h
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    
16. }

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

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

" a  C+ |) o1 L0 ~7 [) N: wМетод addQuest(Quest quest)

5 O5 ?6 K  s5 }

1. /**
   
2. * Добавляет новый квест.
   5 z# n8 L; F. Z4 ^
3. * @param quest квест для добавления
   
4. */
   2 K& F. g$ q8 i$ T6 v
5. public void addQuest(Quest quest)
   0 A# u# x4 k% C% T# g) r
6. {
   # y' j& v3 _/ ?7 d6 {2 l# S
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   7 }3 m- n# y& R# R' U9 V' ]3 u
10.     }
    
11.    
    ; H  p8 z" S( e6 r! s. @% g
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    " ]* c3 K8 Y5 D
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    0 K# C1 Z' \! f. a0 N
17.     }
    : K0 o5 r7 F2 u$ [7 K. F4 a
18.    
    & j( I( S: H" D8 x8 q( I
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    0 I) C3 O+ j' I4 [- `* [
20.     {
    ! v( ?0 m( u; y$ ]7 C0 O
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    7 L# L, r; x( g$ [" L( Y
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
% @/ D# M; ~0 HЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
  ~# Z. j& d' d( P8 Y

5 `! @+ I! l2 W5 \' i& Q2 P