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

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

Разбор файла QuestManager.java
) z/ k1 _; y: c* \' o
- m* X: o* s, j7 K0 i2 QЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
2 P* J+ ^, H- O, ?

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    / i& U: u: N& P1 u# d, k, A
• Импорты
  

$ \: S  I' X+ _( ^" x1 Z, t" d' ^QuestManager.java — управление квестами и скриптами.
, j& d! r' ~, f* m4 z* DПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
! V: a4 N9 [8 k. b* v# P, V

Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
/ A8 X% f' s% r. c4 [+ v) R. ?  a

1. /*
   6 y. I8 C1 Z1 w) x0 x2 H7 H+ C
2. * Этот файл является частью проекта L2J Mobius.
   7 L" z- X: u; ~1 a( |% d1 I: l3 @
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   6 A4 @6 @4 |2 m4 {7 O; d
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    ' J5 ]( J( ^2 O$ v% W  |
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    4 [# i0 S' v9 T! i8 u
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    ! k) F+ A$ d& |
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
1 H& c. s% B1 |  A
$ v4 e7 G& ]& o) U" N
% E  n+ v+ i' d: o7 A2. Импортируемые библиотеки
1 V7 X* @% v' `" k
! t9 V5 L0 C' N; v

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   + B- I3 I0 @+ @1 i+ M2 h
3. import java.util.Map;
   9 O- q5 |% K- ?: Z) {: u; p
4. import java.util.concurrent.ConcurrentHashMap;
   & a! d. H( p- V5 D* j0 s
5. import java.util.logging.Level;
   0 r! L6 T( i  H
6. import java.util.logging.Logger;
   
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   ) }6 |& V1 ^( a: ]$ \( C8 ?' S
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 — менеджер для работы с игровыми скриптами.

. P3 v" d& a6 G3. Описание класса QuestManager

1. /**
   % J2 f5 b( m3 U" z
2. * Менеджер квестов и скриптов.
   8 `3 E; O' c- v$ b' B" p$ }$ Q( d
3. * Автор: Zoey76
   # R8 i( Y/ ]# k) [- ~: o
4. */
   
5. public class QuestManager
   : j2 _/ J, Z& [! L" y$ w# H
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   ' u' B3 q3 u2 G5 T8 O1 R
8.    
   9 t; Z4 [7 B+ `
9.     /** Карта, содержащая все квесты. */
   8 F4 o7 P+ u6 y0 P6 f
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    $ V" d$ C. T3 a& C2 N& B+ r
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    9 C5 k: [/ s4 [" {8 r# G3 }
13.    
    ) k1 n' t7 P: ^) j3 E$ }: o% ^
14.     protected QuestManager()
    
15.     {
    
16.     }
    
17. }

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

4. Методы
4 o% U; m- W% y9 l3 E1 }Метод reload(String questFolder)
4 `" U; M% z, I! j2 m1 [9 M+ G

1. public boolean reload(String questFolder)
   7 _, v8 x: z* V2 ~3 a2 Z# u
2. {
   ) a& O1 R6 F% U0 ?
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   " R6 \$ i+ i& ^6 |8 j
5.     {
   ( p5 `' b& W0 d. j- S4 L
6.         return false;
   
7.     }
   ) }8 l( B( e: g# W5 H
8.     return q.reload();
   # |0 u% V1 z  w9 V% {4 T, z/ W2 b
9. }

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

+ ?* B+ l6 A  ^' C' O% d! _
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
5 o: R9 l) e5 M& \( x( ~! VМетод reload(int questId)

$ U$ F. ~7 A! L' S% J' I

1. /**
   % N& A% j( R- m. W) \
2. * Перезагружает квест по ID.
   4 Z; U2 ^8 m7 _0 F1 }6 A" O
3. * @param questId ID квеста для перезагрузки
   3 |. l. X1 ]4 Q% [
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   0 H: m/ }# _' x& e2 h* B
9.     if (q == null)
   4 c  z( |/ I# h
10.     {
    " B. a% K  V5 ?" s6 A0 m
11.         return false;
    3 h- V/ q) v0 F8 _( X
12.     }
    
13.     return q.reload();
    $ m# k- o: a, x7 N1 ]7 [0 v
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  - Q$ ]% I1 x2 V) y) P1 v

- r3 V- D3 s3 |! u: x- J& YМетод reloadAllScripts()

" u! `9 D0 L4 E

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   : ?. D$ f: S; T8 o
5. {
   
6.     unloadAllScripts();
   
7.    
   6 f1 ]' o2 E( @3 z" K9 Z  }" j
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    ; ?2 C6 s' T9 R5 e' p& S' u
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    # x( |6 w/ a$ {
17.    
    / B, v7 R& U, A/ [, `0 V
18.     getInstance().report();
      r$ [6 d* A. k( V) C0 M9 e
19. }

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

Метод unloadAllScripts()

1. /**
   8 N! U' l. d0 }# z
2. * Выгружает все квесты и скрипты.
   
3. */
   0 ~& O1 |/ P7 `" Q+ x8 ?7 m
4. public void unloadAllScripts()
   $ X3 {3 s% L8 [
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   ; N+ M4 |$ D" R
7.    
   - ?% Q* L8 J6 ]) @8 a2 _
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   1 J4 K+ d) e( Y0 t3 \$ @1 P4 s
10.     {
    
11.         if (quest != null)
    
12.         {
    % e/ w/ x7 f8 p. s2 i: }
13.             quest.unload(false);
    
14.         }
    - t& x0 A( l: s5 ]/ j7 K! h
15.     }
    
16.     _quests.clear();
    9 c7 D) g& Q/ R3 G1 t; K; _) D! z
17.     // Выгрузка скриптов.
    5 U7 x' Z; w; M" h( I/ O# L) S
18.     for (Quest script : _scripts.values())
    . i) r) n  f' x. P9 ?4 Z
19.     {
    
20.         if (script != null)
    . V! M) q; u% z. A; @- a
21.         {
    9 R+ l( i6 X! z( v8 j) ]7 X
22.             script.unload(false);
    
23.         }
    
24.     }
    / h7 a/ W; u& }. Q% D' J) N
25.     _scripts.clear();
    8 K, ^# G$ R" h+ L7 T5 H6 R
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ) `) @: |4 w( v8 h

4 Q. e8 Q3 [% K  D& P: G% Y% v. iМетод report()
/ d* Q$ o+ ^  Z; H; {3 K  @" z
! k3 e; S4 W; c4 A5 G2 O

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   : f3 A7 C. S' C
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   # x2 u7 G! T6 T& i: |2 O
8. }

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

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

Метод getQuest(String name)

1. /**
   & n! [2 K2 m( O; ~6 n6 I
2. * Получает квест по имени.
   , G8 v' n" i, d# T
3. * @param name имя квеста
   ! m/ X( b& e  g. {" h1 h. Q$ i
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   , m% q( o) S; E' H9 m
8.     if (_quests.containsKey(name))
   7 _7 ?1 }9 g; i# z
9.     {
   ( u& ~! v- J" |8 g
10.         return _quests.get(name);
    4 s5 i4 b) X7 W$ G8 b7 K
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

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

Метод getQuest(int questId)

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   # ?! R" k( f" _' t5 Y
4. * @return квест, если найден, {@code null} в противном случае
   8 N) O# b9 P$ t$ n3 w
5. */
   0 G. \8 W+ W! b; [3 E0 [
6. public Quest getQuest(int questId)
   
7. {
   3 n  q9 T" x# N! G+ Z! S
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    , ^9 y6 s- F$ l6 o
11.         {
    
12.             return q;
    
13.         }
    
14.     }
    9 v) N* `! d" a! t
15.     return null;
    6 X# O. P) v1 x5 h% i
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  : y3 J. Z* g7 v# t9 }

Метод addQuest(Quest quest)

2 n" J0 q* S7 q9 ]3 x/ x

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   3 h# P6 J. h+ b4 {/ u6 z
5. public void addQuest(Quest quest)
   
6. {
   + P* V3 B. V' p8 H/ i* m- I6 Y
7.     if (quest == null)
   $ U; B+ r/ J- ]" _- ]2 D
8.     {
   6 x4 i+ J9 x2 n- W: m
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   . {: t+ {3 M6 o8 v5 ?0 B0 A1 z: x/ h
10.     }
    3 ?6 q. T& g( C
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    " ~, }& l9 e, j3 q: A
13.     if (old != null)
    : a5 {: S$ u6 ?. G
14.     {
    
15.         old.unload();
    6 q( {+ ?0 x2 r* s# _
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    , z- Y. M& P6 W# I1 r
18.    
    
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();
    3 U- ?) Z2 ]) m1 }
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
4 R4 i3 q. Z: MЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
# B9 A1 J# ?: w4 H( Y
6 D4 s  t# i! u
1 C2 S$ z4 Z3 _. w/ e0 P  l5 _
/ B- b$ \8 h4 ^1 |5 x