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

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

---

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

Разбор файла QuestManager.java
' T6 U3 T" ^/ d+ p" _/ C  i+ \1 G
9 d1 j8 u  x% n4 RЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
5 ~0 Z7 a) L' B; K& hОсновные элементы

• Лицензия
  
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    : W  H6 V- l  x# M- r+ ]5 d
• Импорты
  , s* X  n* d, Y

) n9 q4 t" u  b5 @1 V8 `$ YQuestManager.java — управление квестами и скриптами.
2 L! G$ O" H! `" C4 s$ hПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\

4 t6 k$ x& R" v7 f6 }: F+ V
  |$ F) s6 N- p. J# D* x( B7 jДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   + Z9 i; Y0 U; S/ u
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   + J/ o! h/ t+ c. r7 e9 ]
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   # e& W9 Y% `' i7 H
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    - N2 @6 {* r- V9 y4 p! y# n4 g
13. * Вы должны были получить копию GNU General Public License
    
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    / B9 m% T/ z0 T  l- C2 _' W+ W
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
' P9 w: k  {. P" ^' h

2. Импортируемые библиотеки

1. package org.l2jmobius.gameserver.instancemanager;
   ! f' [, j! {: Q: R9 z
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   ' c& \8 l4 B" ?  o/ J! k
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   - H3 g  c5 ]! X( M8 ?0 l
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    ) v4 S- @( E' W. @4 J6 Y
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 — менеджер для работы с игровыми скриптами.

0 C8 F' i( B+ W( I# Z! z9 U3. Описание класса QuestManager

1. /**
   7 R9 I; a; H" W! O
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   8 ?+ K3 e  w+ N0 g% _7 [2 s. q* A+ m
4. */
   
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   
8.    
   " Z8 [0 e0 ^' g8 p, @; ~( V
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    ; J4 D. v9 K1 E: d
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    ; [( |- h. `2 q7 t% M! x3 g/ U
13.    
    
14.     protected QuestManager()
      p' r/ j1 o' e
15.     {
    
16.     }
    # W3 m3 }6 E  t" N3 j5 Q0 I
17. }

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

4. Методы
2 U) r% h/ j6 Z4 u& ?; fМетод reload(String questFolder)
1 n; t; M7 {( |

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   
5.     {
   
6.         return false;
   
7.     }
   9 t$ v# `9 k1 a, k" g
8.     return q.reload();
   5 [) N8 j! |8 n) o
9. }

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

% [1 S) i% k# K% }" z
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
$ r# L. l8 D3 Z( I" V/ r; k. W

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   9 Q' n0 V' Z. r# s( |4 B' F6 R* X
5. */
   ! z# U: @: O$ W/ i
6. public boolean reload(int questId)
   / B- Z" U0 ^/ [& y' w2 C
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    
11.         return false;
    ) @" F# C  ?5 R0 O2 N' O
12.     }
    
13.     return q.reload();
    
14. }

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

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

Метод reloadAllScripts()
' z0 ?$ A- f, h" x, ?9 m% d) u

1. /**
   & B, v9 h0 }+ q) F! C
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   
5. {
   / D- e0 X  r; V/ [4 I! V
6.     unloadAllScripts();
   + B# o. ?' m( |0 I# C
7.    
   ! S! U% G* H5 O7 H: M* w
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    2 Q6 P1 a2 u- E% j/ E( b( ]8 _' ~9 h
11.         ScriptEngineManager.getInstance().executeScriptList();
    . ^9 A0 O$ }1 w1 \, p% e
12.     }
    5 ?5 w: Z" j# |: t( t' i
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    " q  W  i$ o. A8 b" d* M
16.     }
    
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

1. /**
   8 O8 H' V, [9 o( E
2. * Выгружает все квесты и скрипты.
     F5 E$ @1 r7 L) G( p# s: X
3. */
   8 G' P1 V1 h5 U8 s2 z& A
4. public void unloadAllScripts()
   
5. {
   6 w0 M, H( Y' X! f
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   & N, N* \' @# W; i% `
7.    
   
8.     // Выгрузка квестов.
   5 E$ {8 t. b# _! P0 i* c$ \3 o  f
9.     for (Quest quest : _quests.values())
   ) }  ^: }2 u; L& a2 U
10.     {
    
11.         if (quest != null)
    
12.         {
    
13.             quest.unload(false);
    
14.         }
    
15.     }
    * a" m  R' T! z% E, S( j
16.     _quests.clear();
    4 A7 ~4 r4 y/ x& R
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    ! W1 Z6 ]5 W7 N; T4 Q9 @
23.         }
    * g( w% s7 [8 g. a: e/ a- m
24.     }
    
25.     _scripts.clear();
    / ~: K0 S2 {  ~7 }* w
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  

Метод report()

" ?0 V: U% D0 X+ g9 a6 W

1. /**
     _. O3 f' K: Z0 X; q% M
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   9 k, V0 C& ]" V& w# Q8 F& h( y$ ?
4. public void report()
   5 _' R1 J5 o# ~" K$ W
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   7 v4 W8 h+ P% X, T
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  * E8 u1 R: g4 H9 l) m$ E# ~

9 s& l) n! h" JМетод getQuest(String name)

1. /**
   
2. * Получает квест по имени.
   8 `9 O1 P! G, o6 g1 ?. q& t
3. * @param name имя квеста
   & l% ~: h+ w  d. W( x. V! w
4. * @return квест
   / c" Q; ]3 a# a
5. */
   
6. public Quest getQuest(String name)
   
7. {
   ( P2 ]5 P+ Q7 Q& w" C! W0 q
8.     if (_quests.containsKey(name))
   
9.     {
   7 \& M1 s9 N4 U1 b. Y
10.         return _quests.get(name);
    
11.     }
    % n/ c# m0 p! U- S; x) T1 |3 ~1 w( K
12.     return _scripts.get(name);
    & ^  _0 A0 Z. x
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  7 G/ i: @; f* F5 p

Метод getQuest(int questId)
4 J- a& W0 y5 s8 A# q6 W
! _: e4 _0 Y+ g1 a6 v

1. /**
   
2. * Получает квест по ID.
   7 a. V( U2 D& `3 W6 y$ l
3. * @param questId ID квеста
   & e$ a5 w0 u/ b+ l, q) e# ~+ i
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   * F, Z8 E6 g% C( q$ i* V
6. public Quest getQuest(int questId)
   3 }1 ?" S; W( p
7. {
   
8.     for (Quest q : _quests.values())
   " Z6 A( W. L( G2 L% D
9.     {
     p7 P/ ?6 ~* F& T
10.         if (q.getId() == questId)
    
11.         {
    9 n& I& V& l& k( _. m- x
12.             return q;
    $ O7 Z/ [. ^. p
13.         }
    
14.     }
    ) W/ L6 Y) `9 a  O. E5 }
15.     return null;
    7 }& S6 h+ H  d! j0 f
16. }

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

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

% v& F* V* v3 i$ ]4 jМетод addQuest(Quest quest)
8 p' O; r, F3 Z4 ~0 K5 |8 |
3 D! r. |5 s$ |$ J

1. /**
   
2. * Добавляет новый квест.
   + M( W+ o  X0 Q& m3 H) f
3. * @param quest квест для добавления
   & ~, C7 e# l! Q
4. */
   
5. public void addQuest(Quest quest)
   - m& A3 O# }, O' `: F) `; ?
6. {
   0 v0 G" p- }+ x  E: m
7.     if (quest == null)
   
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    4 E8 M+ ?1 J* I' k7 n3 u. P! i
11.    
    / |, o0 f- B( N0 B* x
12.     final Quest old = _quests.put(quest.getName(), quest);
    8 ]* X. B, n7 k0 e/ S2 v/ |- p
13.     if (old != null)
    ! q+ h9 g/ X& {
14.     {
    * M# V. v/ \! `" a( z& F- u
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    7 y# O: }/ j2 r3 e6 R
24. }
    
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
# H( ]7 t/ t1 ^  y  `7 @ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
: Q7 I! K1 ?# k7 D* b7 n/ [

, W/ a. M+ n& z: P# u) v9 s  H- ?
: `5 e, j' M# l

---

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

Powered by Discuz! X3.5