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

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

---

Автор: admin    Время: 2024-9-21 10:39
Название: Гайд по основным Java-файлам ядра сервер L2J_Mobius
Гайд по основным Java-файлам ядра сервер L2J_Mobius
- ~7 a3 _2 b/ ?  b" Y
- E. G2 q0 M9 \6 LРазбор файла QuestManager.java

+ E; N  j" [+ |5 ^* EЭтот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.
Основные элементы

• Лицензия
  0 ]4 Z' O1 T" h: `
  • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.
    
• Импорты
  6 X( [! C: J9 A) k; `& S

4 a4 t7 T' a* O& b9 k! x1 Y' M; K: tQuestManager.java — управление квестами и скриптами.
! Y$ I6 o  q! r! y% @* Y% V& V# CПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\
- k# i) f; n7 k4 z$ a  z

Давай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
0 ]" ]9 K. A: O" T: U1. Лицензионное соглашение
9 |7 }- h3 v9 j6 I/ Y4 M3 N  `

1. /*
   
2. * Этот файл является частью проекта L2J Mobius.
   
3. *
   
4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять
   
5. * её в соответствии с условиями GNU General Public License, опубликованной
   6 ]$ }' B& i" e% S6 v; r$ U% ~
6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
   
7. *
   
8. * Эта программа распространяется в надежде, что она будет полезной,
   # Y7 ]1 I2 L$ m6 Q  Y2 q
9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии
   + O, s% R; g; L
10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    
11. * См. GNU General Public License для получения более подробной информации.
    9 v3 y* d& F4 u8 r8 u' ]
12. *
    3 y! P0 X. M5 H' g
13. * Вы должны были получить копию GNU General Public License
    " B/ c) i" H1 x1 J1 O
14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.
    
15. */

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

Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
; s' [' [/ B0 I& o

( q/ g8 H' h; V/ T/ U* R( t; ]+ S. b6 \2. Импортируемые библиотеки
& _# b1 Y4 \, m

1. package org.l2jmobius.gameserver.instancemanager;
   
2. 
   
3. import java.util.Map;
   
4. import java.util.concurrent.ConcurrentHashMap;
   
5. import java.util.logging.Level;
   
6. import java.util.logging.Logger;
   - k, x( z& a4 J1 ?% N: k
7. 
   
8. import org.l2jmobius.Config;
   ; q; n$ Z' e; ]  r# v$ r9 j
9. import org.l2jmobius.commons.util.CommonUtil;
   
10. import org.l2jmobius.gameserver.model.quest.Quest;
    & A4 C4 _9 ]% Q. R- b
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 — менеджер для работы с игровыми скриптами.
* Y- c6 D8 ?' C; g* Y' e9 w
3. Описание класса QuestManager

1. /**
   3 a) q, u% B5 p7 l2 c) o. C1 t& N6 j, U
2. * Менеджер квестов и скриптов.
   
3. * Автор: Zoey76
   & [5 {: Q2 V  X
4. */
   % N/ F' ?3 c) e3 n
5. public class QuestManager
     `' j* I; `! I4 Y% g& c5 p2 e# w
6. {
   
7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());
   - z( h- t) ~8 M. b3 G
8.    
   - n& r0 u6 k) I# i3 ^) z! L6 A
9.     /** Карта, содержащая все квесты. */
   
10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();
    % c4 i6 }6 b; w2 i
11.     /** Карта, содержащая все скрипты. */
    
12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();
    + z: Q2 o8 `8 C9 i
13.    
    # E8 V' Y+ c8 |5 l
14.     protected QuestManager()
    ) I8 l! O6 t) ~4 @' [) G! H% ^* k
15.     {
    ( s2 m- j6 x( s! _6 r4 _; _1 U
16.     }
    1 q& G& L- I* I6 v
17. }

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

4. Методы
Метод reload(String questFolder)
- u; W! h$ Y3 p+ w

1. public boolean reload(String questFolder)
   2 ?9 L2 n( E" [: q3 Q5 J8 e  l
2. {
   ( j. X/ `* Y7 S8 F; R
3.     final Quest q = getQuest(questFolder);
   : F" e, H7 Q& ]- _3 Y# m
4.     if (q == null)
   + y( ^) g& i4 R& Q1 `$ x
5.     {
   4 X! ~: i# t/ ^; T
6.         return false;
   5 o) N8 N6 J! x" r) ]( r
7.     }
   / c$ d& ?. _8 g: U% }6 Z
8.     return q.reload();
   
9. }

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

; g, T/ ~4 Q2 O" VМетод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.
% m3 n0 F, Z8 _Метод reload(int questId)
4 p  C+ A: |5 s$ x) T# M, [

1. /**
   3 J0 D  Y# g" I3 J
2. * Перезагружает квест по ID.
   ) R- B4 y5 _6 X2 A- K) c# J$ V+ o
3. * @param questId ID квеста для перезагрузки
   % F- G! m+ v# R5 b
4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае
   , v5 q1 i( w& T8 I6 Y
5. */
   3 I; G6 A1 d& n% [/ @5 D+ u
6. public boolean reload(int questId)
   
7. {
   5 J0 w. R4 c! S: D; G" t
8.     final Quest q = getQuest(questId);
   
9.     if (q == null)
   
10.     {
    / _8 v2 Z2 i/ Z8 @: C+ f3 a
11.         return false;
    & p, n% Q1 ~7 w$ u4 \; a: s
12.     }
    ( k$ c8 Z, f4 o7 s+ v4 R8 e- |
13.     return q.reload();
    
14. }

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

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

( d  ?0 f9 Z- \8 cМетод reloadAllScripts()
% D) \1 P7 F( P

1. /**
   
2. * Выгружает все квесты и скрипты, а затем перезагружает их.
   
3. */
   2 K2 u) B1 _( u" [4 |4 ?; L5 B  ]$ P
4. public void reloadAllScripts()
   
5. {
   8 F5 U& v! N0 R; l& C5 ^% {
6.     unloadAllScripts();
   
7.    
   , p6 c! I% V: ]5 F5 U/ i+ i
8.     LOGGER.info("Перезагрузка всех серверных скриптов.");
   % K' ~8 n, @8 E, W
9.     try
   $ d) W4 L: o! ~
10.     {
    9 ]3 ?, R8 u7 s5 W& t! ~0 c9 n
11.         ScriptEngineManager.getInstance().executeScriptList();
    0 n& R) R! K0 C2 E- M
12.     }
    
13.     catch (Exception e)
    
14.     {
    
15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    
16.     }
    
17.    
    ! [7 A0 P9 A) S, \: k5 k( |/ `* `
18.     getInstance().report();
    6 i+ N+ b+ `' u9 A& Q  ~* O1 }# e
19. }

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

Метод unloadAllScripts()

6 l! {: s/ S; ]$ I

1. /**
   
2. * Выгружает все квесты и скрипты.
   ! i/ a0 A2 `- Q* a# I1 f/ e
3. */
   / ^- J8 E2 z: Q% z
4. public void unloadAllScripts()
   2 [5 A6 o5 D, M
5. {
   
6.     LOGGER.info("Выгрузка всех серверных скриптов.");
   8 a, [- P1 @+ S' P  Q6 {
7.    
   3 b1 S. T3 N& R5 ]# z
8.     // Выгрузка квестов.
   
9.     for (Quest quest : _quests.values())
   
10.     {
    ' g% T; ?4 W7 N9 {! q
11.         if (quest != null)
    2 R# f6 Y- U7 M. _, ~+ w
12.         {
    $ P0 g/ d5 p! L# E' |; ~; s+ @
13.             quest.unload(false);
    
14.         }
    ( v, k8 n% |) q
15.     }
    
16.     _quests.clear();
      k: i# m5 M2 j3 N8 t
17.     // Выгрузка скриптов.
    
18.     for (Quest script : _scripts.values())
    
19.     {
    # |6 i( _2 S0 e0 Q9 x1 c: R9 [
20.         if (script != null)
    / G, ^9 a* O0 I4 y( b
21.         {
    
22.             script.unload(false);
    
23.         }
    
24.     }
    ; t1 L, B8 E2 E1 g- W+ K% i. c
25.     _scripts.clear();
    
26. }

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

• Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.
  % [+ M- J' l7 F: E, U8 O- B

) Z+ u$ a0 b2 \/ DМетод report()

, b4 o2 E0 s& v/ i0 X

1. /**
   
2. * Логирует количество загруженных квестов и скриптов.
   
3. */
   
4. public void report()
   . E- r) c0 `7 c0 g& e9 [
5. {
   3 _0 w4 d7 d# v. [& |  S( [+ t! x
6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");
   
7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");
   
8. }

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

• Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.
  : E" E0 j0 g' w  Y3 ^

  W* k- s/ C* Y8 [: kМетод getQuest(String name)
/ j  }7 `/ J2 j" _

1. /**
   
2. * Получает квест по имени.
   
3. * @param name имя квеста
   - G) B; Q* r( T+ X! _  M
4. * @return квест
   ! A5 P# M6 D  g' p* J& Q/ c" w
5. */
   8 D* S; s. Z, y) [& p2 b" T& Q
6. public Quest getQuest(String name)
   
7. {
   
8.     if (_quests.containsKey(name))
   
9.     {
   
10.         return _quests.get(name);
    
11.     }
    
12.     return _scripts.get(name);
    
13. }

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

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

" d; _, n! g. `3 N: u3 VМетод getQuest(int questId)

1. /**
   ! M; J! K/ i3 G) G: ?. Q
2. * Получает квест по ID.
   
3. * @param questId ID квеста
   
4. * @return квест, если найден, {@code null} в противном случае
   $ z8 K1 B' i; O
5. */
   
6. public Quest getQuest(int questId)
   % Z9 j( ]0 ?2 N; g1 y+ o' y
7. {
   7 q/ `. p+ C/ i* |- W2 l/ w# \
8.     for (Quest q : _quests.values())
   8 j3 L. U; l$ O: d* e/ e8 J2 S/ [
9.     {
   
10.         if (q.getId() == questId)
    4 d/ w* ^' g6 q2 ]2 D6 T
11.         {
    
12.             return q;
    , ]5 ~4 W  n; j, W$ @  o
13.         }
    % E* ~' o1 y; o$ p! @
14.     }
    
15.     return null;
    1 B8 p2 C. Q2 t" W& b, ]! K: |+ Y
16. }

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

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

# [7 e% D. s* D# Z7 Q7 uМетод addQuest(Quest quest)

8 i' l% u, }% k2 ~: J' W) |

1. /**
   % }9 |* P' ~1 e& Z, r( Z" t
2. * Добавляет новый квест.
   
3. * @param quest квест для добавления
   
4. */
   
5. public void addQuest(Quest quest)
   7 M- k1 j4 U- t1 F( h% ^6 C
6. {
   
7.     if (quest == null)
   , K& [& n9 _6 v! T: A4 d, h
8.     {
   * P9 l3 r! |6 R' h9 j
9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");
   0 o( F8 G7 Z( G1 p% e
10.     }
    
11.    
    
12.     final Quest old = _quests.put(quest.getName(), quest);
    * r  Y; }' @1 A
13.     if (old != null)
    1 n( J; q( G& a2 O( S8 \1 H- t& B- ?
14.     {
    
15.         old.unload();
    
16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    : x$ M' |2 b0 T7 j; m# H6 F# g
17.     }
    
18.    
    0 X& P' [7 J4 d; g! d* _
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) + ".");
    " X& x; X. }5 l7 W( {
23.     }
    2 M* y. q; B3 t
24. }
    3 t; M8 {/ x$ i4 c+ H6 d
25. ``

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

Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.
, q! [' t# U" c: @' AЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.
9 X/ F& E$ [9 a% e) X: M. F' g
) C0 w. g1 u) g% o' b
8 Y$ {& G; _9 p, d! V' P( I* N4 Q
3 D# V: K. L( E- F

---

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

Powered by Discuz! X3.5