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

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

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

. ^5 s$ F  Q- T7 G3 B; Q, BЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  

QuestManager.java — управление квестами и скриптами.
2 I# C" @8 I/ i& ?! P- Q% m6 [Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
/ B" n) h8 Q7 v2 F7 `

, e8 q2 y4 Z2 T; g3 c) G& S7 AДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   6 n! E2 C) J: f$ ]& a$ z* M- ~
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   ' D  E1 _, K2 O
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   8 u! H" ?& D6 b. U' y
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   7 B; g9 L  M8 D1 ~$ Z% q
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    , F$ i- T. l6 l. W
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    1 l4 h# d' v8 d, @9 x2 h+ {) D
13. * Вы должны были получить копию GNU General Public License
    / s/ _* b2 e) J, a8 m  Y! l
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
      z( c' g; Y. e& i9 D* x
15. */

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

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


2. Импортируемые библиотеки
$ \, v( W: r: z; r. D& d
4 T/ O  M0 q9 w$ Y4 l/ f0 K

1. package org.l2jmobius.gameserver.instancemanager;
   ! f" T# C& z8 P7 p6 C
2. 
   1 `/ w5 O  `1 v" w. `
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   9 p  d. @: x6 W& K
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   - r8 J% b( b" Y+ L0 `0 k" n" Z
7. 
   " m) u4 v  |% t
8. import org.l2jmobius.Config;
   7 E. e* q5 I8 X  C5 e
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 — менеджер для работы с игровыми скриптами.

4 N5 o& a$ t" i1 _' _3. Описание класса QuestManager
1 j5 g% t7 V0 y2 _# T

1. /**
   
2. * Менеджер квестов и скриптов.
   # w$ _( Y  f6 ?* y
3. * Автор: Zoey76
   1 }2 h: J0 U6 l# o+ ?& f
4. */
   
5. public class QuestManager
   ' f  G. N. a- [& |
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   8 ]' r3 Y8 d+ g5 J" u! n
8.    
   " m+ \" m) G9 V8 d4 H
9.     /** Карта, содержащая все квесты. */
   . b! C- _" U, X/ w
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    $ d9 |) D& f/ v* c* m
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    0 \4 C% ~; g# `8 D
13.    
    
14.     protected QuestManager()
    
15.     {
    
16.     }
    : v1 N* Y" R" t( V3 ?/ L' _) f
17. }

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

4. Методы
# e, O6 r( W. d% LМетод reload(String questFolder)
. n7 M* W( _+ ?. `. J

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   
6.         return false;
   
7.     }
   , p3 r2 @. `2 L0 Q
8.     return q.reload();
   
9. }

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

. k/ P* O0 ]/ E% F, W% a
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
+ }, L5 S" u6 S% D5 ], C8 MМетод reload(int questId)

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   # S( F6 @, k) Z2 P- D& @
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   1 O; y3 g  T) s% x
6. public boolean reload(int questId)
   " a2 M& y! R* f( N- _3 f: j
7. {
     m1 O! B( ^8 @& D' _, }% {% W. g
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   / l3 C# `  P  O6 @7 I1 T
10.     {
    # J( d  |! r4 z5 v+ q
11.         return false;
    ; x6 f8 Z+ P# j* S8 z0 }) w! w
12.     }
    , n. B1 V% N  @9 q
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  # g$ ^; t& ~( q) I& m

Метод reloadAllScripts()
) d# Z0 J) z" @# ~/ i
' S) ~* u( t5 R

1. /**
   " P9 H1 ?, t: h/ N) P; V
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   , a- H  v! [8 O1 ?
3. */
   
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    $ z% @) j& t, ?6 P9 w
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    , O. \7 u  u$ P  |/ V* B
13.     catch (Exception e)
    
14.     {
    # f& @, l( S4 `0 b( T
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    2 \8 Z- Y1 i/ i% k
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

2 T( D& J& v6 N

1. /**
   9 Y, O: W* J4 u  [+ |; E; p
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   ' G% ~; O, \* b4 t1 ]: g  Q# R. R
5. {
   2 ~+ P: C, N: {2 p% S* n. `
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   # p5 n/ y2 s5 s
9.     for (Quest quest : _quests.values())
   ; M  k- w) j) n# A8 C& ~  s4 Q6 {- G
10.     {
    
11.         if (quest != null)
    ) z0 \3 R* B% d, h* |, H& c& m
12.         {
    0 [9 D' e( O- c/ @
13.             quest.unload(false);
    * v" K, K% X( X+ `5 U- B
14.         }
    
15.     }
    
16.     _quests.clear();
    / O/ c/ l& m) |; ^( V5 M# q
17.     // Выгрузка скриптов.
    - J6 z0 k( K0 P3 C) V8 I
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    ( w1 T9 J1 P8 ?3 w
22.             script.unload(false);
    & c5 G& |1 Y9 ^& S; E# \/ C2 N; z, W
23.         }
    
24.     }
    % d& G( v% g* u$ G( g6 F* s( w8 W
25.     _scripts.clear();
    " `" C0 [4 Z' M1 A
26. }

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

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

Метод report()

1. /**
   2 v, c! U8 X& }! Z4 E
2. * Логирует количество загруженных квестов и скриптов.
   ( r0 j: W( U- S* Z8 U+ C' O+ h- }9 ]
3. */
   
4. public void report()
   & Z) K9 M$ x1 ~3 r
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   ' [! C* g# \# L. i$ M3 _
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

( X6 P! f0 R; o9 c7 R( DМетод getQuest(String name)

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   % c! }" |4 Z: `
5. */
   
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    
11.     }
      [5 G4 D3 J& _6 @; m) K5 R, O4 g
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  2 v7 X" U+ a- Y$ K; F0 p

% n+ M  L' R: S0 S+ M2 I" gМетод getQuest(int questId)

1. /**
   : y! h* m; Y' U* ~
2. * Получает квест по ID.
   " x7 n5 W3 ?7 ?2 P/ u
3. * @param questId ID квеста
   8 j) y$ V1 ~4 s6 q6 F2 w
4. * @return квест, если найден, {@code null} в противном случае
   % u, M; q, |% H1 t+ N: ^$ _! W! y
5. */
   4 X/ C1 R7 \7 h. X- T
6. public Quest getQuest(int questId)
   ' @9 b* c2 q  I2 _+ r- F$ f. |
7. {
   - r. F3 T& t6 X8 O6 Q
8.     for (Quest q : _quests.values())
   ; w* i9 E0 P' f# C
9.     {
   
10.         if (q.getId() == questId)
    $ J( w1 ~4 U3 p4 f0 T9 H
11.         {
    ) T6 m, r+ e4 _8 w- W6 s3 M
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  ' u* t5 t4 H$ ?: T& ^

- }6 e0 ]) @+ K3 ?% a9 y% c5 W: pМетод addQuest(Quest quest)

1. /**
   % b8 Z* t) J- e+ |9 J5 u- e
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   . w$ {' N  ]$ z
6. {
   7 R1 f5 C' H' f$ o
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
     c% g- D" B; w% B
10.     }
    
11.    
    / ~5 [2 Q. M; g/ p* c' w; y
12.     final Quest old = _quests.put(quest.getName(), quest);
    * @" j7 p5 K7 o) w- f$ n$ s' Z
13.     if (old != null)
    
14.     {
    * X3 \2 t& Y) j4 _5 u* H1 n
15.         old.unload();
    4 j- }. |5 x+ ?5 o5 i
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    . V* O, r$ d: j9 ^$ z" X
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    ) M3 n  w# R3 s; M+ h: l2 ^# J+ P
20.     {
    & _' f9 T" e; w6 B% R3 E
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    9 q7 U7 r/ z7 c: G2 @9 |1 r+ ]$ Y
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    1 l# c9 N/ ^8 ?: b
23.     }
    , E6 C: [# X, T5 ~+ }/ o- k2 ?
24. }
    $ I) O0 G) N/ ?; d) ]5 z: a
25. ``

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

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

. G8 o. d/ I1 k* j
: E9 I1 P& j# \