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

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

3 t# C# d# K3 a9 e+ Z! MРазбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
" j5 z, b1 t. N5 z) J% lОсновные элементы
) Z4 q$ e+ ?0 O/ [& D4 \7 y

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    ( _: T* t3 \6 Y! _$ Y9 Z. q
• Импорты
  

2 J+ x! s/ A# r9 x+ Y% JQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
5 g7 l/ J0 [+ u, G2 q1 n

- `& _0 m: t0 U6 _% XДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
" O# L# R3 E: A4 X

1. /*
   # S2 ^) R1 R9 Q+ B+ }& o& ?
2. * Этот файл является частью проекта L2J Mobius.
   3 ^2 r; K$ J# D' a
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   / P. t; e3 Q. ]: F& O) x7 |1 J
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   * `( `, d; g( G- g0 G7 Y) E
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   $ n* j# z" O5 F6 i1 C$ ~
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    7 ]$ Z( X' v9 H# J
13. * Вы должны были получить копию GNU General Public License
    # {- R. }0 c$ |. V' G, l9 W
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    * E. y7 H  P5 v' G/ i6 b
15. */

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

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


8 v2 d7 ]$ O( q% z1 t( U$ n% \  c2. Импортируемые библиотеки
' b  l  e# y, f
# k2 [8 [6 }! A* |$ |

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   ! Q1 h; {# q1 t0 y) ^4 N/ U
5. import java.util.logging.Level;
     t9 U3 |1 \9 h# C5 o
6. import java.util.logging.Logger;
   ) D1 M; H( b" \2 ~" a" Y
7. 
   2 b4 e2 R* A$ W/ n1 L# L7 H" G
8. import org.l2jmobius.Config;
   7 T$ C& Q) n: D' f8 b8 z/ M
9. import org.l2jmobius.commons.util.CommonUtil;
   $ l' V. S4 p1 T9 j1 ^
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 G  T) M- {) @  F
3 y; l# l- b% _* l* D3. Описание класса QuestManager
( c& \- U7 p9 u$ n+ X

1. /**
   
2. * Менеджер квестов и скриптов.
   0 C' C8 M8 d6 p
3. * Автор: Zoey76
   ; I. n4 f, U( P& X3 x& r
4. */
   - L0 H* U6 T/ M; ~
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   2 f% s; G8 [9 G6 e
8.    
   
9.     /** Карта, содержащая все квесты. */
   , M( `/ b" I. h! F$ Q6 r
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    & \# O+ m# _2 J  A. V7 i
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
      |; `, d! }. {/ J, P2 Q7 ~
13.    
      j2 Q+ `/ a5 G8 C0 r
14.     protected QuestManager()
    9 d+ B: a) i. P
15.     {
    
16.     }
    
17. }

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

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

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   5 ]$ n( o* h- i+ o& r
4.     if (q == null)
   
5.     {
   / Z& U# o* D7 Y% [5 E1 Y9 O
6.         return false;
   
7.     }
   8 B- z1 p5 `* Q1 O' d; k9 M/ H
8.     return q.reload();
   
9. }

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

7 L/ \) D; D" {, J2 l
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
& ~+ W( Y) P, ]8 F6 j# U

1. /**
   $ U- `7 U. @" d. X
2. * Перезагружает квест по ID.
   , b! m5 O; I8 s, z5 J# z* H
3. * @param questId ID квеста для перезагрузки
   9 a; ?( s0 I. ~& ]; R6 i
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   $ S& i% r, q* z6 \  Z
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    
11.         return false;
    
12.     }
    ) E1 m/ z. R$ o; N" m9 d% Y9 {
13.     return q.reload();
    6 F6 _! m+ }: h( D1 @; ?! c
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  ! F; \, p' H1 i! l* I1 Z1 z

Метод reloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   ' i" H. Q1 r! m% e% R
3. */
   
4. public void reloadAllScripts()
   2 I. u% q8 B0 A. J4 j
5. {
   0 G: |! p! _: \9 b" A
6.     unloadAllScripts();
   " y( i) `! \! w/ E! x4 ~: x
7.    
   6 H8 M; {9 U: a' C7 [2 ~6 E  _
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    2 A4 Z4 I& F) [0 c( M
12.     }
    
13.     catch (Exception e)
    ! n: ?! P7 v/ T+ P+ V* B' {: q1 @( G
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    / J- T, k3 `0 [" B
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()
; a- H) a8 I! M9 o! W" @/ T1 _
/ \" i- p8 G& r# p: q2 K* V- W

1. /**
   + [! {- T7 r! m
2. * Выгружает все квесты и скрипты.
   ; O6 L) S" r% A/ e8 B/ t1 d* o9 O
3. */
   5 a2 S% }/ f5 Y7 [
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   ' ?# \- {" ~: Z, w) g: X9 d
8.     // Выгрузка квестов.
   5 N* e. ^6 P* P. Z
9.     for (Quest quest : _quests.values())
   
10.     {
    ' g9 {: ]$ h0 F$ H% S! V3 O* K# t; g2 ]
11.         if (quest != null)
    $ y5 U" `& W3 i6 N; I
12.         {
    4 a0 B- D/ ]. H' O
13.             quest.unload(false);
    
14.         }
    
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    ( x/ i- `5 P$ d
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    3 q/ z  R& A& o5 ]( U: f& R
21.         {
    4 P+ {) C8 J) d: J! I+ Y' m" S
22.             script.unload(false);
    * U# C; j6 x" j' G' m5 J
23.         }
    9 P- U1 F, r) k& F* E5 q
24.     }
    
25.     _scripts.clear();
    ' S; q' h7 m0 q
26. }

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

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

Метод report()
! O  _  _( \6 y5 M" S
1 j" {( b6 d9 l5 N" k

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   0 z) H. _7 p0 x& G
3. */
   ( o; Y3 z1 l: o9 ?  Q
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   * O: P1 _: {8 E
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  " ^. t% N$ g" C  }

Метод getQuest(String name)
4 y  u. n) \5 Y% `; f

1. /**
   ) [8 R) p( {& q# V3 v
2. * Получает квест по имени.
   ! N" A" f3 A6 P- H3 _1 R
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   8 L, }& J. W7 m
8.     if (_quests.containsKey(name))
   
9.     {
   3 y7 a2 g  k: l' [. }; n
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    $ T/ Y% s1 q; `2 g# V3 o1 l! N: f
13. }

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

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

Метод getQuest(int questId)

" D! s( v3 o* G& }  f- t

1. /**
   0 P5 S, G) J; p  r
2. * Получает квест по ID.
   $ l7 d3 k0 v" [, e( K
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   8 X  H/ T" a$ x% ~8 @
5. */
   
6. public Quest getQuest(int questId)
   # x! F+ q9 H' O- A% {2 V
7. {
   1 j% n3 b* x0 x
8.     for (Quest q : _quests.values())
   
9.     {
   1 d! q( h8 k3 Q) K2 v  K$ m% b6 T
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    % K. B* |' q: J6 k5 ]
13.         }
    
14.     }
    
15.     return null;
    1 q1 U/ ?7 z5 Q
16. }

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

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

Метод addQuest(Quest quest)
& p' p1 q7 J, ]1 \4 D+ [3 c  t' e
3 a. [0 \) P. V8 s2 Q# G5 O1 j5 r

1. /**
   
2. * Добавляет новый квест.
   + D: q/ m# R! _9 f2 Q+ ^5 J" M
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   + X. `4 W( |( I7 I/ [+ C2 U8 A+ f
7.     if (quest == null)
   2 M8 J  X8 b5 O* |# D' Q
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   * }  q+ P* V- C+ O; r
10.     }
    
11.    
    ' Z9 p9 a. t4 F8 `4 @
12.     final Quest old = _quests.put(quest.getName(), quest);
    ) y* _9 J" b7 F5 G
13.     if (old != null)
    
14.     {
    " M/ l7 r! ^# d6 d: ]
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    8 s0 ~6 @5 h% J5 c7 \! u$ D
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    5 y# k$ A% p' A
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    ( h: i' W6 D: S$ M8 R; `) h
23.     }
    " b. ^% W" {$ M5 q' Y1 P
24. }
    
25. ``

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

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


6 a" d% d1 M; i6 `( e* I
% C0 J$ O, u5 v0 D