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

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

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

; y- X& w* f/ X4 Z2 CЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
. {) e$ M# @. p8 T" I# w. H6 d3 n- VОсновные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  ' s6 M$ A- ^( z1 T* U) }6 B6 q! n

QuestManager.java — управление квестами и скриптами.
2 |- B  ^: L6 S! |Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\


Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
% R; ?$ p7 `9 v% X7 ]1. Лицензионное соглашение
# N% N' V5 s0 ?( x

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   2 z7 z. \3 h2 \" H  @
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   * T- J( F5 u- J* Y+ \
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    : Y" Q& C0 Q% W" k9 q: e4 n
13. * Вы должны были получить копию GNU General Public License
    $ ]5 e5 q6 X1 ~
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    $ c& `. Q& A* \& m: G  g
15. */

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

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


7 q) g: F; F! }4 c5 O2. Импортируемые библиотеки

0 }) a8 U# o, x, r" ?

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   2 {5 U  I' q9 X" }: H, C6 a/ w. L) a
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   3 c9 z  ]& T, ^. z' t" H7 o
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    1 }! I" h9 h& L' U9 g/ Z( U/ z
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 — менеджер для работы с игровыми скриптами.
+ k+ d; U- O7 R7 P
5 J+ Q' v: i% ?" Y( o3. Описание класса QuestManager
# ]6 O3 e1 l3 u2 H' _

1. /**
   5 V# t8 x4 D$ V7 c2 x$ y
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   " k3 ]/ ?! z4 Z, T- ^
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   3 `: |1 z) [, l: E8 T: A9 E( F
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    9 `5 U( g0 Y+ A# l7 U' l
14.     protected QuestManager()
    
15.     {
    $ {% x! z+ K5 q- d) k& Q) }2 i
16.     }
    
17. }

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

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

1. public boolean reload(String questFolder)
   ' h& x5 J; |& R1 S4 u
2. {
   
3.     final Quest q = getQuest(questFolder);
   9 P9 J* ?( _% q/ U% J4 r
4.     if (q == null)
   2 K5 A) c4 y' M9 y! H& r
5.     {
   
6.         return false;
   , h+ d$ K+ K. W9 u! Y) r
7.     }
   ! R- e& F8 W$ z- ]
8.     return q.reload();
   
9. }

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

# v" f! G1 Z, T- `
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
. t" S/ M: x7 |. G5 qМетод reload(int questId)
2 ^6 r; c5 {1 J4 z

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   : {* m; c7 D% c! d
6. public boolean reload(int questId)
   
7. {
   8 F) {' E% _& Z5 g6 N
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    4 g  W+ `3 |7 I( \& ^
11.         return false;
    " x, A" |! N0 o8 }
12.     }
    
13.     return q.reload();
    + q9 B  D- `6 L4 b9 p& F' m
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  ; s0 M$ s8 ^$ F! w3 T; ]

Метод reloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   5 f: V) C: f  g7 ~( P4 _; P
5. {
   : M+ Z1 Q5 r, [& U3 r
6.     unloadAllScripts();
   
7.    
   ; d! M: }1 P0 J+ d: ?5 x
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    # J1 k& t0 C" X
13.     catch (Exception e)
    
14.     {
    - U% e/ v6 `  B, H
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    . X9 b2 \, {' L1 P8 h8 @
16.     }
    1 ?/ m; _! B9 f8 Q) d% L" E
17.    
    8 `- `  N/ j- s& \- V# G! i
18.     getInstance().report();
    : N4 ^  G* h! j  D7 I9 }3 m
19. }

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

Метод unloadAllScripts()

1. /**
   * ^& C5 J% ~5 T9 p
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   
5. {
   4 {) U* a: Y" `! ~
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   + A6 M: o2 d/ s3 ~0 l8 K5 }
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    ( I/ O. A4 F! f6 q8 E! m
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    
14.         }
    
15.     }
    & j2 u. ?. T- ]0 s! Q
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    7 i8 |# M0 S, c- w+ M
19.     {
    
20.         if (script != null)
    % p1 I0 l3 q: [2 C; }
21.         {
    8 _/ u2 H. n2 v) b' P- B# g( E! `
22.             script.unload(false);
    
23.         }
    / u, L7 B1 |5 P  B
24.     }
    " h- [7 F" R  r1 k7 e
25.     _scripts.clear();
    - @' m- l0 r' C( j. N
26. }

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

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

. v  q! i$ T/ |Метод report()
6 b: j/ j, z& Q$ J6 f
! z$ k4 q+ u  Q% `

1. /**
   ( r' Y! ?2 A7 k! p  t
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   
5. {
   , I8 n+ V; O+ O$ @5 b4 J# }
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   # p9 y# R. B) O% Y/ r
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  % h  u3 c  d* Q" \9 E7 t5 ^

. h- S/ z& f- U  C4 ?: fМетод getQuest(String name)

; }; u0 J9 b. n( w+ S  V0 j

1. /**
   - ^1 q+ U# E% ^: Z
2. * Получает квест по имени.
   7 C# i+ w& K4 E8 O
3. * @param name имя квеста
   
4. * @return квест
   " T4 q/ H  l: O+ q# p; s& p: j
5. */
   6 ?& J7 l. e0 `& }# f
6. public Quest getQuest(String name)
   0 P: Y# P) e1 t( o
7. {
   & O9 S7 E% D) z/ r& {' E
8.     if (_quests.containsKey(name))
   # u. H+ F2 [1 r- U2 I
9.     {
   
10.         return _quests.get(name);
    
11.     }
    ; y% d6 Q3 A. j( g( G" D
12.     return _scripts.get(name);
    
13. }

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

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

Метод getQuest(int questId)
/ ]% v( @, P- X' p# t: d
7 R. j+ Q/ B; l( W+ O

1. /**
   5 j% U% H, [, b4 c
2. * Получает квест по ID.
   7 ^7 l5 B' Z3 H5 [) e! R
3. * @param questId ID квеста
   : d4 ~  Q0 h0 s' I' J  B+ e# ?
4. * @return квест, если найден, {@code null} в противном случае
   1 U2 d0 W- G* X. h" U& Z
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   5 U2 ?7 A, Z! G
8.     for (Quest q : _quests.values())
   % ?" X8 _" o* ~- Q0 B3 Z: y: n  w
9.     {
   , T. n. ~' M- M" G: r
10.         if (q.getId() == questId)
    $ ^) \2 y6 z+ W8 Q
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    * F- S0 l1 \: U6 g" j. J
15.     return null;
    9 ~! q* [1 d. u5 l1 V/ }5 J1 c% f  x
16. }

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

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

Метод addQuest(Quest quest)

1. /**
     X# v; U7 q% H7 ^
2. * Добавляет новый квест.
   & H3 }: W5 U# G5 _$ E& `
3. * @param quest квест для добавления
   + Z; c1 ?- m: h7 b% t. |! Z2 E
4. */
   0 L6 g1 K7 a5 R
5. public void addQuest(Quest quest)
   ; {6 Q- {6 ^% d0 |
6. {
   6 Z: O! \* W8 J
7.     if (quest == null)
   
8.     {
   1 {2 U; D# C' M2 i
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   1 F4 v- L1 Y3 ]8 W
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    " j- ~4 l9 ~3 M& k
15.         old.unload();
    ' e8 _# r6 {  b6 }. w
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    9 v/ j7 A" x4 T% `0 V  U
17.     }
    
18.    
    ( i' U' [- b! n# J
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    * }( V7 b* I6 U2 w! A* i8 B! }
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    2 r# P" J/ W* O3 t% c9 ^
24. }
    5 b, w! t7 p8 h  _- n- P
25. ``

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

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


7 i; R6 q$ F+ o$ p2 l