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

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

---

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

) [* `$ ^/ H- p: C# x  ?7 \Разбор файла QuestManager.java

/ \8 a  d/ O& @" ~Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
    s7 u( _4 ?6 a8 T
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    3 C4 F+ b" Y- F% E
• Импорты
  

. Z) @3 {( \4 |: s$ \. |QuestManager.java — управление квестами и скриптами.
" B. q$ J8 \$ ZПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

. z1 ]+ q9 E/ R. c
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
7 t$ d6 O6 r( t. ^, z  A. F4 j# K1. Лицензионное соглашение
; a* x% n  h* x+ B$ L

1. /*
   " S6 y/ y5 z7 B/ N4 K9 ?
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   ( z- B' ?$ S: |2 n% T- x+ e
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   ) F/ k) i5 k- b' R9 `$ m
7. *
   6 v" K" M& V7 a$ @
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   3 n/ Y3 h6 e" x1 m
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    8 p! T% J$ k! j* {; q
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
! H, W! Y2 C& N* M" Z

2. Импортируемые библиотеки
3 ?# S; O' W  y3 {; ~
; \+ t* \5 v# c/ \

1. package org.l2jmobius.gameserver.instancemanager;
   7 ~% @5 K3 m: u/ @3 Z  y$ k6 v
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   * g) @) X5 e0 x% f8 _
6. import java.util.logging.Logger;
   
7. 
   - k4 r1 B$ E9 V6 n1 Y, s9 s
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   
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 — менеджер для работы с игровыми скриптами.

3. Описание класса QuestManager
7 A" p: Z) _0 u

1. /**
   & P. N% O/ k) W9 D1 f3 u
2. * Менеджер квестов и скриптов.
   1 d9 I( r8 e1 T" ^( K( F7 J
3. * Автор: Zoey76
   
4. */
   . W3 H. o: O% S" }
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   # S7 K. L$ d* J2 v7 M  C
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    , q6 V3 [: h; Q4 r6 Q* ~
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    2 Z4 h9 d+ j+ c: Y: U) E# t6 _
14.     protected QuestManager()
    % q5 |* X' X! K/ c: F
15.     {
    * _7 a" O4 A# Q- E5 W
16.     }
    
17. }

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

4. Методы
1 K1 V+ z! q# l+ k! ^5 }! YМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   
2. {
   ! `/ `8 o0 C2 t3 |5 b. I
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   , n9 w6 u5 h# x2 u: [
5.     {
   / ]* X: B  y, `3 H. I  m
6.         return false;
   
7.     }
   8 _, |+ n4 k% S- s# \3 B
8.     return q.reload();
   # q6 x# \3 b' N) S1 ?  E0 q
9. }

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

7 w4 ^6 \8 Z; P4 |
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
! b4 \; [& l. y0 D3 ~/ FМетод reload(int questId)
- j/ \- C6 o2 M3 d0 O3 m3 W( z3 z

1. /**
   
2. * Перезагружает квест по ID.
   6 M. G9 d; {4 m$ F
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   ) e* ?+ n/ z$ n8 h# N
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   4 [5 V/ T9 X+ f5 _" U6 s3 |
9.     if (q == null)
   
10.     {
    
11.         return false;
    
12.     }
    
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  0 b' y, v1 o% i$ }* p3 a( p

Метод reloadAllScripts()

/ F7 ?$ d# @2 l- @5 ?( h

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   , f. Q4 j, A6 R; f) k
5. {
   
6.     unloadAllScripts();
   # s7 y) z: A0 ?! o# U/ z
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   $ |/ Z5 f' ]" @
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    . Q1 X* Q. p) Q, y# M
13.     catch (Exception e)
    
14.     {
    9 R; z& `- A5 e, [% @. K) }
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    / Z1 L/ y. f/ P' r1 }5 L
16.     }
    . k8 N$ F" N# x% G! r, L, u. l# x
17.    
    % c$ y+ F5 V' T8 _. C6 O
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   
4. public void unloadAllScripts()
   & T& e- W" f9 y+ L% w7 x
5. {
   * X8 C2 y2 V0 `) `* m
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   ; J. @, o. H2 l; P
7.    
   : ~6 ^% v5 Y4 N+ }; t
8.     // Выгрузка квестов.
   0 m7 I+ K% }1 m) H/ ~
9.     for (Quest quest : _quests.values())
   8 v" ]3 }* Z( P
10.     {
    
11.         if (quest != null)
    ; T0 O, ?$ y5 O* o9 ~$ _/ Y% Q
12.         {
    
13.             quest.unload(false);
    
14.         }
    9 ?1 N! u" R: c. m* T
15.     }
    
16.     _quests.clear();
    $ K* M& C" {, }) ]5 r$ f  I
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    6 k9 O9 m0 y6 {; b
19.     {
    . [2 x. V- e3 H: W+ t
20.         if (script != null)
    9 b. Y0 W! H6 W  W; o
21.         {
    
22.             script.unload(false);
    ! K: b$ c( j; @4 f6 N8 E+ a
23.         }
    
24.     }
    
25.     _scripts.clear();
      `7 I1 U6 s9 r! w* _- Y
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ; c/ C, p# O8 i6 C1 [3 q

Метод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   6 @* F; i/ [( q8 n- e0 M
3. */
   1 k7 E: r5 r% p5 o
4. public void report()
   " S: e  H  ]6 f; d6 I0 z% m5 T6 ^. N; R
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   4 l% I! d; m5 P
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  3 h$ N5 B) H9 O7 ?! z

Метод getQuest(String name)
6 x! M/ V+ q# _0 H. r6 G; J! w
7 @+ _2 I. n* j& y# b3 d  f3 o! G  k

1. /**
   9 x5 t  H- H% o) Z. W& b
2. * Получает квест по имени.
   6 G/ p" a2 S  d- }4 B
3. * @param name имя квеста
   " S  G( {; d* m2 }
4. * @return квест
   3 ~/ u$ r& ]* N5 a0 c7 ~
5. */
   
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    
11.     }
    5 B3 o3 M$ q  U* t3 G5 P( w. B
12.     return _scripts.get(name);
    
13. }

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

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

Метод getQuest(int questId)

1. /**
   
2. * Получает квест по ID.
   4 w( t+ W" A6 T+ I
3. * @param questId ID квеста
   % h9 O: J% E+ t) o1 F
4. * @return квест, если найден, {@code null} в противном случае
   4 K' d. v$ P  @( q
5. */
   9 G6 B. u+ p$ p- V: [7 J. {
6. public Quest getQuest(int questId)
   # H& B7 a% g1 V/ R
7. {
   
8.     for (Quest q : _quests.values())
   0 h; N! w  a6 r- g
9.     {
   
10.         if (q.getId() == questId)
    - N  P& e& v7 Q* J1 p2 X' [7 B
11.         {
    ! L+ b: O( U1 Z7 ?, m( m
12.             return q;
    ( e1 Q- J4 D' S1 K: d- c5 w
13.         }
    + O! K" ~' r. q5 N& F
14.     }
    8 p- v6 ]* T3 q" F- T, w# D
15.     return null;
    
16. }

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

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

" A! v. K" ~* z' ]5 I, F( |Метод addQuest(Quest quest)
, n- f7 {" l) C, h/ V# u! _. L
. S0 g0 a+ w2 ]# O" j9 s

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   9 V  T- x3 w2 W' g: f" [8 K3 V
4. */
   , M4 N. b. C7 n# y, e1 @$ d; f
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   0 t  s8 S6 c# W% ?; O
8.     {
   8 G  R/ h4 R7 H1 W/ U6 `
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   8 r9 G0 l1 l: U5 P
10.     }
    
11.    
      J9 i$ D3 z: w+ M) T9 s- a/ e
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    " M0 N2 I& [1 L8 `$ J# d8 B' d% T
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    , c& c# Q( u6 P+ s( {$ O2 Y. y
17.     }
    
18.    
    " s( a% \) s1 D9 c
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    & z* U6 W" Z8 [3 ~' P6 h
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    : d+ J, N- S4 x
24. }
    . N8 Q/ x3 T0 i1 v% T
25. ``

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

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

$ a  g! p- |$ ~. n

---

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

Powered by Discuz! X3.5