artace.ru - творческий сектор

Название: Гайд по основным Java-файлам ядра сервер L2J_Mobius [Версия для печати]

---

Автор: admin    Время: 2024-9-21 10:39
Название: Гайд по основным Java-файлам ядра сервер L2J_Mobius
Гайд по основным Java-файлам ядра сервер L2J_Mobius

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

# l& s+ [( r7 UЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
( E2 E; E4 B  ~Основные элементы
6 R8 _. a: m4 r$ [4 [

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    + ~: l" u7 v8 d, p! b  O7 f: w
• Импорты
  

* e* J: S1 _# l- U* t' z: p7 sQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

9 o' I; u8 t" G+ ]% u+ W
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
, v! W$ m; q$ y1 s& s1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   . o2 {+ J6 L' j9 s# u
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   ! U  W% E/ {4 m6 K
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   0 h6 h0 @8 c3 `' O  |! c
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   . `* _! v2 N3 j, q8 X
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    . ^" [, J8 o# v9 d7 Z- Q
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    $ P: C/ m- z0 e' I1 Q* _
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    & f1 U( U* Z/ \5 w
15. */

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

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

$ c5 ?) H3 Z; p
+ w3 f: N8 a) w$ m# L" t/ K! W2. Импортируемые библиотеки
; r$ B5 M* m& C& G  f% ~$ O
% y0 N" v6 K; c6 g

1. package org.l2jmobius.gameserver.instancemanager;
   % F* t# x1 O: A4 Q
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   ' I$ ~  U7 p7 D' `# \; c, A# O' e
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    ) E7 d; x9 ^6 r( g
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 — менеджер для работы с игровыми скриптами.

* [* a0 ?9 d2 x0 B% {  n1 T3. Описание класса QuestManager
: i8 m4 V  A, H8 G; t1 h

1. /**
   
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   
6. {
   9 I, T6 W7 K2 ]9 i# L/ a
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   9 r6 B% L  X* P: |! a2 [/ E
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    ( g% F0 ?1 S, w1 d( `" Z' b4 F
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    ' R* j3 |/ x( z. `
14.     protected QuestManager()
    3 u6 V$ h0 }- Q7 B9 A3 t$ r  M6 Q
15.     {
    ' J: [8 P% L$ B" i: k' ~% p! v
16.     }
    / l* j& o: n" ]" i
17. }

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

4. Методы
2 j, |. k: T7 P8 |- Y' TМетод reload(String questFolder)
3 a7 P# ?3 T0 _3 l

1. public boolean reload(String questFolder)
   
2. {
   % [# x: h; r% Q  G0 M. E
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   
6.         return false;
   
7.     }
   
8.     return q.reload();
   
9. }

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

% v# m7 S3 L3 S6 ~* i. c
0 e3 u; U4 @& L. v! ~! KМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
2 ^, H5 V& ^9 i1 |  |5 L
# R. ?1 `  t9 ]) X

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   . j$ W$ @+ V/ [, ]" `- n0 `
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   ! S( x# d* Y9 [% b* q4 C
5. */
   $ y$ t7 B* F; C. O' S
6. public boolean reload(int questId)
   
7. {
   2 p1 Y* A: o# {3 Q4 ]/ q0 F, x; Q& d
8.     final Quest q = getQuest(questId);
   9 W0 C1 O) u$ f1 g. _2 z5 I7 Q) K2 v' j
9.     if (q == null)
   + a: d, T0 ]" M0 t7 }
10.     {
    7 J4 l( d% t  x$ @( P8 b
11.         return false;
    , J5 J8 M' ?* ]0 i& K: N
12.     }
    
13.     return q.reload();
    9 T, W  N+ ], y% D; R3 e
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  ) i# D7 h) J7 ?+ M1 J

- D8 E  G) x/ d5 A  e* e5 ?Метод reloadAllScripts()

1. /**
   ; O3 `7 j5 s& L! S9 O; d
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   5 `7 h' _/ D1 n4 U- j
3. */
   2 |/ {, N. A9 c8 J' F
4. public void reloadAllScripts()
   
5. {
   0 Y6 f; A1 @: ^" n0 z7 C
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   ' p3 R% A3 D2 U/ K" ]$ E
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    
14.     {
    5 Y) E7 `& e+ R$ K; z
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    , D3 Q- @" v7 O' H! A/ J  B- _
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

( A" I6 }6 E) u, \

1. /**
   
2. * Выгружает все квесты и скрипты.
   , t  C7 p9 T7 G! }
3. */
   7 b, B- Q6 G9 C
4. public void unloadAllScripts()
   1 J; R! I, M% F% |
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   5 X5 Y# C4 S3 @4 O8 H% b5 P
9.     for (Quest quest : _quests.values())
   
10.     {
    
11.         if (quest != null)
    - }  Y+ A0 g: v! s& L8 S/ I
12.         {
    
13.             quest.unload(false);
    ( V! m( ?1 z% t4 k
14.         }
    - @- k, P7 r$ }: e. q% ]5 i
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    . u+ g% O; E8 M$ i1 Q) N/ E4 O
18.     for (Quest script : _scripts.values())
    ) `: S" ?2 D% ~6 e
19.     {
    3 |' |# Z7 }% M- z9 {& T% A
20.         if (script != null)
    * {- e+ A/ G+ R9 I# G$ ?: ?
21.         {
    
22.             script.unload(false);
    
23.         }
    - }& G5 c* X$ }; l& A) ]" B- B
24.     }
    
25.     _scripts.clear();
    0 b" Q- R% E  \/ j$ M! ]9 ]
26. }

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

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

% k( w. n: l6 o6 cМетод report()

1. /**
   ) s9 |( B6 f0 w5 Q* _0 w
2. * Логирует количество загруженных квестов и скриптов.
   3 w6 W' f- Q- F% q, Z
3. */
   
4. public void report()
   9 y/ c4 P4 ^& u$ h. b
5. {
   , }. p7 C. V) t6 j4 F
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   : L& w; G% G* E0 \" c7 z
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   - \: n- z8 a0 B9 I8 P- j5 [
8. }

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

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

( `- c; |  Q4 C. ]* Z3 Z" mМетод getQuest(String name)

  h3 K. O% `+ B6 t

1. /**
   , C- }& p  n0 U' t
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   5 O6 W4 z5 V0 U- X
7. {
   , C  F( c; L8 u2 Q- E) w' ?
8.     if (_quests.containsKey(name))
   6 \6 x5 X6 z: H8 B9 B" c8 C6 X- w
9.     {
   7 ]9 u$ _' f4 M9 @& x0 R# M7 k
10.         return _quests.get(name);
    8 G. K' X5 ]4 T* v
11.     }
    2 A- E$ r$ P* n' h; z- R6 m
12.     return _scripts.get(name);
    , L/ f' R3 A6 ^" s& r
13. }

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

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

: ]" c, [, @9 W1 {' D' K8 HМетод getQuest(int questId)
0 C4 l4 C, Q" C) }" {& r
) C4 s; M& @3 d# q% N5 q" l

1. /**
   - O6 g5 K# _7 p, v5 k
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   2 H2 A( i( ~6 T0 C1 t
8.     for (Quest q : _quests.values())
   
9.     {
   * v3 i2 d* u+ x3 B2 j" B6 _
10.         if (q.getId() == questId)
    % a) h. C( j0 U) u3 q6 p' |
11.         {
    1 x  G, M1 h, F/ a* C8 ^5 h
12.             return q;
    4 {5 G; Y0 d! u
13.         }
    
14.     }
    
15.     return null;
      K  r, d4 r# V1 q& a
16. }

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

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

6 I( p4 F' g' t, M/ c" g  J  ?Метод addQuest(Quest quest)

' R* x0 A) r: l4 n6 e$ [

1. /**
   
2. * Добавляет новый квест.
   ( m* l4 Y7 {' _6 M  q3 X& X3 I
3. * @param quest квест для добавления
   
4. */
   8 m* l- M# z1 H$ _( t
5. public void addQuest(Quest quest)
   3 L0 H0 I( V2 L' ?( }; `
6. {
   
7.     if (quest == null)
   4 w2 J. H5 S9 N+ a4 t
8.     {
   - n/ T* {+ S4 t' q  T! a7 z5 ~" G# v
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    % q3 ]  g5 v- j* O: y  u' Y
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    0 k3 B( E; F5 q/ U
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    6 ]* C0 e1 T( k
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    0 y5 {) w: y8 v- {: V6 _
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    . q. E3 D% n! f' q; U' M
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    / x7 _9 v6 |, k4 ^7 R, p
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
# b; q2 y, \$ X
0 B4 v: T! W: V  e, |

---

Добро пожаловать artace.ru - творческий сектор (https://www.artace.ru/)

Powered by Discuz! X3.5