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

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

Разбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
" I4 a5 Z$ Z" h6 g  i) e

• Лицензия
  " {& ]4 ?+ B5 `7 ^& i8 Z
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  , i, h  J1 N/ U* w. l4 L+ a

; }7 P; {  X  Z) _# h8 k4 rQuestManager.java — управление квестами и скриптами.
% i/ y* ~4 H- j! w* C" \1 Q2 L  oПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

( J$ i% f3 |8 U, }
! Q( e/ a1 S' B. E( ZДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
- L6 N& s( e& H' A* S

1. /*
   / R9 u! z% k& A2 Q
2. * Этот файл является частью проекта L2J Mobius.
   : Y5 C" Y) ?/ a' x
3. *
   9 j) G) H% z! M: c8 F$ k
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   ( ^% T) ~! y- C# y. Z! N
8. * Эта программа распространяется в надежде, что она будет полезной,
   , N# m: [! A4 f  f, J
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    - _/ N, L0 O! ]* {: b& T, Y$ Y0 o. n
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    ( T: M) e2 f( x2 q2 L6 G/ v
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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

. X& z  |  [6 y3 }( \5 B
2. Импортируемые библиотеки

4 Z! a* v8 b( a* j6 t

1. package org.l2jmobius.gameserver.instancemanager;
   * K% o. w* l4 @1 M
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   ) t' P8 [+ T) b% |
6. import java.util.logging.Logger;
   % X9 q9 @: T9 K/ o7 P# m, ?
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   . G6 I" |) U( w/ b
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 — менеджер для работы с игровыми скриптами.
( B# X: f' s$ o1 D
- q3 x% y! G! Z* I" K7 E8 ~3. Описание класса QuestManager
9 _2 w% T* p; Y' |8 A

1. /**
   
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   8 O, E& a/ e) {
4. */
   
5. public class QuestManager
   
6. {
   4 v8 G$ l: P/ m% T/ F9 V- j
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   4 K# T) k! ^0 r5 u) O. J
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    . A& Y! h; i& J4 ]( z
11.     /** Карта, содержащая все скрипты. */
    5 ~  j) r7 k3 ]  I# E$ Y
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    
15.     {
    9 h2 g5 p$ M2 ]5 ?
16.     }
    
17. }

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

4. Методы
7 @& Q. i7 A, P" s% I6 |0 XМетод reload(String questFolder)
; s" \1 k9 K/ K6 p

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   
6.         return false;
   / P( _4 [/ ]; I) |
7.     }
   ' ]$ J1 O3 ^4 O
8.     return q.reload();
   ! C2 f! B9 `) W
9. }

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

1 N3 w) c3 i# i. D' {
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
) ?, \9 x& R( F( X2 _+ XМетод reload(int questId)

1. /**
   4 m% h' I* t4 ^3 N, J1 C
2. * Перезагружает квест по ID.
   & M& j) s+ i0 b
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   0 k8 {" G$ `; H: \
6. public boolean reload(int questId)
   - t/ }8 Z% {6 h8 k- B
7. {
   5 z9 f2 Z4 p. {, u7 Q; W
8.     final Quest q = getQuest(questId);
   " w$ v. V# Y& I% ~. B+ }0 X
9.     if (q == null)
   0 C# |3 M- j& H; U- f; M1 V
10.     {
    
11.         return false;
    2 |- A, V/ o# b9 M; t
12.     }
    * V" y: `* ]6 x7 }  D
13.     return q.reload();
    4 t  ~5 Z! ^( {2 _2 v$ i3 b
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  : U  S7 ?3 R. Y6 f9 ^0 k( H

, T& H. O2 r  i6 ^0 C( x% xМетод reloadAllScripts()

" w' }$ K- b8 U! \

1. /**
   # ^5 s3 U/ S% D
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   3 C5 s. e) Z5 m
5. {
   5 @8 F% c5 d$ O7 k% `/ B
6.     unloadAllScripts();
   8 D9 x: _! T) f4 l5 y7 D1 N7 o
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   ; H( H% ~7 E- p) }
9.     try
   3 n0 T9 W" o" C
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    
14.     {
    ; j+ }0 Q9 S' a1 g  g4 F! o
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    * U# l& P9 R. H% M, D4 P1 X
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()
) }9 n/ T% m8 E% q

1. /**
   7 c$ N# M# ?" U& I: N# o; [
2. * Выгружает все квесты и скрипты.
   : o( q: {, D# M: m
3. */
   9 j/ F. X% [/ [8 g7 H
4. public void unloadAllScripts()
   ! @, V# n8 R, ]8 ]: q7 M
5. {
   : d& O4 _0 w9 Y' {
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   " q/ x# M0 L$ W. J5 J
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   ( q. x/ L0 o+ c5 U7 y) E
10.     {
    3 k0 [: S+ m- w" V
11.         if (quest != null)
    8 }! i0 n; n5 L% U
12.         {
    
13.             quest.unload(false);
    / `1 W; d# B- A
14.         }
    
15.     }
    0 W, h% a) s# g
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    , c1 L" w2 g4 s
20.         if (script != null)
    
21.         {
    . t. W% k+ I9 E9 }6 E, M( H
22.             script.unload(false);
    
23.         }
    4 c" q" B  D* Q& x: g& I
24.     }
      ^9 K7 B$ O9 E7 `1 k
25.     _scripts.clear();
    
26. }

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

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

Метод report()
& ]6 W! H# G1 T+ s: N: T
, a$ I( w. C4 y9 w/ h

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   , {' Y6 S8 B# G& ~5 R/ v& a
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   , I7 m0 P6 K( O) X% [
8. }

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

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

6 @/ R9 B0 j% s5 Q! mМетод getQuest(String name)
1 J. L. E; j$ ]; W! s+ ~* S

1. /**
   
2. * Получает квест по имени.
   , ^6 ?6 \$ O6 ?& Y, d. g
3. * @param name имя квеста
   
4. * @return квест
   4 T2 j( |( _9 u' O6 G% O1 ^
5. */
   
6. public Quest getQuest(String name)
   
7. {
   5 T$ b4 X: _! z* r' D% r" G8 K
8.     if (_quests.containsKey(name))
     r1 c6 v+ Y6 }$ ~+ m8 q; h/ y
9.     {
   
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  ! [) D' x0 n' U3 Y3 E

3 }2 c+ [* I1 u, [' Q' `Метод getQuest(int questId)

3 G4 `7 H9 j3 p( `1 r

1. /**
   
2. * Получает квест по ID.
   9 w1 G: f" b- Y7 M
3. * @param questId ID квеста
   " t( P; N. W% s; [( g
4. * @return квест, если найден, {@code null} в противном случае
   / m( k2 R$ K: b; n& a( Q. X
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   + w9 w& n: g4 G: `
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    ! n0 M  F6 Q. b. ?' e
12.             return q;
    ( L1 d. s9 R# c% U+ |9 m4 V. Q( \
13.         }
    
14.     }
    
15.     return null;
    8 h. H, B* I9 L/ T) r1 o0 \" l
16. }

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

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

Метод addQuest(Quest quest)
% X7 J* n7 n* b

1. /**
   ) B0 |! p) o+ V! F
2. * Добавляет новый квест.
   $ u1 ~/ T: h: u" {. }5 b* E
3. * @param quest квест для добавления
   
4. */
   $ w3 n5 F5 L$ y0 V4 ?+ b1 e1 r
5. public void addQuest(Quest quest)
     d- ~9 X: R+ v4 P) N! ]; ?
6. {
   
7.     if (quest == null)
   
8.     {
   $ ]) y. h$ [; L& G
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    ( A% D9 J$ ^4 @2 @
17.     }
    : ]+ ~. {7 m5 |" Z" Z+ e
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    # O6 Z: ~) j8 g4 f6 c+ Y: f# z/ N5 ]
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    % n4 {' Q: n1 `2 [9 e6 l
23.     }
    
24. }
    1 Y3 @8 E" i1 m) u
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
" A, E3 a7 ~' p# i( }
$ s9 u2 N, t  x% g