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

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

---

Автор: admin    Время: 2024-9-21 10:39
Название: Гайд по основным Java-файлам ядра сервер L2J_Mobius
Гайд по основным Java-файлам ядра сервер L2J_Mobius
' b: ?# ~3 _9 E" a
+ m$ v, I* K; p, B: pРазбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
; K8 `5 b+ r8 v5 O

• Лицензия
  # T' o% B0 B# X' }: O
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  

QuestManager.java — управление квестами и скриптами.
; k: K% G- d0 W( G; h- e2 |! Y& _% ~Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
# S! {1 W8 `" z

/ V6 r% J  i/ [% ?" EДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
1. Лицензионное соглашение

1. /*
   " s7 v6 C5 e# L9 Q; g$ N& a
2. * Этот файл является частью проекта L2J Mobius.
   # l2 ^2 k8 y/ f0 n; i4 w6 E
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   6 F& i; Z4 l/ }- Q5 }  n
7. *
   ( w  \( `% R2 W) l
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    8 V7 p7 M/ t) x. e7 T
12. *
    4 L& m% O, H( b, S( a: A1 u
13. * Вы должны были получить копию GNU General Public License
    + E0 M7 B  h0 B2 \
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    7 ~* `" R; v4 O, q) B) ?  S6 @0 U
15. */

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

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


2. Импортируемые библиотеки
1 `/ y) t8 g% a& s
4 K! n. S2 Z& A( U3 C9 z

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   ! G$ k2 }# b. u& D
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   , R: K/ m1 k1 K% K& w
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   $ Y$ U' A$ U4 x9 L$ u0 b
7. 
   
8. import org.l2jmobius.Config;
   
9. import org.l2jmobius.commons.util.CommonUtil;
   4 g+ K' o' p$ h
10. import org.l2jmobius.gameserver.model.quest.Quest;
    ' ^/ [- Q3 J8 D8 B6 y! {, u9 a: \
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 — менеджер для работы с игровыми скриптами.

5 m) f" n* @, \, N; }3. Описание класса QuestManager
' m6 A2 t2 ~( B: s' V

1. /**
   8 N( E) w! x1 O+ ^
2. * Менеджер квестов и скриптов.
   ; U9 I) ~) Q( ?- S( e7 y
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   5 Q" \/ G8 r, T! ?# s3 V* `
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   , S/ i1 [1 e. Q$ C
8.    
   
9.     /** Карта, содержащая все квесты. */
   ' Y' f$ }# U2 P  C' T
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    
13.    
    
14.     protected QuestManager()
    - g6 L4 s5 e; I9 U+ f
15.     {
    
16.     }
    
17. }

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

4. Методы
' `, D# X& ^; uМетод reload(String questFolder)

1. public boolean reload(String questFolder)
   $ N7 F' p/ N7 U7 F
2. {
   - M+ p, z- K# C% b0 i5 ~( _
3.     final Quest q = getQuest(questFolder);
   
4.     if (q == null)
   # F7 H9 h8 i. v- ]) S0 H! d
5.     {
   , W7 e8 w- j. A5 B5 I* M- t2 Q
6.         return false;
   # E6 ]6 g& z! S% I
7.     }
   
8.     return q.reload();
   
9. }

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

! d7 D3 r  `: |/ `2 A8 r; r' r5 [
2 w! }% d" S/ B8 b. g1 ?& O% G( [, ]Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)

5 Q- M+ }& |! s. v7 T

1. /**
   
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   " S7 i9 ]5 a# h2 x) |% V/ ~
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   ; d8 y% l) K5 K. D5 M. O
6. public boolean reload(int questId)
   
7. {
   # W* t5 w( ^3 X+ W2 L
8.     final Quest q = getQuest(questId);
   7 X/ B, v2 e" B
9.     if (q == null)
   6 R3 r6 w% n  ]& p& n) g
10.     {
    
11.         return false;
    7 z1 e9 b1 Z2 J. Y
12.     }
    
13.     return q.reload();
    
14. }

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

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

  d1 [& Y8 E6 U3 rМетод reloadAllScripts()
. G" {* M5 E; h% z* G

1. /**
   6 P1 J6 Y0 b+ P, Y
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   ) Z# O6 K: E3 ]+ e$ z( J
3. */
   0 d* G# t, G9 m" j$ f
4. public void reloadAllScripts()
   8 J1 B* J5 v& {' X
5. {
   9 X9 J0 E+ h" B+ ]; g! z8 ^5 w% O
6.     unloadAllScripts();
     a: n1 x1 |* U; N2 z
7.    
   ' M! a" e+ O3 V- L
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    % R# V6 a% G. x  F
12.     }
    
13.     catch (Exception e)
    * ^; ~  G* r! W+ P
14.     {
    1 U; ^  M( G  J( @% O% c
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    9 k& E4 X: ?4 T& N  q( Y, \& h
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()
/ D1 c& H% y  P. i6 j. N

1. /**
   
2. * Выгружает все квесты и скрипты.
     O% H( C& [$ ]! R3 e+ d
3. */
   
4. public void unloadAllScripts()
   4 d- [& _. k" j5 [# j
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
     M9 ]0 [9 x! y$ C4 B5 W, |
7.    
   
8.     // Выгрузка квестов.
   7 X3 Z) q5 s+ M% ^! L% t3 A
9.     for (Quest quest : _quests.values())
   6 v% N  F+ a2 B* t3 P
10.     {
    
11.         if (quest != null)
    
12.         {
    - o6 z( m( Q: o, O0 ^6 F
13.             quest.unload(false);
    
14.         }
    
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    " o! B" o$ [2 T) B' u0 h0 a9 r. F
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    $ l) o1 s7 Z2 t3 I- s" H
23.         }
    0 {8 _% K4 `6 [0 v; Q
24.     }
    
25.     _scripts.clear();
    2 s8 c! P- T  p4 b, e6 x4 q
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  3 _' H' W5 [( B; B2 D' G# y# B/ I

Метод report()

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   * E% `, ]+ N9 }
4. public void report()
   
5. {
   4 j2 m; E% W- a+ q; p* @
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
     |6 d3 E) d; F: Y
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  

+ I* h- v7 y5 T: [6 T; W- oМетод getQuest(String name)

1. /**
   8 T8 X9 {0 `" r% i. _1 F
2. * Получает квест по имени.
   
3. * @param name имя квеста
   
4. * @return квест
   $ ~$ x& {' i- O+ W% d
5. */
   
6. public Quest getQuest(String name)
   
7. {
   . e4 ]) j1 d7 t" }! P/ Y
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    ( p$ }: s  u( y% l9 f+ |; c
11.     }
    ; w- E9 n& o$ S2 ?: l" I2 ^+ r! C
12.     return _scripts.get(name);
    
13. }

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

• Этот метод возвращает квест по его имени, если он зарегистрирован в системе.
  ( o+ [1 @, b* x) D0 F0 x' a: g

Метод getQuest(int questId)
' H' t4 g  J0 `( u$ H1 D- U
2 t; e! k- e5 O2 r' [! _

1. /**
   4 @. T$ W! M4 y1 D2 X8 a9 I
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   & Y, q. o4 F. y8 y2 [$ F1 u
6. public Quest getQuest(int questId)
   
7. {
   3 h& J4 ~! e( Y5 |0 B  ^
8.     for (Quest q : _quests.values())
   
9.     {
     J- a% _8 y0 p& H. s, h
10.         if (q.getId() == questId)
    
11.         {
    4 A' C2 a$ h$ c' h
12.             return q;
    
13.         }
    
14.     }
    
15.     return null;
    
16. }

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

• Этот метод ищет квест по его уникальному идентификатору.
  ) W* m4 N* `' D  x3 o  ~4 J! P9 t

% q+ H+ q, k. {" _/ JМетод addQuest(Quest quest)

1. /**
   
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   5 g( j  u+ U% A9 B& G  r/ ?0 O5 _
4. */
   
5. public void addQuest(Quest quest)
   
6. {
   
7.     if (quest == null)
   8 L# k8 y0 |8 A7 K/ p! L; O) t
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    % N, }/ \3 Y; x9 m& _8 W
15.         old.unload();
    3 m' ^9 c$ Q. r8 P' ^' q, Y
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    
17.     }
    
18.    
    
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    ( R4 j0 W* }- f
20.     {
    * E! c. z9 v! v
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    ' w9 p& k3 f" @. h2 c6 N( U, p, `* I
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    
24. }
    4 Q$ D# V. |# o; O& R
25. ``

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

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

. S; j, _: A# o+ C7 ]% d" V
7 E* t9 Z4 y, t
1 p. C, r9 p3 x9 R

---

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

Powered by Discuz! X3.5