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

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

---

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

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

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
0 _* G0 e6 W4 n! cОсновные элементы
. k: B& d. M. `* T

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    : P7 r- w  s' B/ G/ x$ ]0 `/ s
• Импорты
  ! J8 L" H8 I/ q3 U" o2 I" C

9 Y2 x( S, S( z3 L% \/ mQuestManager.java — управление квестами и скриптами.
" ]8 T0 q+ q, x0 @/ h$ f8 HПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
! N/ @1 E, S! d5 F; V# `5 o7 F: g
; m* v7 w0 L7 @0 {
& j5 C6 O7 y, R4 ^, dДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение
2 \7 I& y/ O% c0 N7 _

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   6 g  A* t: O7 S7 @) p
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   : P; U' s1 U, q/ @" l3 M8 l* c
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   * L( k  s4 w6 i
7. *
   0 b$ S5 P  k% H& E5 j
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   5 x) H6 _, Z6 e) k9 r0 I9 W
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    
13. * Вы должны были получить копию GNU General Public License
    4 G# I0 x/ G8 s
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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

9 B) z; g) l: y. Y# d2 [5 o1 i
8 k0 i  s/ y# M3 v2. Импортируемые библиотеки
: k# q) S6 v5 |+ E
3 f* d" Q& p! y! Y/ B

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   2 _9 S8 Z# |) d( p& e
3. import java.util.Map;
   ' p. K9 y7 J! p
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   % l) Z& e9 O1 n* d( r) c
6. import java.util.logging.Logger;
   
7. 
   9 X9 |" A( V, p  e5 s
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   9 g+ d  ~4 |# e
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 — менеджер для работы с игровыми скриптами.

. y! f2 [" m) t6 S; _* D0 f3. Описание класса QuestManager
: Y( h- P( M: o: C0 p

1. /**
   
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   + T$ x9 K# ?& ~- D3 t- ~: A% v9 H
4. */
   
5. public class QuestManager
   
6. {
   ) d& D3 I) U! z# {. S* p
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   ( E' f7 O* _& |5 S' S4 _/ }$ V% f
8.    
   : T3 D; q4 |6 y0 R) ~' K3 |% I; \
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    " i& L' [6 M* W; O
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    . l( ?6 T: L& Q- L" I
14.     protected QuestManager()
    
15.     {
      C8 c# k* {) [
16.     }
    + `# J& W8 c9 q9 z
17. }

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

4. Методы
Метод reload(String questFolder)

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   6 \4 J3 [% Q) [" V
4.     if (q == null)
   
5.     {
   
6.         return false;
   3 n+ G" A- w# K6 Y/ R0 N/ d" c. l% s! B
7.     }
   
8.     return q.reload();
   
9. }

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

/ |1 B0 C) D  P1 E1 i4 ?
  D9 D' L6 f5 c4 XМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   0 O/ E1 [$ r! P/ Z
6. public boolean reload(int questId)
   
7. {
   , K) Y+ }8 _" K+ P  k* H
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    3 m2 W, s% n4 T3 ?# L$ u
11.         return false;
    2 w1 V( |- O4 H6 b; B, v. c
12.     }
    & V+ \' D: z$ g( P' X
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  ( [) U' H* E# ?7 s% ]

4 t/ k) e% v2 z  @- ?! VМетод reloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   2 t2 j/ ^; d, n. n' N
5. {
   
6.     unloadAllScripts();
   
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   / W! x+ d. ]$ G; [/ M7 x! g
9.     try
   % D- L$ _8 G; g( d
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    ( c) J; b% x2 q/ u4 E1 h
12.     }
    3 P0 L3 x7 @4 n$ q5 F. k
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    " b6 G+ Z# G2 v! h
17.    
    ( [( g2 i( L! |3 W3 V7 ?( l6 Y+ K
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

6 j. S, }4 \0 p* M/ ?( b# Z

1. /**
   
2. * Выгружает все квесты и скрипты.
   ( b5 j* E0 R! W4 w2 ^2 P  f
3. */
   
4. public void unloadAllScripts()
   * V: U4 n  K' [- O4 u
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   
7.    
   * u( t8 e9 n1 x. `1 T
8.     // Выгрузка квестов.
   * x' O3 y& [) d6 Q/ l9 `; L
9.     for (Quest quest : _quests.values())
   : I( H' u6 A* {1 U" m
10.     {
    
11.         if (quest != null)
    
12.         {
    6 v/ ^, w; S& A. V4 m6 A9 {
13.             quest.unload(false);
    
14.         }
    
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    1 |. q6 X+ J3 o4 p
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    2 ^7 g: }2 B$ ]$ y% l8 {3 g  @8 f
22.             script.unload(false);
      _; O# m4 y! |
23.         }
    6 D8 g8 Y* K2 [  O
24.     }
    
25.     _scripts.clear();
    ) ~9 A# ~: t& M/ |
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  7 W" R2 j. a( U$ o

0 y4 Z. \3 z6 b* e0 n( U$ J. ]% w* aМетод report()

1. /**
   & r+ N( b. o; M$ l# l6 S
2. * Логирует количество загруженных квестов и скриптов.
   $ V" k! ^" J, ]8 i8 ^  V
3. */
   
4. public void report()
   2 _0 u7 x  E: c$ `7 V8 X% j' ?
5. {
   6 Y* K; \# a  Q& Q( M
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   1 w! B$ {" b* x: |0 d/ n* }: p
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  ( C2 U: N# W) R3 E4 }

. r% Q) x% N. Q; PМетод getQuest(String name)

1. /**
   , ?0 n6 L  c1 f6 W  M+ O" b* F
2. * Получает квест по имени.
   6 _7 C. L6 z# w3 P. S
3. * @param name имя квеста
   # w  y. Z: a6 E5 F
4. * @return квест
   & p6 G" |6 L/ w! @% D
5. */
   
6. public Quest getQuest(String name)
   ' o6 `) K, x& V, C  y
7. {
   ; Y- n) L% z" H' h6 O
8.     if (_quests.containsKey(name))
   
9.     {
   6 S7 m: Z. e* e4 Q5 {, a1 Z/ O- e' A
10.         return _quests.get(name);
    
11.     }
    % r, \0 F3 h& n
12.     return _scripts.get(name);
    2 Y8 p' @6 w/ @
13. }

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

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

Метод getQuest(int questId)

; T: C8 j4 o2 _* |

1. /**
   
2. * Получает квест по ID.
   ) u( n3 A5 J7 w
3. * @param questId ID квеста
   ; m% M+ |% B) d  a
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   3 k( H0 U. M, e
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   ' L* m; o1 \+ E8 K
10.         if (q.getId() == questId)
    
11.         {
    & q( f- @( _: o, k$ ?- U, t
12.             return q;
    * c+ k; o+ W8 Z2 Z/ Q
13.         }
    $ P: ]/ ^8 @  {. @4 L& T& Y6 {- V7 x
14.     }
    
15.     return null;
    
16. }

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

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

5 d3 u" N1 A7 ]: Y* |) \Метод addQuest(Quest quest)
' d7 Z( e! m, v& H$ Z9 ^

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   * N/ ?7 R% I, s! `$ c$ \
4. */
   
5. public void addQuest(Quest quest)
   0 ^) C5 V+ k6 R; L6 @
6. {
   ' X: ~9 y# W# J, v% o
7.     if (quest == null)
   
8.     {
   , X: X; W) o0 }( V& o$ Y, w
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    / O; P- F) ]7 O5 B8 `; q  c/ `
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    9 z. P# v/ X- p! M# D# K
13.     if (old != null)
    0 l, ?% X/ L" @6 a4 _5 c$ K
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    & u0 {% q( g1 l7 q8 q0 q9 N
17.     }
    ! H- w  o' J: V# ~1 k0 R9 \4 Q
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    ; |- O$ H- w1 Q7 I
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    ( g' j. [% m2 j0 n: L
24. }
      s& d" q. R* l  _" ]
25. ``

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

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


" j2 f+ V0 D; @+ e/ w" U) M  Y

---

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

Powered by Discuz! X3.5