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

Гайд по основным Java-файлам ядра сервер L2J_Mobius
. U* B) @7 Q4 J2 @9 Y6 e
Разбор файла QuestManager.java
7 ]4 n- z$ X* f* v* G- I
! z, s2 B5 @; [! f* Z- \$ @Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  * Z8 R9 d6 J' B  _7 e2 E7 W& o' ?
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    8 O# w2 u' \. @: |: I; L
• Импорты
  

- S1 d3 B: s& X, I0 }QuestManager.java — управление квестами и скриптами.
8 E, y& B1 a/ c, o$ RПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

$ \( B9 n3 i" O
9 ~  u' g1 a; B' ~  }! tДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   0 _( E6 O, W$ x1 O# u) Q$ t, w
2. * Этот файл является частью проекта L2J Mobius.
   " d3 c! P7 _- z% W4 q( C  S
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   " l: r# ~; Q; Q2 j5 B7 P& ]
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   1 E+ a& ]" v8 o
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    ! O8 O7 Y2 S: L( P: L7 Y
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    6 V: s/ [" R" o# z
15. */

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

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

. o+ X/ D" P6 W  k
2. Импортируемые библиотеки

! o& F" y; j! f7 `

1. package org.l2jmobius.gameserver.instancemanager;
   % X( q; D# e6 |* Q
2. 
   3 w* c+ R* L# ?7 b! N
3. import java.util.Map;
   $ |; j& a8 H& m9 U1 d- p. E( N
4. import java.util.concurrent.ConcurrentHashMap;
   # c0 u% H5 @" b6 t& U7 W; [" d( ~
5. import java.util.logging.Level;
   6 D) D/ C' i3 p2 N: h9 X2 s, n5 N
6. import java.util.logging.Logger;
   
7. 
   + z; L0 o" c) O4 s
8. import org.l2jmobius.Config;
   . {- I+ [" b' X$ H; Z' d6 R# a
9. import org.l2jmobius.commons.util.CommonUtil;
     `; M, k8 b  n* y
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 — менеджер для работы с игровыми скриптами.

) }7 E! I4 U9 d- d9 Y2 Q' V6 V3. Описание класса QuestManager

1. /**
   
2. * Менеджер квестов и скриптов.
   2 ?- c3 v/ B) f! a/ @- e, c
3. * Автор: Zoey76
   
4. */
   5 J- v( f9 |- k* v  l
5. public class QuestManager
   
6. {
   & y: ]) m1 x: g* m4 \
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   3 X2 K+ g" s7 m9 p- L" l
8.    
   
9.     /** Карта, содержащая все квесты. */
     M3 M' `% P4 a/ Z3 s& O* |
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    . U+ E) J7 f* x+ B- x; g* |0 s
11.     /** Карта, содержащая все скрипты. */
    + |, B4 z) ^. S6 I" h
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    : ~0 i6 n( F. I  x
13.    
    
14.     protected QuestManager()
    
15.     {
    . \8 u5 `0 _. I: W7 A2 A- M
16.     }
    
17. }

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

4. Методы
/ F; l: W+ \2 D. d$ P5 f2 m8 J+ aМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   ! k# ?% o( n# C5 [
2. {
   $ G6 `+ H; Z, h! w7 J
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   8 u; x9 D( j, T* W" B0 h
5.     {
   
6.         return false;
   7 n# }6 h2 w* V) Y( O* A' H- I9 V* I
7.     }
   2 ?6 N9 c: i( l4 e1 S
8.     return q.reload();
   % C$ l7 H7 w  K2 m
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
3 ?- n. x" _+ w6 Y8 [+ X! |! {2 V

1. /**
   7 j# T) h6 h  j# R
2. * Перезагружает квест по ID.
   & ^9 h, @5 f3 h4 @' ]! K
3. * @param questId ID квеста для перезагрузки
   3 l1 f$ f6 o2 {( @" u* q
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   ' |5 K3 D% g2 C# @
5. */
   
6. public boolean reload(int questId)
   7 A6 t- F* o! R  R" H( W
7. {
   - [# g$ `; W. d  i
8.     final Quest q = getQuest(questId);
   $ Y4 K: Q  E# K) _
9.     if (q == null)
   
10.     {
    
11.         return false;
    0 m* `# n, b  p- f
12.     }
    4 ?4 ]2 Z" z* ?+ F2 L$ P: l7 k' |, K
13.     return q.reload();
    & F: y4 B, s. P+ Y! b
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  " |4 f% b0 ~- W. m+ K' c

; S3 M( z; }/ w  ]( CМетод reloadAllScripts()
! L- y( l$ l) ^+ h8 E7 Y

1. /**
   5 E$ \  G/ b) s2 }2 B
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   & y3 ^" V3 _" T( ?: d! P
3. */
   0 g0 g! I" S- m' z' y
4. public void reloadAllScripts()
   & A+ f8 w+ }7 G+ s4 w$ x; r
5. {
   " Z8 L# v% Y4 K! h4 r( c5 [  z
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   0 d+ o/ h" o7 f4 `: Y9 Z: B
10.     {
    ) j, H  ^- l' [: \# O; u& H! I/ U
11.         ScriptEngineManager.getInstance().executeScriptList();
    7 F4 d1 H2 x+ D3 U, O( y8 t* x
12.     }
    
13.     catch (Exception e)
    ' F5 [4 i) l/ D
14.     {
    ; y2 W- W! p  b5 [, g: V
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    6 y: V3 B6 q" k: o1 j
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()
9 B- i+ @& y# N0 v# n2 C
2 c+ @) ]' w1 ?1 `$ k

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   0 D( i4 z9 ^3 _7 y
4. public void unloadAllScripts()
   ' v. E% ]. y: y- F1 S. t
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   * c  ]: z  D1 |+ K+ D3 o4 [% ?6 d9 o1 M' [
7.    
   
8.     // Выгрузка квестов.
   5 |0 N1 S7 S8 {, ~
9.     for (Quest quest : _quests.values())
   ; V. ^% K( V9 w% Y
10.     {
    
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    1 X7 q; m5 [0 c
14.         }
    
15.     }
    
16.     _quests.clear();
    0 D# M4 d  a/ P. O1 h' y6 Y
17.     // Выгрузка скриптов.
    6 x% G: `; f; f( n5 B+ \# d
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    
23.         }
    , ~5 ^: a* A0 z' V
24.     }
    6 r) z7 W# q- E/ R7 N- `
25.     _scripts.clear();
    
26. }

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

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

4 ?# t* w/ [* M9 @& P$ Z# EМетод report()

/ F1 D7 I0 g  G/ B$ o

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   # M7 o, w3 L$ S8 i$ |
4. public void report()
   - S: B$ U/ P8 d
5. {
   3 B. ?+ o4 \0 O5 C6 x* V0 F
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
     N. E! E4 h9 y6 T$ I' E+ z
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

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

! \( s+ Y# u$ r6 m; h, n8 R! xМетод getQuest(String name)
7 G0 o. ^) v" f
: u( Q7 e- C  ]- d& z( J7 u' [

1. /**
   
2. * Получает квест по имени.
   8 Z6 x) C  n7 K8 d! C
3. * @param name имя квеста
   . e' M) ~# ^7 k
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   . v: W+ H) q4 S8 u, W. C! s
7. {
   4 p- e; d1 E  Q- E- R
8.     if (_quests.containsKey(name))
   
9.     {
     C  ~# `- K& c' X3 K+ G5 T
10.         return _quests.get(name);
    
11.     }
    + e) J% E, O9 b, Y
12.     return _scripts.get(name);
    1 z" b0 Q9 c; p9 e6 s1 v
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  0 i1 }1 D. A, _9 O, }1 ?9 g& u/ r

7 \4 I0 R8 M7 Q) I# iМетод getQuest(int questId)

1 W$ E5 f" [3 Y! w: [& o: q4 X" \

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   # u& h4 F4 K& ]7 N: [) r' F
4. * @return квест, если найден, {@code null} в противном случае
   2 P' p/ s% z) a7 u1 D  Z( B
5. */
   $ a" j3 s% G  H' f$ z) H* V
6. public Quest getQuest(int questId)
   
7. {
   & a. ]. _. E' ?( ?
8.     for (Quest q : _quests.values())
   ' k& N  B3 R: Z, F+ x
9.     {
   
10.         if (q.getId() == questId)
    : A& }4 [7 s! w% h
11.         {
    
12.             return q;
    3 K9 W7 c7 v0 z2 M! ^6 y
13.         }
    . R2 l. E, i3 g2 V0 [2 u0 O, F
14.     }
    6 \: V+ T* f5 B
15.     return null;
    
16. }

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

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

# O% K5 z! A  yМетод addQuest(Quest quest)
' k4 C5 O4 [9 A4 I* X" g) t

1. /**
   1 H  ]/ u8 L; S/ U% _4 Y% y% r5 @
2. * Добавляет новый квест.
   , O. N' I5 J# \
3. * @param quest квест для добавления
   6 C0 m' R) B# F& S
4. */
   & U4 G7 C% M5 Z: z* ^1 e& h% Q$ ~3 \
5. public void addQuest(Quest quest)
   - ^" Z/ I# Q8 w
6. {
   % a8 a8 j* Z- B2 c! ]; _
7.     if (quest == null)
   & U! \; n1 U- w: [
8.     {
   + f& O6 z  O% H5 G
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   6 k: p7 m$ A) ?# C6 b* b
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    - h7 y9 C, T+ M& e6 J( S
14.     {
    $ b; }/ }; l1 s6 ~6 S' K  Z' G# m
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    1 Z5 z/ }2 u. [! A
17.     }
    
18.    
    0 c$ T# S; z2 g4 Q5 l7 o: V9 T7 ~# N
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();
    7 X. B, G  m8 c. [
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    0 p* p, ?6 b4 J6 X. T. D: N* u
24. }
    
25. ``

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

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