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

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

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

0 k1 {6 z# l% u6 _2 U3 fЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
1 i; H! h% N% Z4 }$ _- OОсновные элементы
/ e! x* [: A/ f+ t% g; {$ U

• Лицензия
  % f6 [. Z0 ~# J" t4 m3 `9 Z2 q
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    ! U# X4 {$ Y/ J2 Z& M
• Импорты
  

1 j3 C8 I9 C8 ^+ Z7 _" q6 cQuestManager.java — управление квестами и скриптами.
* O& }+ E/ E# G! k/ X: m, n: SПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
3 J7 ~; x% {' F! I

! k" d% {1 g) Y* [3 RДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
/ V* \2 B/ R2 O$ l" l) f) Y

1. /*
   ( c0 L1 u0 I1 z) u( C9 S. f/ b
2. * Этот файл является частью проекта L2J Mobius.
   4 Y; @& S7 d& j/ E$ o" Q: O
3. *
   % B7 ?9 P7 r( A% M8 g0 ?5 `8 b
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    + w: ?: r0 C) Y: i& H* o
11. * См. GNU General Public License для получения более подробной информации.
    : \0 {2 C1 ]/ `4 J& x8 F
12. *
    - e9 F! b" o% G* ]( \% w* W
13. * Вы должны были получить копию GNU General Public License
    - i  O$ E8 Y6 A! X: c9 d% K
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
' R9 A. p7 J( _- |: X0 U

! O7 v/ ?% Q; j$ G1 i2. Импортируемые библиотеки
/ C6 h, W" h& Q& ^" h/ f
; H, m" e% Z) G. k: z* {* ]7 S

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   ) }( H' _; R. n& `4 t7 M9 K
6. import java.util.logging.Logger;
   
7. 
   / v- h& F6 R' ?8 E$ U* P8 L2 o
8. import org.l2jmobius.Config;
   
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 — менеджер для работы с игровыми скриптами.
0 j4 e0 b. l: s  {
9 I5 _) y/ j- w6 I# M% N3. Описание класса QuestManager
( p: |$ n3 h8 K  C  D# C' f$ @

1. /**
   
2. * Менеджер квестов и скриптов.
   7 L- Z4 E4 S- T8 D3 _! M. c
3. * Автор: Zoey76
   ' N1 X% d4 R" J$ ^% p
4. */
   
5. public class QuestManager
   + w4 a: M7 P7 q" N, G, m3 y
6. {
   1 K8 P# a% R5 E
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   8 r' t! `1 g0 Y7 O" ^1 ^( b8 l
9.     /** Карта, содержащая все квесты. */
   2 J: ^! U  E% v8 `4 S) q$ h
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    3 H/ D1 h5 y1 I1 N/ u& ~
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    / D% F, c0 [3 x6 x. E
13.    
    
14.     protected QuestManager()
    . o8 f- ]* g0 I8 W" s5 g
15.     {
    
16.     }
    
17. }

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

4. Методы
: }; d; _6 Z  B; o2 y" c- ^: jМетод reload(String questFolder)
' I2 _6 s5 f6 |4 f" w* @

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   8 a2 j6 n: @: }; A
4.     if (q == null)
   
5.     {
   % ?, [1 h" y+ n0 U+ e
6.         return false;
   " @  B9 r7 k, D  V
7.     }
   
8.     return q.reload();
   
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
) ]9 ^& b" u2 O7 p+ J9 L* UМетод reload(int questId)
; o1 ]( g& _* e2 t3 _) U/ Z7 |

1. /**
   
2. * Перезагружает квест по ID.
   % n, v% [' {: R" R
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   , c% L2 }/ f( {$ H7 j1 S! ]
6. public boolean reload(int questId)
   , J2 M+ `4 d0 l( o- K
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   7 x* U& ~7 g! K/ V$ o, {# }' C% G
10.     {
    
11.         return false;
    : A% Z0 D7 V, J
12.     }
    ; u& B; J! C8 Z0 l$ ~# ^
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  6 L8 b/ x4 R& i# q9 w# a2 W

Метод reloadAllScripts()

1. /**
   7 ~, @+ k8 n+ B, x7 P
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   # M3 N  c& U8 B5 Q/ _6 y
5. {
   . T1 E, z( u, V3 t8 X; b9 M
6.     unloadAllScripts();
   0 P5 `' V  N3 O. I0 ]- Q7 w) c, v; O
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   # s0 n7 b; T+ S) l. C% w) \
9.     try
   7 N5 `9 x' M0 _8 y& c
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    + d# ~& C$ M: A8 l+ ]
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    
18.     getInstance().report();
    ! a: h( ?, j) N1 v& T4 ?: B- G
19. }

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

Метод unloadAllScripts()

' M% y# E2 F2 e  C6 h0 _

1. /**
   
2. * Выгружает все квесты и скрипты.
   . F; F5 X# h+ U0 s- v
3. */
   
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   6 s" t1 \8 A  W/ r
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    ' _/ Z: Z) y+ O& z! V7 [- a
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    
14.         }
    . Z' y! p1 \" a' d" d' @
15.     }
    7 A& z( _/ @/ x8 j1 P# O
16.     _quests.clear();
    5 B/ M5 W& i3 j: o
17.     // Выгрузка скриптов.
    ( N6 e6 Z0 \1 e  `8 b+ i
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    0 I) r; Y& {0 p1 I7 _# c
22.             script.unload(false);
    
23.         }
    
24.     }
    . J) |2 J9 N# v3 ]- t8 I
25.     _scripts.clear();
    
26. }

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

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

Метод report()

1 t# r; F. N+ P% L! e$ m3 m8 t6 E3 \

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   6 }4 G8 W7 i* @/ m
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   9 t/ R- z0 d8 H/ A+ i! ^
8. }

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

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

Метод getQuest(String name)
& E6 K+ p, m# {( p

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   ; D' t7 T. _' h+ [7 W6 `" G; ^( S
4. * @return квест
   
5. */
   1 j) V; ^8 a) E1 T5 O" h
6. public Quest getQuest(String name)
   
7. {
   % a4 i/ Q0 Z- D* ~& U( v2 s# C$ n
8.     if (_quests.containsKey(name))
   
9.     {
   # l6 I( l1 W/ {1 y- H$ z, o
10.         return _quests.get(name);
    $ F2 O" }* ]* u7 Q+ l$ x. t* x
11.     }
    
12.     return _scripts.get(name);
    / [: l4 \; v  k* [  E* f( P% ~
13. }

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

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

Метод getQuest(int questId)

, P* j' _% h! y. w

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   3 V9 X4 [" ~8 O
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   % U! I4 x( G- K0 ]  C* }3 i+ \  @
6. public Quest getQuest(int questId)
   ! i% ~2 f8 D0 I) q1 |
7. {
   , l1 H; c- B9 I9 r, |( {& j# k
8.     for (Quest q : _quests.values())
   
9.     {
   1 }: a3 H/ @/ i$ [( k4 O4 |7 u5 V5 I2 ?
10.         if (q.getId() == questId)
    " q& r* x# l# M" K. d
11.         {
    
12.             return q;
    3 v  x1 b0 m$ B" N- N# u, M
13.         }
    & o1 }7 U  K, s& a3 q5 N
14.     }
    
15.     return null;
    
16. }

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

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

" D$ @8 d* K6 C" p/ I9 o- JМетод addQuest(Quest quest)
" {' L( u, w, z: m9 N. [& J; n

1. /**
   3 B  a. i6 l) a" d$ l/ r2 Z! W. s
2. * Добавляет новый квест.
   % r2 D$ _. {7 H: ]
3. * @param quest квест для добавления
   
4. */
   / F3 L( a7 G  j& @1 m) n" Q
5. public void addQuest(Quest quest)
   9 k! F, d5 s7 E4 `1 R& @
6. {
   $ \+ E- H5 e5 B2 ^
7.     if (quest == null)
   # C+ O4 V  U& u/ I" s
8.     {
   9 l8 D2 ~3 P6 a8 i
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    7 p1 E9 l" w6 ~# W4 h! f
11.    
    7 h9 D! I  ?, @3 `( ]. }5 L
12.     final Quest old = _quests.put(quest.getName(), quest);
    2 a# b4 Q+ i- ^0 n7 f6 _" Z
13.     if (old != null)
    
14.     {
    ! g+ e6 t1 \) V
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    2 d3 g5 o# u7 i
17.     }
    3 D% e, w3 q" f/ }& t. L
18.    
    1 g0 w, [9 K3 I6 W, A
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    % R3 k4 Z5 m3 e
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    5 b1 [; p. q: i! G$ M* c* Q5 u
23.     }
    + W3 F% Z9 |* k) a3 W/ e$ o. s& _
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
) M. n9 L# j& E1 N5 kЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
  g" ]# b0 s1 z* j3 p! M6 `: Q


* Y6 ]. s7 s. k. J: w, G1 G4 u