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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
( V  x7 {' o( f/ ?6 h
Разбор файла QuestManager.java

% @7 M6 o) T5 l" J" E: L8 a( r+ kЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
) @+ i) I/ i! |

• Лицензия
  4 a! h* w6 p/ z8 ~. o
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  % C3 Y0 g, M( Z, _

# s2 |% A1 r9 y0 }QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

! _- e0 j# g7 A+ f/ P) ^
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   # R2 n+ B- B- ?% L4 W
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   7 I0 u" o5 O- s+ Q/ ~- [; x$ l
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   3 K/ y+ N& @% E; \- y( F! `9 X
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    ' e5 F& t6 L+ N2 v+ Z8 g
12. *
    & F3 `6 G; O) ~3 ^0 I, c0 q1 r
13. * Вы должны были получить копию GNU General Public License
    0 }( a6 L. B# _0 n+ G
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    8 \& k+ z4 o/ j% c. f
15. */

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

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


5 L# d5 |) I3 X- T. T. m* N2. Импортируемые библиотеки
; o: N5 U1 f6 z' o0 u/ Z% ?; O5 U
% P! Y% \$ R5 x+ Z1 |: Y

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   $ R( o5 }+ H+ k% i) }
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   # {, y3 N+ I1 o+ R- i
10. import org.l2jmobius.gameserver.model.quest.Quest;
    1 K1 E% y' d9 J) U1 h' l  x
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 B0 Q% b, Q: J+ U' y) G' T1 W
3. Описание класса QuestManager

1. /**
   
2. * Менеджер квестов и скриптов.
   5 m1 F, ]  _& O6 @  y$ S7 u
3. * Автор: Zoey76
   $ ?# C9 I( ]+ k1 S& ~+ q* }$ F7 `
4. */
   
5. public class QuestManager
     l/ f' N: x# h; _  _$ m
6. {
   - Q& m; U9 I8 ]) ]: ?* v2 H/ E
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   ( P( K: |4 V' f4 K3 {. e
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    % T1 H. L& w% `* }3 J
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    9 l: [1 S/ q2 x) m
14.     protected QuestManager()
    
15.     {
    + @: n' h9 H( P! \, a. T
16.     }
    
17. }

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

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

1. public boolean reload(String questFolder)
   : F( u, \. e1 V' m" ?
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   
6.         return false;
   " k( b9 N9 K7 Y0 ?
7.     }
   4 q3 S7 r1 K  S$ x, k
8.     return q.reload();
   
9. }

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

* e# C7 ?1 E! |4 A- e
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
1 J# d- q7 A2 y% X% Y3 V
) N( n$ \* y' n9 f& `0 Y

1. /**
   
2. * Перезагружает квест по ID.
   7 u# d' W8 h! R% K; u3 F8 B3 @
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   : G- ]) L. M& l! i1 z% ]
5. */
   # X: A3 e2 |0 \  k
6. public boolean reload(int questId)
   ' m1 A- \& C, u9 e8 J' p; D
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    
11.         return false;
    
12.     }
    
13.     return q.reload();
    7 ?) b: w  V4 L) e
14. }

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

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

$ A6 y+ N) p9 {2 @Метод reloadAllScripts()
; }' n/ V/ T/ e
( `, k! _- r6 i  K5 B% |  @) e

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   
5. {
   1 s7 v1 a9 x2 T% \* Q4 `2 m
6.     unloadAllScripts();
   9 Q  A3 s6 I+ e9 U8 X4 U- C* c
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   5 m  N3 y+ W9 C$ V! S# Y/ ^8 Y# y
10.     {
    - F% D+ |2 d0 Q
11.         ScriptEngineManager.getInstance().executeScriptList();
    3 o& t2 ^* N6 E# Z
12.     }
    
13.     catch (Exception e)
    
14.     {
    2 U% {. G) v8 t5 J( @$ r
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()
6 x7 I, T. A% m2 S8 @) ?
1 U- @; e8 p% f5 j; m2 Q7 E

1. /**
   : ]" o8 I7 o: K( O! N3 F; {
2. * Выгружает все квесты и скрипты.
   
3. */
   % l0 I& Q% I3 B! |$ F7 z
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    " b* E" X8 h/ V% u4 N
12.         {
    
13.             quest.unload(false);
    / O" Y0 [+ ~9 z% ~1 N- y8 f
14.         }
    ) y  u; n- L1 X
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    $ Z. G6 r! C7 Q( z  {
18.     for (Quest script : _scripts.values())
    
19.     {
      G* |& \5 s" P0 b: M
20.         if (script != null)
    / T# M+ S/ e+ ?3 T: {
21.         {
    
22.             script.unload(false);
    
23.         }
    
24.     }
    
25.     _scripts.clear();
    
26. }

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

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

' D8 X# K% N  W: B0 x8 y/ ]( WМетод report()
  F  w$ G; R5 p% u' M" ~2 W) @$ Z) P
9 P; @; h3 X' }1 y

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   : m$ S$ K6 A( _! A% z
3. */
   0 e  X3 a1 f0 o8 Q' D& @' `
4. public void report()
   : f! o6 ~2 f: |- A6 H
5. {
   - h" z* O+ _: t8 w7 L: D
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

( n: R9 q2 y% \! _2 @Метод getQuest(String name)

6 w* G' {9 R, ]/ @: d& i8 j( y. D

1. /**
   
2. * Получает квест по имени.
   6 P' w/ \) u( H$ L) k
3. * @param name имя квеста
   1 S/ t+ q% J- N% [7 w
4. * @return квест
   
5. */
   : e! D3 e6 x3 E  N& ^  x8 S0 |
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   + d% p4 E' }: ?0 l' v2 [
10.         return _quests.get(name);
    / ^, |6 D" K6 E7 D% K! b& p+ w! K  ?  @
11.     }
    
12.     return _scripts.get(name);
    / S8 u. `9 S1 ?) P
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  + l! g% q% p$ S; l, d' x" l

Метод getQuest(int questId)
/ g( N/ g( f8 `: s

1. /**
   
2. * Получает квест по ID.
   ) s7 j( D- L9 k" b
3. * @param questId ID квеста
   7 N+ H( ?. L% K
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   % m, Y1 j4 q4 N. L/ ?9 c
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   / N; ]3 J7 X- O- p) D, y. O2 E
9.     {
   " T. S4 Z0 n- Z% H( E
10.         if (q.getId() == questId)
    - z* [. [0 ]3 X6 f6 H
11.         {
    
12.             return q;
    4 s0 [) K/ V/ N  H" a
13.         }
    . e8 p: F' B9 L- @7 A; J! @6 I
14.     }
    
15.     return null;
    ( l( l! Y1 j6 f  h
16. }

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

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

( v- X: n1 D% Q2 C  HМетод addQuest(Quest quest)

1. /**
   . S8 ?- I; g2 u# [3 o
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   + B6 _' h7 q7 [5 J
6. {
   
7.     if (quest == null)
   7 M7 [1 Q8 a/ g( h$ e
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
      U) V" y1 v; \0 H
12.     final Quest old = _quests.put(quest.getName(), quest);
    # q% v7 I9 Y/ `; t! d) v
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    " F6 c, X7 u! [4 {: M& O
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    $ l, X, A' Q  C& [9 z0 c
17.     }
    
18.    
    # p! }4 W3 c5 p, {& @9 J( U
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    ' @4 \2 X: E: f1 b, f
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
      o" C4 s3 Y, x- h1 S  g& }6 F
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
- n  _2 m$ W# r0 o, `& \ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.

- V% j2 W" D; V* w, f; J8 s
+ O* B8 o  E) @0 o1 \- L