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

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

---

Автор: admin    Время: 2024-9-21 10:39
Название: Гайд по основным Java-файлам ядра сервер L2J_Mobius
Гайд по основным Java-файлам ядра сервер L2J_Mobius
5 |7 E* C% a. r+ e8 Y; }. R
Разбор файла QuestManager.java

, Y3 R$ V7 G' AЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    * d" L" y! Y  {
• Импорты
  1 ^7 }; j, G- \4 c- D' ~6 N6 l

& G: d9 V5 P2 c1 w' u9 F, y& EQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

3 J# t3 V) N: Z; G3 w! N8 {* i/ d
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
2 r+ ?7 \% L# ^$ W

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   ' ^; l, r8 q4 x' S6 Q
3. *
   4 l) ]% }* U2 G
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   3 M$ [" L3 Y5 p9 X5 `& L
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   8 s2 Z1 W9 \# ]) G3 O2 r! h2 f
8. * Эта программа распространяется в надежде, что она будет полезной,
   ; |; @: h* Z0 y" W
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    + ?- l8 _* p, Z5 D/ b
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    , V: d. a5 U5 o4 Y; p2 v
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    ) S/ l. `5 O# r( S# @) J
15. */

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

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


* X7 R8 @) Q% R" U' n2. Импортируемые библиотеки
( }5 q1 {! l8 H( F7 G" }

1. package org.l2jmobius.gameserver.instancemanager;
   6 T, `1 U# k8 N$ p, n
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   . N: S7 {1 N: l" [7 `9 V
10. import org.l2jmobius.gameserver.model.quest.Quest;
    " T6 O1 O7 ^9 P% _& _3 v5 |$ Q0 \
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 — менеджер для работы с игровыми скриптами.

9 Q8 c1 M6 B( \: p3. Описание класса QuestManager

1. /**
   
2. * Менеджер квестов и скриптов.
   0 O" M( d' h7 E  c7 A8 R+ t6 H6 ?
3. * Автор: Zoey76
   
4. */
   . d* l: |+ I5 b4 ^" {- e. o
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   1 ?" O2 M0 |. ~7 W& F# x
8.    
   5 y( @7 @4 C. o
9.     /** Карта, содержащая все квесты. */
   7 s8 X% t$ t/ B3 l
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    & W7 y  h! X$ K- m5 O
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    % }+ \' T: W; i3 _
15.     {
    
16.     }
    
17. }

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

4. Методы
Метод reload(String questFolder)
' i7 T, A" z5 j

1. public boolean reload(String questFolder)
   
2. {
   - J3 t: u! [5 I8 X
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   * y6 g8 W( ]# W* |6 z% I; J- w
5.     {
   9 J/ S6 r' J. M0 d; g
6.         return false;
   - c- a4 p+ {% N9 J7 b- A* o) r
7.     }
   
8.     return q.reload();
   ! \2 {* `* a9 r" u0 @3 Z9 c
9. }

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

Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
0 J3 m" e+ a; C* O1 [Метод reload(int questId)

1. /**
   
2. * Перезагружает квест по ID.
   " t2 l" K! l) Q% O$ S
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   8 d6 g6 J& j( g( |; K- E0 U
5. */
   
6. public boolean reload(int questId)
   5 f: W9 _6 w% |9 Z) J9 `
7. {
   
8.     final Quest q = getQuest(questId);
   & D8 B$ k" b! i* r: q( o
9.     if (q == null)
   
10.     {
    
11.         return false;
    ) v4 O; a- x  u1 P1 f
12.     }
    9 I$ L6 H- U) t* G" _+ h2 _
13.     return q.reload();
    + s, w$ j& K% D$ ]3 F7 |
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  

1 v! w- ]# h( b5 ~- y. h( j3 FМетод reloadAllScripts()
, L3 \' @( ~8 |" ]8 o  P: g

1. /**
   ; V  ~+ U% D7 H+ H: ^, ?
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   2 D5 t2 g  @- i: @1 _
3. */
   1 W# |) I. O5 d; Q
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   0 A' \3 r% {3 t4 p  f$ q1 W0 X8 f
7.    
   5 o5 O4 r# f5 R* j8 a
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   9 n  P# s: J/ n
9.     try
   9 M; i1 u0 O9 N' P- @
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    ; j. _4 k9 i- }' H
13.     catch (Exception e)
    
14.     {
      k: K5 Q, Z2 }1 T- w. Z) \; c% W2 F
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

# p' {% o' d& ~0 z* Q2 `, M

1. /**
   
2. * Выгружает все квесты и скрипты.
   1 D0 K9 \; V) z2 O+ n- Z
3. */
   
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   - v" Q3 `2 q' @% |
10.     {
    & ]1 J  Q& p( A
11.         if (quest != null)
    
12.         {
    - p4 G/ T+ U: m+ O
13.             quest.unload(false);
    4 P+ d% B+ X9 F* R, B6 J4 ~7 T
14.         }
    6 K& u) t3 G; m" V
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    ! C# i7 N3 ~+ s6 u0 y
21.         {
    ( l- _8 q# W& T7 f; R  l" `) y/ c
22.             script.unload(false);
    
23.         }
    
24.     }
    2 P$ g% c, e/ o% [# g
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  + a# s/ @% a$ b/ @, O

Метод report()
+ S" M/ @4 `& {4 o% W
3 S8 v5 d, K% S+ d4 P  C2 b+ x

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   8 s; k: h% A: l5 d9 w
3. */
   
4. public void report()
   + n- _* L, w$ \) f% l# x1 R5 I  m
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   1 V) w) d# ]* T
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   & R' n9 Q# k# l) O: x
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  . B- y& |' @. \- [" c

Метод getQuest(String name)

5 A+ S# j4 r) P' u: {, _# X

1. /**
   
2. * Получает квест по имени.
   2 ~  f) G5 x7 o) L
3. * @param name имя квеста
   
4. * @return квест
   ' m2 J4 ?% S' X/ Q/ G
5. */
   
6. public Quest getQuest(String name)
   5 C/ e+ L' J' c+ ]) |
7. {
   
8.     if (_quests.containsKey(name))
   5 o7 y* [" h. B7 U$ r* `
9.     {
   1 t5 g/ U& X2 U( X. S$ v- N
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  6 J% g* V+ f+ G  d

% }0 X% f9 U  h; \+ A1 FМетод getQuest(int questId)

  T5 K' Y) J4 X- k. x, N

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   ; X2 b* h4 ]# F. `
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   9 |$ z! @$ u# R% P
6. public Quest getQuest(int questId)
   . M4 v' V, P8 c6 C, F2 G! d
7. {
   0 {" U; D- ~, Y* {; s! r+ [
8.     for (Quest q : _quests.values())
   
9.     {
   4 f4 g9 O+ ^! d5 n5 u2 \
10.         if (q.getId() == questId)
    / @9 u3 c' h& `2 [. W. o
11.         {
    5 y! s; J! e) H; M; ], r: c
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  - A& D, y5 ^' G2 S7 G* n3 G

5 g% h/ f4 b$ n+ ?; dМетод addQuest(Quest quest)

1. /**
   
2. * Добавляет новый квест.
   3 Q& H9 p8 t/ R5 F: w% P7 s) C
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   ) @8 ~2 m$ n7 |/ }8 y2 w
6. {
   # m+ u1 @2 P" E* ^4 s
7.     if (quest == null)
   * r) H5 S) `5 Z2 }* G5 G- G/ C4 n
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   - T0 V+ r; o  f) ]  _, d0 L/ j
10.     }
    / w0 s# W/ e  S! c, s! H2 P" c' p
11.    
    % X3 q) v* F  w2 ]
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    , |$ k7 w5 ?8 Q# X, |. ^
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    5 `, g4 g! c! G' t2 e9 f
18.    
    & I& F5 c5 @. f! y5 T. g
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    ) }5 a. M! ~4 j2 y
20.     {
    ' }% o- [5 y) {4 N
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    ( p6 o* c  c3 W/ I# B" }
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    ; ]! W2 R; b# u
24. }
    , E4 p" V9 _& a4 n1 v
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
3 Y9 a& Q  L  F2 X4 j" y# r* e; x


, a' e! z3 P. z; z# V4 k2 V

---

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

Powered by Discuz! X3.5