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

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

---

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

% {% N, f9 g% }8 [0 @  \. n% D; zРазбор файла QuestManager.java
; @! `" F* o9 U3 ^* N
- U, u/ u6 q* vЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    + Y6 \$ h8 \% W1 J  S% t! D
• Импорты
  ' T$ o9 |% o$ }! `

9 D2 m* G" \  M7 @2 |( MQuestManager.java — управление квестами и скриптами.
8 v0 Y+ D+ U3 ]  zПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

, T2 ^7 H# K1 \3 N  }1 c3 r
Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
% B$ h( v0 ]( ~2 _

1. /*
   : P5 l) d; x% y: d
2. * Этот файл является частью проекта L2J Mobius.
   2 r; s+ ^' y& b) B* z
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   1 E% h5 l& [% h3 V
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   ( }& l0 z% K5 Y+ u
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   * p3 B3 x) f, Q$ B/ `* v9 N/ _) E, M
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    1 C) f, |  Z: l! m7 c5 x+ P' o1 b8 y
11. * См. GNU General Public License для получения более подробной информации.
    & W8 ^" _3 `( ^  `
12. *
    ' r% c0 b9 p; \% ^5 L. P( O: f
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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

1 i& o5 u% ~( E6 r+ A' q2. Импортируемые библиотеки
! X& f: r! B- {  F5 ^
5 {$ [+ |$ }, h

1. package org.l2jmobius.gameserver.instancemanager;
   " K% @2 S4 ~$ ?4 u' z
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   7 A8 _* h7 v( t8 u9 Y9 Q9 F
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   
7. 
   . ?. _) y8 R6 t8 M) e1 [
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 — менеджер для работы с игровыми скриптами.
$ f, O4 K5 x! P: I+ A) [
3. Описание класса QuestManager

1. /**
   
2. * Менеджер квестов и скриптов.
   - ^6 e4 G: b4 r5 N- U+ o3 _9 @; O7 |
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   
6. {
   " @: o* F' R2 n. o5 J
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   8 W0 h! t  a5 E/ S+ w4 K
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    . e& c9 i- J8 p- N
11.     /** Карта, содержащая все скрипты. */
    1 x6 r8 A, D) ^$ Q" u
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    5 B' y+ N* u; T1 ~
15.     {
    & y* g4 ~" u2 o2 @# o' n' H
16.     }
    
17. }

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

4. Методы
" C5 a9 R+ A, m9 V  ~; |8 a$ wМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   
2. {
   7 t, b# ]2 \# n
3.     final Quest q = getQuest(questFolder);
   6 n: D2 j8 W! ]. d& m; D$ H" }
4.     if (q == null)
   
5.     {
     T9 w; j) I$ J/ I* Z' |# S
6.         return false;
   
7.     }
   
8.     return q.reload();
   
9. }

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

) g! g: e9 u' H1 s
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

1. /**
   / ?( p, h+ @5 v) a/ e
2. * Перезагружает квест по ID.
   ! R4 K9 R! g1 t
3. * @param questId ID квеста для перезагрузки
     @4 b# S& ?) x% T: G- X& Q
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   / F4 ?7 o1 u$ n- k; p2 X& }5 c
5. */
   
6. public boolean reload(int questId)
   
7. {
   6 k9 z7 m- ]: l6 B3 ?# f$ H- q$ i
8.     final Quest q = getQuest(questId);
   " ^  M, ], B% r: G2 j) a6 `% t
9.     if (q == null)
   + H7 g" y0 k. y& E; B5 b
10.     {
    $ O# {' Z2 C6 D+ I6 S; Z7 F
11.         return false;
    6 R1 g; T: t8 I5 E
12.     }
    7 Z" B; S0 n7 Q, \  T
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  0 L; e# {3 f+ Y; G& ]1 ]

Метод reloadAllScripts()

1. /**
   * h* v( ^# L0 X  U+ [( L5 t, W
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   ; j6 t; n/ H. q6 X& K& |
4. public void reloadAllScripts()
   
5. {
   
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    / j; n6 G; V. _6 ^! g* t( v- w
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    # h+ Z, D. N* Y$ B( C9 `: z
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    * t" \( k( e* l) K, v5 O+ y
16.     }
    + F  O& o2 K$ N& {0 Y
17.    
    5 d3 J+ q( A- y) {4 \( d4 `0 }
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

5 z: L) p8 d6 P4 i  T: y

1. /**
   
2. * Выгружает все квесты и скрипты.
   . m+ k' J" o$ C! M# E8 y& ^9 N/ O
3. */
   6 b5 j5 _/ ]! M6 K/ s
4. public void unloadAllScripts()
   
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   , _" C: s( W; {& _
7.    
   5 H$ [: B8 w  f  l# q! `
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   4 o2 P& Q5 q. ]4 v
10.     {
    + D8 V9 F4 F# l& ^3 S
11.         if (quest != null)
    . s& j( ~: u  Z7 h% `/ z
12.         {
    
13.             quest.unload(false);
    
14.         }
    
15.     }
    8 p/ z/ g3 \8 a# M7 T4 ?
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    : ~) I# r7 t' N) V- ?
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    2 A; u+ A' g+ u1 C% b
21.         {
    . y4 Q* @2 B. a
22.             script.unload(false);
    
23.         }
    
24.     }
    9 U$ c% D) G1 |% x) ^) k
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  ' h$ P, p5 K- {: C6 C# T

, G, {2 o- l1 x; yМетод report()
* B- p0 A3 c7 k. L. M
$ E' O, A  n% B

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   % J) ^9 G3 V" D; P8 |# c/ C
4. public void report()
     r) k9 u0 u; u3 _9 P! V: r
5. {
   3 x: q1 I9 U' V' G. Q7 e
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   7 K6 S1 @. S( b) {: L+ U' U3 N
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  7 u4 \& O* l" {1 v3 _

Метод getQuest(String name)

1. /**
   
2. * Получает квест по имени.
   ! C" R# h& ]# W! A6 V# o
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   
6. public Quest getQuest(String name)
   
7. {
   , D! S" W7 v+ N
8.     if (_quests.containsKey(name))
   / t7 s  L* b8 r9 D
9.     {
   6 x1 Y% z$ X: X8 \0 P
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  : K  Y7 [& T' g

. g# ]; d% C" V: G. k" d$ GМетод getQuest(int questId)

2 q7 _  b; @- V6 V9 W7 D1 u/ M" H

1. /**
   
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   ( u0 ~+ I+ a8 e; s% |
6. public Quest getQuest(int questId)
   
7. {
   6 E' ^  G+ F, m4 e0 `1 S1 t
8.     for (Quest q : _quests.values())
   
9.     {
   # U$ ^/ ^0 v4 ]' a
10.         if (q.getId() == questId)
    & M3 E! R8 R* A
11.         {
    
12.             return q;
    6 C: L) K( e3 }* ]* I$ i- O2 X: o
13.         }
    
14.     }
    : `- i: @6 V9 A- w- A9 W# }
15.     return null;
    
16. }

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

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

% j4 b) y# l/ L& ~6 k2 S5 D7 gМетод addQuest(Quest quest)

2 t2 Y' o, u6 q: s7 s

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   5 r$ C) o8 |) a2 [( ]" F8 ^: k
4. */
   ( b- s. P9 z3 y; c: {
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   
8.     {
   3 E- c$ S7 \( B7 v7 P$ {: r
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   8 a9 }; o% r- E- N% H2 }# L- ?
10.     }
    
11.    
    8 |/ S! i0 r: U8 u0 m, \
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    1 _* Y3 J- F% b' o
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    9 f1 o; V; z2 F  p; R# p. a
17.     }
    
18.    
    " |$ X$ ^. V0 w( e; Z
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    * a: A, }# d4 Q2 C* Q0 S
20.     {
    ; Z9 z6 i+ ^9 B2 P5 y
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    ) \3 u0 N2 r# _
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    1 M2 b1 Z/ @4 |* ~) c% S  W5 i
23.     }
    & Y# r( u; r% e0 X4 o/ s
24. }
    ( D% H; J& k6 g2 N! R4 k# {6 [
25. ``

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

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

+ U$ A2 M! |# \: U' f. v
$ e' p* u! ~5 _. }; \5 c/ n
- {7 F* g: @/ g9 q' z% |: v

---

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

Powered by Discuz! X3.5