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

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

---

Автор: admin    Время: 2024-9-21 10:39
Название: Гайд по основным Java-файлам ядра сервер L2J_Mobius
Гайд по основным Java-файлам ядра сервер L2J_Mobius
" N' e8 q) U2 R5 t9 k; a& y
Разбор файла QuestManager.java

Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
% P7 Y8 |% V1 H3 n( s4 c; r2 pОсновные элементы

• Лицензия
  3 _! d& L: ]; u! G
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    9 {2 \0 K+ y- c* f( K; R
• Импорты
  0 b- a8 r7 d; e) l# a

  F# p- h/ b/ x# m$ t3 @  jQuestManager.java — управление квестами и скриптами.
Путь: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
7 ^$ Q. Y- _; E( S$ Q

Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
$ Y. l& W" a9 x3 p+ |# n1. Лицензионное соглашение

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   1 O( T% c4 U$ |  v% b% d
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   " l' F- D8 U* B. X; a% Q$ |+ ]6 M5 D
5. * её в соответствии с условиями GNU General Public License, опубликованной
   0 H7 `6 [. e; D( ^7 W% w
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   / o" ^0 t9 D1 g6 V5 w
8. * Эта программа распространяется в надежде, что она будет полезной,
   " d6 m. H4 B9 w
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    4 f  u6 q5 j- F( x) V
12. *
    
13. * Вы должны были получить копию GNU General Public License
    + l) Z; q& R: }, H8 \" u' a5 s
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

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

+ R% B, x1 M7 A/ r, @# [, R
2. Импортируемые библиотеки
$ B' ^; e0 n' D

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   + W7 }- I$ ?/ j- |4 f; ^* _
3. import java.util.Map;
   . o0 ]; H8 W) i& u" d6 x
4. import java.util.concurrent.ConcurrentHashMap;
   & t. m8 P0 w; w2 Y
5. import java.util.logging.Level;
   $ [2 Z( _! U  H- x; I( [$ y
6. import java.util.logging.Logger;
   " ~7 B- q, R( n3 p- \9 Y
7. 
   
8. import org.l2jmobius.Config;
   / {8 t+ k  Q& Y! z+ w! b6 V& U
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 — менеджер для работы с игровыми скриптами.

5 N( D: v& U' ^' X( a% M  x& z; @3. Описание класса QuestManager
' V2 n7 b' I1 t0 n

1. /**
   6 c) |; K! C' O
2. * Менеджер квестов и скриптов.
   & `7 M& T, S1 n7 d3 e
3. * Автор: Zoey76
   . w* X9 ^- T# B, T
4. */
   5 ~# z) R6 a( a) A# y; ^; c
5. public class QuestManager
   
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   ) E# ~5 @0 [, m+ H. ]4 _
8.    
   5 d1 D/ d) ^# P( M2 a
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    * u: U, U& e! W( N8 @
13.    
    ; _! f0 v, o1 F3 s. U$ p
14.     protected QuestManager()
    1 c/ w6 ?3 `  e  q
15.     {
    3 _9 O8 \6 M  T4 |4 W7 p5 H7 u1 M
16.     }
    : o) S& W4 b. A2 j
17. }

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

4. Методы
7 K7 s8 t) c3 j, _Метод reload(String questFolder)

1. public boolean reload(String questFolder)
   
2. {
   
3.     final Quest q = getQuest(questFolder);
   " P2 Y" `5 B/ L) y1 s  a6 k
4.     if (q == null)
   4 w7 D0 j$ t( b3 y' r6 \) M! L
5.     {
   4 q! V, E& o2 I9 }# F
6.         return false;
   ) R$ M2 o0 O( A, i
7.     }
   : g; R* l+ I) O8 v9 E# l& H) p7 S
8.     return q.reload();
   
9. }

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

8 d1 B0 k& d& b4 g
Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
7 O! K2 i, o6 U, {3 E+ [Метод reload(int questId)
. b3 A0 O; q+ I# T. l8 l
2 `1 k7 K0 J7 _, z+ ]

1. /**
   " i! I4 {+ b- Z* }- w
2. * Перезагружает квест по ID.
   
3. * @param questId ID квеста для перезагрузки
   ' x# d, ^; ]  D& I0 m6 o) ~
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   , s( L% L# c7 n! Y
5. */
   
6. public boolean reload(int questId)
   
7. {
   
8.     final Quest q = getQuest(questId);
   7 k( n! K, g" f, J
9.     if (q == null)
   
10.     {
    9 F4 Q+ I8 M. i. v
11.         return false;
    
12.     }
    0 k9 B' L6 t& h( O; h9 K
13.     return q.reload();
    
14. }

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

• Аналогично предыдущему методу, но перезагружает квест по его ID.
  9 F% X; W, b2 m4 b

Метод reloadAllScripts()
% X% ~* U# r5 o' {& J

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   5 l: K1 H/ x  z5 E" ^
4. public void reloadAllScripts()
   - Q7 g- G+ s# z: @
5. {
   
6.     unloadAllScripts();
   ( A7 N$ K2 H* U% I* `6 g9 [
7.    
   $ h8 r' [9 V/ S3 ~& B6 }
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
     d! D) {5 I5 {" Q3 h! |
9.     try
   . d! B3 L+ a9 ~1 p
10.     {
    
11.         ScriptEngineManager.getInstance().executeScriptList();
    
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    : l+ y8 E6 N; Z/ N' _8 a2 }
16.     }
    / j4 K+ B5 t2 E) U1 f. X
17.    
    
18.     getInstance().report();
    ( @, q: E: ^3 p! O7 |
19. }

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

Метод unloadAllScripts()

1. /**
   
2. * Выгружает все квесты и скрипты.
   8 B+ D, c$ f+ |
3. */
   + M% Z; A5 p# j1 C
4. public void unloadAllScripts()
   8 u  n) k3 S. z
5. {
   * L; X* O. M' s& M* r
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   " C8 U# X, u) o4 o6 s' v- w* L
7.    
   
8.     // Выгрузка квестов.
   ) a/ J# Y4 l8 I, U4 i. I
9.     for (Quest quest : _quests.values())
   8 S- y8 b$ X3 z
10.     {
    
11.         if (quest != null)
    2 P) F) V2 G8 T; ?$ l" S
12.         {
    ' W$ u! }5 |) b" U4 Y! [
13.             quest.unload(false);
    , }+ h6 ?+ _  f3 J$ b
14.         }
    
15.     }
    
16.     _quests.clear();
    
17.     // Выгрузка скриптов.
    : L9 R0 p1 N& f8 `
18.     for (Quest script : _scripts.values())
    
19.     {
    
20.         if (script != null)
    
21.         {
    
22.             script.unload(false);
    ; i  O0 g+ m2 N) `( o
23.         }
    
24.     }
    / Q8 ?1 [  }2 [5 b! B5 j
25.     _scripts.clear();
    
26. }

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

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

' k8 J' X' S1 V/ I* x( DМетод report()
# j9 x: R9 }# ]( y

1. /**
   7 n) h9 Q4 v/ O1 {% N# b. @6 @
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   ; p5 _* I- k- n5 {
4. public void report()
   + S) T4 ]6 T$ x' e/ _
5. {
   
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   ) g; h0 p6 y/ d6 v$ |
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  5 e$ j4 X  f% M

Метод getQuest(String name)
6 P# ]  ]  w) H/ c) k

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   8 t9 K4 b) u4 E2 Q: y! U
4. * @return квест
   3 G  D+ O. Q0 P5 b3 n6 T
5. */
   ! ~: q: D' n  y' E3 [" _/ K9 P
6. public Quest getQuest(String name)
   & ]' }8 N$ i& K
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    0 A3 N, _& s5 Z1 C
11.     }
    $ Q. z3 b! }+ a: s8 ^) F! H7 I# X
12.     return _scripts.get(name);
    
13. }

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

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

0 \( \$ l& m3 |7 B" D9 G3 _Метод getQuest(int questId)
+ h& q/ B. S# ~7 R* G5 j. c
1 z6 }+ ?; z. G/ g, k

1. /**
   & f9 N4 Y4 z/ h  Y
2. * Получает квест по ID.
   1 [- K9 m& W" h' S& ^) D
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   ; R( R/ N; V4 [: C4 l4 m
5. */
   ( x7 R- Q5 c( ?
6. public Quest getQuest(int questId)
   
7. {
   
8.     for (Quest q : _quests.values())
   " J1 h; _  P/ k7 y' w9 g9 q
9.     {
   
10.         if (q.getId() == questId)
    8 c# l8 a5 O: K4 U5 f! M
11.         {
    
12.             return q;
    
13.         }
    / g0 s7 f, g- ?. i1 y: J, m" }
14.     }
    
15.     return null;
    
16. }

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

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

Метод addQuest(Quest quest)

- q: |, K) }  p! z# a

1. /**
   & F+ P. ~" w! F! Z, |" L. W$ |& f
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   ' m8 Y* A0 f" A$ w3 a7 r; P4 T
6. {
   # x7 R- U9 l. g6 ~& \4 E3 P! ^+ L
7.     if (quest == null)
   ! ~8 g* }) M. p( _* o
8.     {
   
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   
10.     }
    
11.    
    $ k( F6 z# R, Z( M
12.     final Quest old = _quests.put(quest.getName(), quest);
    0 g) `# q4 {" ~+ D0 \
13.     if (old != null)
    
14.     {
    ( a2 [, G- t( [+ r
15.         old.unload();
    ; V) c. ~2 J- ?$ z
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    - j: U, B$ @; T1 J; W/ a
17.     }
    / _) N: ~+ r( D0 Q  n$ S6 v
18.    
    ; X) ^& w+ o/ L/ n: @, p
19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
    
20.     {
    5 y0 Y3 H  S2 t# s4 k
21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    
22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");
    
23.     }
    - F$ B2 q2 v) n9 Y
24. }
      H" |* K, ]% N: c
25. ``

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

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


8 g0 j2 [. P; F& b% ?

---

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

Powered by Discuz! X3.5