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

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

---

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

Разбор файла QuestManager.java
5 n' \/ y1 n  L+ {2 v5 M2 q
5 H. s4 U  t& a( M) yЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы
8 ^+ D# \$ l! n! Z! L; k

• Лицензия
  8 q; X; H  j8 S( D
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  + T( n# v3 L2 M' H1 |

/ j' J* h, o8 k  Q8 DQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
/ M! s$ O* S% Z+ W9 m, A  N

0 ?* ~5 r* n" d+ v6 S( B1 kДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
' c; v6 P0 Z' b# B% {$ a9 G. ~6 u8 N1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   ; q9 C, T9 D( S4 m
5. * её в соответствии с условиями GNU General Public License, опубликованной
   
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   4 T2 Y1 S( M4 f$ n
7. *
   ) ~6 s( ?7 o) K7 U7 {! b
8. * Эта программа распространяется в надежде, что она будет полезной,
   
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   5 |0 ^& {2 i; x" B  V
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    
12. *
    ( w0 p5 k% ?8 f
13. * Вы должны были получить копию GNU General Public License
    $ @, g' v% ^/ E6 y5 L+ B
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    & K3 `8 ^( x. l1 U+ U# c
15. */

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

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

; i7 `* G8 L& e9 r. U7 O# c
2. Импортируемые библиотеки
$ o) p9 R: ?( h, Z
8 X# J0 }: W2 I% I5 q

1. package org.l2jmobius.gameserver.instancemanager;
   * j  a  \1 a6 b% U# ?8 C8 H
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   7 C( [0 W& C% q% b: c4 w
6. import java.util.logging.Logger;
   
7. 
   
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 — менеджер для работы с игровыми скриптами.
# L! `* y7 \' K& L2 n  N
3. Описание класса QuestManager
- W* F9 X" r1 B1 [) v

1. /**
   5 q: s3 |3 [- t9 \: ?' i( W
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   
4. */
   
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   , K- L/ H* B* b% I
8.    
   8 j$ Z% d. Y9 l/ h( o
9.     /** Карта, содержащая все квесты. */
   # a# s( M6 K" v, C& p
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    ; \, O& u7 l2 E& b" W7 W& l, Z, v
13.    
    0 v* [  M; v" [! ?  R; x, l
14.     protected QuestManager()
    
15.     {
    
16.     }
    & B- o" Y3 H! V7 E2 L, ~: R( t
17. }

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

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

1. public boolean reload(String questFolder)
   
2. {
   . N+ j& e( V- J3 g0 H
3.     final Quest q = getQuest(questFolder);
   ' r7 L7 Y, [; ?& x9 Y
4.     if (q == null)
   
5.     {
   
6.         return false;
   1 w; ]$ b  J( S
7.     }
   
8.     return q.reload();
   ) f( ]$ }: R( v$ r
9. }

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

! w' W- ^" P! ]8 |# J3 c
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
Метод reload(int questId)
7 |& v: C2 C. U7 Y; m# J

1. /**
     U& Y! h9 V: o) s  X5 R0 v* B
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   8 T( ?9 A, v) S4 x. J6 u
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   
5. */
   
6. public boolean reload(int questId)
   8 |/ K; N5 G8 ^/ M
7. {
   
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   5 ]6 r7 k. {; C8 s2 J+ u- ]1 o$ J
10.     {
    ! I  t  I/ j% {3 r6 h# ]- R
11.         return false;
    
12.     }
    
13.     return q.reload();
    - O  A% i1 P  t. l! q5 v
14. }

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

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

- E+ _2 t9 H# V* a+ vМетод reloadAllScripts()

2 J0 p3 r) o' P6 T8 q' r' a7 |

1. /**
     q! ?+ o) D2 b5 ~/ P
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   
4. public void reloadAllScripts()
   1 f) |/ C2 h% B+ h$ g! A) ]
5. {
   
6.     unloadAllScripts();
   & J. N) ]+ x3 Y$ y/ a% S
7.    
   
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   
9.     try
   
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    ) ]2 x) Q0 X% e9 o$ Y
14.     {
    9 ?, N+ f8 X& F  }9 F/ U
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    4 P" s9 m) ^5 I/ f. h
17.    
    
18.     getInstance().report();
    
19. }

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

Метод unloadAllScripts()

* M* j4 o+ `1 l* [$ I0 X

1. /**
   + {1 j* N, K$ U  E
2. * Выгружает все квесты и скрипты.
     }' x7 M6 [5 v
3. */
   
4. public void unloadAllScripts()
   
5. {
   - d( w1 T4 E1 t" X2 L9 Z
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   . N: |- P) M* M; e* j/ b$ w
7.    
   
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   / Q7 A+ f3 k" b8 \4 `
10.     {
    
11.         if (quest != null)
    % k9 I8 A6 O  o, o' K" U
12.         {
    & @, c5 v3 v' q; u/ u' e1 S
13.             quest.unload(false);
    
14.         }
    . y) ]$ @6 o5 U- l
15.     }
    ( j9 N  f* `+ z( ^
16.     _quests.clear();
    0 w( b# e1 ?4 U2 F- J
17.     // Выгрузка скриптов.
    2 o/ \2 M. r4 E
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
      ?& `+ x3 _2 @* f! `. W
22.             script.unload(false);
    
23.         }
    
24.     }
    
25.     _scripts.clear();
    - Q* p" w+ p: W' x% x
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  . f8 g* A3 t; s# b6 b. t8 O" ^* E$ r

Метод report()
. @- A2 Q( D- J, U
7 F/ t  ?) T3 o' H  j/ F

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   3 E) D. j. d* z5 o
3. */
   9 w% G, ?" U. X6 o. k/ x1 x
4. public void report()
   2 r  s  y" p( y0 n* Z
5. {
   ; F% P) p* ~; k
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   ( F7 Y# k" g  o9 }" p( ?  ^
8. }

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

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

Метод getQuest(String name)

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   , L- {, v6 p% N/ R2 v
4. * @return квест
   4 K6 v  b1 \4 y% D2 n0 N
5. */
   # B: ~# }: @- F$ u3 s; J
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   % T. X+ e8 X0 k: h
9.     {
   
10.         return _quests.get(name);
    0 U- S* K9 y" H
11.     }
    
12.     return _scripts.get(name);
    5 g1 C9 E. d) t% g% f5 T; A
13. }

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

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

  A& ]2 Z5 J: sМетод getQuest(int questId)
& c, z' B) p5 W) U& T4 Q
: q- x1 p+ n9 M$ ]7 O1 ]$ ~" g

1. /**
   - J. w( _3 g3 X+ B" ~0 n
2. * Получает квест по ID.
   7 t6 o# {" V' d* N# c2 }! m. f
3. * @param questId ID квеста
   7 U! N. A4 [. v- p" J4 R0 h9 u
4. * @return квест, если найден, {@code null} в противном случае
   
5. */
   
6. public Quest getQuest(int questId)
   ; n: H# t: N! p: c! f9 `! g
7. {
   
8.     for (Quest q : _quests.values())
   / J( V' R4 ?& j( p
9.     {
   1 c8 |% R) @; j- J
10.         if (q.getId() == questId)
    ( J$ V& T7 n. Z6 h3 P$ y+ m, [
11.         {
    8 h, {; N! m: _/ c7 v( v' F, e
12.             return q;
    
13.         }
    
14.     }
    1 R8 P9 U  N, [  p0 s2 H
15.     return null;
    , J9 r) L5 O0 Z0 W  W6 [
16. }

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

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

Метод addQuest(Quest quest)

1. /**
   : g; q6 a4 J. c" J8 T7 q# y! t! ^: @
2. * Добавляет новый квест.
   ) [" `7 @/ k4 H. D
3. * @param quest квест для добавления
   
4. */
   1 V2 N& V+ q# X! b1 w- L3 g$ h
5. public void addQuest(Quest quest)
   " a) n% N, ]) X2 _( c& L
6. {
   ; W" }* {: L, m5 _4 a
7.     if (quest == null)
   
8.     {
   6 W0 c! B/ V1 q  H1 [
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    + L# N3 O' ^' {3 H
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    
13.     if (old != null)
    
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    * z  h7 L) K& k& N9 L
17.     }
    , S6 m6 q- n0 c( K& i! Z& K6 Q& V
18.    
    : q% S6 a; ]* J* f; R# f
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();
    $ U$ E& Z, Y& u
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    $ Y" A6 K2 R9 B- j
24. }
    5 g4 _" V( y0 k7 f4 ^3 y
25. ``

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

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

2 x: J5 r. q- _0 C7 C; m6 H2 C* h, o
9 K$ `& y8 T9 o- }
& J) m0 g0 r- U$ r2 P  {

---

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

Powered by Discuz! X3.5