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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
' q* H6 Q! m7 D8 e/ h! {& c
Разбор файла QuestManager.java

0 l" S9 \0 `$ A0 d, X1 v& {3 U; [Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
( l3 Z- m' A' W0 f. y& U9 D' L

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    8 n+ J( c/ v3 t* N. R& A# e+ B+ H
• Импорты
  " x6 z8 p$ b; D$ c

QuestManager.java — управление квестами и скриптами.
0 F% N! _/ e& Q4 e( `" O0 O( v+ lПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

1 i( V/ d- C8 ]# q
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
" i8 [' v1 [$ J! R1. Лицензионное соглашение

1. /*
   & t- `& ^1 z* }) J. E3 W1 S) E
2. * Этот файл является частью проекта L2J Mobius.
     Y$ a( {* L2 B# E' ?
3. *
   % M  a7 G% {1 Q- v( u( R
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   4 f9 t0 |! P" G6 {% S
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   0 a% G- e5 |* n
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   * |& X( t0 ?9 v. A  A  w: G
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    5 b; U8 z! g) g% X+ y' Y3 d9 J
12. *
    
13. * Вы должны были получить копию GNU General Public License
    6 B5 j% X1 e0 I1 x3 d
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
$ @) K7 I# f) L6 @% Z

9 z* x& G. i+ c' u1 }% u# w, O2. Импортируемые библиотеки
% l& C8 {% D# ^6 p8 Q

1. package org.l2jmobius.gameserver.instancemanager;
   ' M% q! N- c: X+ Z' ]
2. 
   # [) @( I0 |0 v* @, {; ?4 j' I/ R9 C
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   : p- }- R! `3 {' L7 t
5. import java.util.logging.Level;
   7 G, ?+ v4 Z9 G- ~7 Z7 S
6. import java.util.logging.Logger;
   
7. 
   $ j/ T, [$ J7 b/ x# c( F
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   ' C; X7 x% x% P7 P: M! {8 x
10. import org.l2jmobius.gameserver.model.quest.Quest;
    " a- j" |: A/ c5 |" n" f
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 @5 i7 K- _: ?2 S( n$ ]
5 g4 q0 w" S6 W% J3. Описание класса QuestManager

1. /**
   0 R0 B0 h1 U  ?1 D' ^
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   7 }* C# R7 b7 `- r; i1 p2 X$ {8 {
6. {
   7 g8 H9 m! r& n! u3 o  q2 {
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    ! E/ _8 }* a# h) d! u
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    8 Y, Q+ _8 z# K5 A( n
14.     protected QuestManager()
    
15.     {
    
16.     }
    8 d& C, i) U- }; A% l- v' Y
17. }

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

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

1. public boolean reload(String questFolder)
   
2. {
   * S7 v, _, N& y2 A0 d
3.     final Quest q = getQuest(questFolder);
   2 ]9 E4 t; A1 u4 `
4.     if (q == null)
   . w3 t# Z3 I  Q( S# L
5.     {
   ) l6 o  S9 Q5 z' w, @) Q
6.         return false;
   
7.     }
   ! u) S/ f0 {: {
8.     return q.reload();
   
9. }

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

+ _# U9 C' t( J0 H; C4 sМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

% K2 x" J# q+ b6 a

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   & X. K$ i& T1 C% U! z
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   2 c( C) [# J# \$ \
5. */
   ' W& S* [  ]; S9 ]# Z. t! X0 I7 T; ~
6. public boolean reload(int questId)
   
7. {
   2 H" N1 m. C2 S  [1 ?! W- c  ]' W5 T
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    
11.         return false;
    
12.     }
    8 \' V+ C/ O# K1 ?7 H" c) K# N1 A) d- o
13.     return q.reload();
    . j* ], v8 B  D/ G+ @- O. a7 d* h
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  " G6 S! N) `% ~8 q

Метод reloadAllScripts()

1. /**
   2 E5 q2 b$ C7 i
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   ) O6 u" l2 F# g* ?! C6 r- L
3. */
   
4. public void reloadAllScripts()
   1 @' q( y( C* X. F& O/ ]4 M
5. {
   
6.     unloadAllScripts();
   5 W9 J+ Y2 k) e: ]( F5 y
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
      W+ W' ]- t: K9 u/ i% S
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    ( l6 O2 ~* _+ M/ Q: \. ~
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    , n# N8 T, Y' u% n" D
18.     getInstance().report();
    8 p9 K5 O5 i% H0 U7 e1 U% Q" z# \8 G
19. }

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

Метод unloadAllScripts()

1. /**
   # s2 K4 _* h% e6 r* a! L8 d& h9 ~
2. * Выгружает все квесты и скрипты.
   
3. */
   + s* A: e% d' A+ H" W1 f# \
4. public void unloadAllScripts()
   . G4 B# x- t$ d) u' ?5 E
5. {
   1 U& ?0 M0 s8 p2 P! F* j$ V8 W3 d
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   . B: F& w. l8 `
7.    
   / N5 D0 B. g; D
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   8 ~. o7 v& M5 J; |% F" d
10.     {
    
11.         if (quest != null)
    
12.         {
    4 F+ w6 x) s3 Q4 M
13.             quest.unload(false);
    7 A; h9 }# F* L1 A* i4 S
14.         }
    
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
      r4 K3 s4 O+ \( j9 O9 i1 y! X
18.     for (Quest script : _scripts.values())
    
19.     {
      B5 l' `- G: ~( q
20.         if (script != null)
    
21.         {
    2 g, q% a# u5 J  }. Z' J
22.             script.unload(false);
    ( V  |. d( j7 q- [3 ]
23.         }
    
24.     }
    
25.     _scripts.clear();
    , M% M3 [) h! X+ t9 ]6 b! A: Z9 z
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ' U4 }# n$ z4 j" |

' z/ Z$ h5 f) Q: D4 E7 Q% @! w) CМетод report()
. e& Y% `6 G/ \% f
6 W- z3 S! a3 u: c$ e% N

1. /**
   8 @4 C: ^* C7 P/ x* i1 W4 @* l
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   % d6 S3 B& m2 V
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   % B8 s$ @& M! H2 _3 r8 z; n% N
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   ; Y5 Q1 w+ A* ~8 B. A' s* x% C" R
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  # B% M& V" @6 O) Y1 Z

Метод getQuest(String name)

1. /**
   
2. * Получает квест по имени.
     K/ L6 Y5 g) z4 h
3. * @param name имя квеста
   , T" k) ^! u8 `
4. * @return квест
   
5. */
     g4 T6 [/ C7 C- ?$ C3 e! m
6. public Quest getQuest(String name)
   
7. {
   7 B: ?1 w0 y7 f" p1 o8 Y( m4 v
8.     if (_quests.containsKey(name))
   " V, h0 x  d5 e$ Z1 ?5 ], X
9.     {
   ! W( }+ J0 t' H+ i) y
10.         return _quests.get(name);
    
11.     }
    6 |" }" m* ]% P! m3 p5 S
12.     return _scripts.get(name);
    
13. }

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

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

) t1 I! M7 ^' r# e1 aМетод getQuest(int questId)

1. /**
   & Q2 Z1 c. L& w: h+ B" n
2. * Получает квест по ID.
   9 o3 k3 t) B) C
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    
13.         }
    4 M) J6 P/ q# S" {+ P/ N' N3 U
14.     }
    " i" V9 u9 N) L  P. v# ?' l" `
15.     return null;
    
16. }

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

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

' C6 m3 }0 W, x% E6 r! LМетод addQuest(Quest quest)

1. /**
   
2. * Добавляет новый квест.
   $ w4 f! u1 g" Q. ]# V3 F
3. * @param quest квест для добавления
   & i1 _# f! m+ t) d
4. */
   " b  k; u+ f  q: P9 T6 k
5. public void addQuest(Quest quest)
   
6. {
   2 d$ H& t( A4 m0 v1 c( {  j# U  s
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   . f8 l4 J! o+ {- v8 w
10.     }
    % E, M6 f, Z* R6 l% v4 _
11.    
    5 |& P( h  J; D/ f, ^6 ]" m* J% b
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    ; V; U! s& w3 y5 e
14.     {
    1 N. v% X$ c) m. i
15.         old.unload();
    2 r! f% T# b7 ^
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
      z; W5 V; v" h4 M1 ]6 m  u9 |
17.     }
    + J/ u4 Z  R. _, A
18.    
      `6 R5 y' ?# d
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    $ ^" X/ j3 E: Z3 Z
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    
25. ``

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

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


( j7 h# o! ]8 X! C% P5 Y  ^4 p