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

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

---

Автор: admin    Время: 2024-9-21 10:39
Название: Гайд по основным Java-файлам ядра сервер L2J_Mobius
Гайд по основным Java-файлам ядра сервер L2J_Mobius
) N. s  |( Z; y0 Z5 L
Разбор файла QuestManager.java
: V4 v3 p# A! a* d( w7 r5 v
/ z/ o, x- U/ U2 wЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
8 ~4 v4 J9 i5 e+ j0 H( _, mОсновные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    $ ~  r8 d, K4 n# |3 e# }! S( Y
• Импорты
  

$ m; ?5 V& V) j8 ^QuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
( L/ t7 Z: x& _! I! @- o& F9 ]
% e0 r0 h8 x: N1 @' Z1 M8 ]
  H4 n9 r* `% cДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
+ o5 i8 o0 m, _, X: t1. Лицензионное соглашение

1. /*
   4 o# O! \! @1 T9 A9 \+ y
2. * Этот файл является частью проекта L2J Mobius.
   3 [. I: ~  D. y. `- G( {8 J+ \
3. *
   9 ~: ~1 n, p% q( _5 @2 p
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   ' ]1 P8 J4 S2 H6 J! P' M
5. * её в соответствии с условиями GNU General Public License, опубликованной
   # R( E1 J2 E8 b7 N$ e0 }4 _
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   , S( }8 }; ~" G) D- o
7. *
   ; s1 v. S+ l+ D: w
8. * Эта программа распространяется в надежде, что она будет полезной,
   : L3 L# x# s0 A; s' f: w, w; G, i
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
      r  R  S0 E8 v' x' m; b6 r
11. * См. GNU General Public License для получения более подробной информации.
    ) z: B2 T  z# E2 V$ N" p: u" H* M
12. *
    
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    ! d. _& E. }7 U
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
- {& ]4 l- d+ b; a0 k
4 w( _! G: s/ S3 z
2. Импортируемые библиотеки

) u) r& W" Q3 B; k

1. package org.l2jmobius.gameserver.instancemanager;
   ' f5 z& u1 h* _: Y) g3 q6 M
2. 
   $ B8 e9 a4 u5 h5 }8 ]) V
3. import java.util.Map;
   + {4 i+ J+ m* E
4. import java.util.concurrent.ConcurrentHashMap;
   ( ~. }5 j9 N+ f& U: `7 c
5. import java.util.logging.Level;
   / W# ]! y# r( Y7 W( Y
6. import java.util.logging.Logger;
   7 N" C) F2 Z1 m% v! H( D- T
7. 
   / b& f1 M2 n/ v; k6 }2 K
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    8 M. L2 b5 x" ], _! M% S( u' u
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 — менеджер для работы с игровыми скриптами.
4 R9 Z( E! K  ]9 L* A
3. Описание класса QuestManager

1. /**
   1 y) H! F: T  T' v4 a! F6 |
2. * Менеджер квестов и скриптов.
   9 p. X+ [) C2 i$ |' ]5 ]0 m
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
      `% l" L$ D5 B  w4 k2 G: C
13.    
    - H. T  ^  W$ k7 N( ^
14.     protected QuestManager()
    5 S6 D: F" l- w* r
15.     {
    
16.     }
    
17. }

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

4. Методы
- D; c3 r& n- Z' ]! {Метод reload(String questFolder)

1. public boolean reload(String questFolder)
   & f! F% A% z) b
2. {
   & S/ ~# G4 [# ?2 l# `8 I2 \
3.     final Quest q = getQuest(questFolder);
   , s2 x" A2 N( p
4.     if (q == null)
   $ a) J+ R# v1 S: w: R/ B! \
5.     {
   / I9 d9 G. }* Q4 G
6.         return false;
   
7.     }
     T/ p; `1 e( `9 V( {7 [" S
8.     return q.reload();
   + {: N( K3 r" I
9. }

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

& ~' ?% m- \. z9 L8 H& @
( T7 v# k5 ^# [" }: OМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
: k1 p2 e3 J) b0 M6 d5 qМетод reload(int questId)
( c6 u/ H# N% n6 c$ b
5 d& n" @6 P2 B' a

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   6 W3 y2 c5 S0 `0 U7 H
6. public boolean reload(int questId)
   8 M0 ]4 U; @! \/ [* g8 |
7. {
   ! b* W: v/ X3 n. f# U0 z
8.     final Quest q = getQuest(questId);
   7 X: C7 J* s' E+ R+ X  r
9.     if (q == null)
   
10.     {
    9 A1 o& H* ]$ }7 v, L
11.         return false;
    
12.     }
    
13.     return q.reload();
    . f3 m! C6 y3 T0 C4 [+ U3 u
14. }

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

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

$ T2 @* l  ]# V3 {: aМетод reloadAllScripts()
% e# c7 z; L" e% @* ]
  D! R3 g; {4 s* a' w

1. /**
   ! B  Q0 [6 v. }7 J) e
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   ' Z) T' F' n0 x* V
3. */
   
4. public void reloadAllScripts()
   0 O/ `7 \. H# C7 J# m% W6 l
5. {
   
6.     unloadAllScripts();
   
7.    
   6 B! P- B6 \3 l3 e7 I: L+ @
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   : O: g; b) ~' W8 t
9.     try
   ( o8 M, O6 C% \8 z  l) p
10.     {
    ) o- D  s, A7 ~/ a9 T0 N- F
11.         ScriptEngineManager.getInstance().executeScriptList();
    ) D8 R2 K9 S6 f9 x
12.     }
    , I9 P% c# J. W% Z) L
13.     catch (Exception e)
    
14.     {
    , \* ^2 s3 M* R! N$ T
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    : \- L% n7 {/ K# f9 E6 T7 |1 {
16.     }
    6 L' K: m4 v* A6 U5 }( i, Q* R( n) ?
17.    
    2 A/ a$ t& U6 [% x7 X7 |
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   
3. */
   1 [6 k0 [1 `$ r2 r
4. public void unloadAllScripts()
   
5. {
   # n8 P! ]2 I+ E) Z) S
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   6 p  X+ ~. m* u3 r, t
7.    
   
8.     // Выгрузка квестов.
   & E4 P! I2 j0 v, z
9.     for (Quest quest : _quests.values())
   ( s, S3 _$ t* I  `
10.     {
    ) m7 A6 A7 D( r% [5 N; n- a5 r- F
11.         if (quest != null)
    
12.         {
    2 s" m/ n8 a, L: O& n0 O& M
13.             quest.unload(false);
    3 U  l; y/ A- e1 a, \4 G  x4 @3 x
14.         }
    
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    3 A9 |; F; {- f  U. V4 u
18.     for (Quest script : _scripts.values())
    
19.     {
    " b- ~9 ?% J4 F7 Y1 x+ t; |
20.         if (script != null)
    7 j( _9 X* i8 t! l# ]( |# u
21.         {
    . K1 L/ k0 i( a" |0 ]
22.             script.unload(false);
    
23.         }
    
24.     }
    % ^2 r/ H- M9 w  V# d: e3 S
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  # j7 t2 X5 P* x3 [# D* i# D

Метод report()

! R$ N: f! K1 d0 K$ D3 t4 M

1. /**
   1 p# e& U8 O- p( k8 F' a9 W
2. * Логирует количество загруженных квестов и скриптов.
   1 H2 u4 T0 G) P! m! I4 y
3. */
   
4. public void report()
   ! n$ m( }8 r3 @* e* |9 I
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   - ?& o) E/ W1 X% H
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  3 r* L# b) g5 U. R! C9 L

Метод getQuest(String name)
; n* M& x( C- K' ^/ R) W6 ?
& g* g/ x, p8 s3 H$ Z

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   
5. */
   . W" [# C" ]6 e& S& h& j; ~. j
6. public Quest getQuest(String name)
   
7. {
   , ?8 r( I& M, U. L. j
8.     if (_quests.containsKey(name))
   4 a4 S- m) o' H+ l
9.     {
   ' r4 B5 a0 _, N; \  ^, [
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  : E9 I3 i/ e9 Y3 u0 ]9 `. @/ l3 b) U

% U/ e/ x. D8 b) Q+ e* eМетод getQuest(int questId)

5 L3 K3 b$ n' n2 d# a' l

1. /**
   ) i% x3 K+ G: a. R. G
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   
9.     {
   
10.         if (q.getId() == questId)
    
11.         {
    
12.             return q;
    2 x6 v4 V, W  x& H* O1 G1 X. ^0 \
13.         }
    - c2 ]# u, [$ C1 N; d
14.     }
    ( Q" {7 m3 d) M; G( d) h
15.     return null;
    - C1 b, [% u6 }- A' c1 c( c
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  % t- t" O/ G4 E/ P5 ]

Метод addQuest(Quest quest)
% `, {: t( T7 X# u6 d- d% M
3 J  C# Y( B  w: T9 r

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   7 Q8 K1 S3 T; h% Y
4. */
   . a/ O2 t2 N% c; V8 `
5. public void addQuest(Quest quest)
   7 z  {4 T2 g( t' y! ?0 A
6. {
   4 R! k6 s, x8 ~% u- s6 w( W
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    ' X& o. x! j) _1 Y- |5 o
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    & `5 y3 L. J4 d5 P
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    2 c, ?$ B0 f$ x) f9 H
20.     {
    " r1 _, R; `  x; J
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    6 @4 c0 p  y  d( @% [; @7 K$ }
24. }
    - J, p: a3 f, e1 m, y4 }
25. ``

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

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

! ]( X9 d, U3 a" D+ g3 v3 y# [3 h

---

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

Powered by Discuz! X3.5