Top.Mail.Ru

[Руководство по Java для L2J] Гайд по основным Java-файлам ядра сервер L2J_Mobius

[Скопировать ссылку]
admin Опубликовано 2024-9-21 10:39:29 | Показать все сообщения |Режим чтения Распечатать Назад Вперед

Зарегистрируйтесь сейчас чтобы найти еще больше друзей, и получить полноценный доступ ко всем функциям сайта!

Для просмотра Вам необходимо авторизоваться Если Вы еще не зарегистрированы, перейдите по ссылке:Зарегистрироваться

x
Гайд по основным Java-файлам ядра сервер L2J_Mobius
1 l) I4 w& H2 b$ \1 p
% r1 M- Q8 `5 I: yРазбор файла QuestManager.java
7 R# V: k, _2 ?6 m  |* @7 o" z) E4 ?8 h3 s7 Q- `5 J. w9 Q. m
Этот файл управляет загрузкой, перезагрузкой, выгрузкой и хранением квестов и скриптов на сервере Lineage 2. В нём реализованы функции для управления квестами и скриптами, а также взаимодействия с движком скриптов.% P+ J2 @- i% h9 f2 A' d0 ~
Основные элементы7 _: o2 l! q; d
  • Лицензия
    , T& ]2 X2 \" S5 E) J& ~
    • Комментарии в начале указывают на лицензию GNU General Public License, что позволяет использовать и модифицировать код в рамках условий лицензии.+ }$ l0 A2 |" w9 F2 {$ }- x
  • Импорты3 K. _. D& p) i9 c: K; \$ H: W
8 S8 g4 \/ f) d4 U: Y9 n) s: L
QuestManager.java — управление квестами и скриптами.
% L' q3 G1 D0 S: y1 G0 NПуть: \L2J_Mobius\java\org\l2jmobius\gameserver\instancemanager\  U( E* {# ~0 R" t

8 I( x8 \% A9 j$ B2 H

" u: e( H* ?; [( EДавай переведем и разберем код QuestManager.java по частям. Этот класс управляет квестами и скриптами на сервере L2J Mobius. В нем реализованы функции для загрузки, выгрузки, обновления и отслеживания состояния квестов и скриптов.
* Q6 k5 e6 s6 o! j: Z+ [1. Лицензионное соглашение" [" C* c8 t0 \) e: F
  1. /*
    - t6 M; R( c* `/ y9 u5 \
  2. * Этот файл является частью проекта L2J Mobius.1 e- y9 X; N+ p: }# l/ i! f7 h
  3. *
    ' Q6 b" r/ v2 _: q
  4. * Эта программа является свободным ПО: вы можете распространять её и/или изменять& x+ W3 g1 q- j6 R* J
  5. * её в соответствии с условиями GNU General Public License, опубликованной
    * A* i" o& a) @) S
  6. * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
    ( x7 `, O8 ]* x
  7. *
    7 Y# o  n: o1 \1 ?4 s
  8. * Эта программа распространяется в надежде, что она будет полезной,
    ; U) V* O/ Q& ^: I+ x8 F
  9. * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии2 p! o# D2 ]3 e0 g) f- _
  10. * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
    9 o. X0 H1 `6 ?* I7 b: N, t
  11. * См. GNU General Public License для получения более подробной информации.& m$ _$ x9 t! ?" D
  12. * ' O3 d  U; N, A" g2 n
  13. * Вы должны были получить копию GNU General Public License/ A& l' W' }( e9 X8 N" N: v* t% l9 R
  14. * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.; q5 d9 r7 v- h5 r, O; L
  15. */
Скопировать код
Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии GPLv3.
; e" b# D* M1 O: }! V1 F7 A7 I+ y2 u& J
5 Y- Y! y1 M2 Y7 ?4 `% n
2. Импортируемые библиотеки' H2 _" i# b8 f# G: g5 i4 l
" b# o2 w( R: ~2 g- r
  1. package org.l2jmobius.gameserver.instancemanager;& h  g* c" K; ]0 N! M! j
  2. ) C5 v8 G4 L* s/ l, a, m
  3. import java.util.Map;
    : G2 l- C  b* J- _0 I2 u
  4. import java.util.concurrent.ConcurrentHashMap;
    ! a" h0 _5 D) g$ g) e& B" X
  5. import java.util.logging.Level;# b" G7 @7 q; }$ \6 c* \3 p3 h
  6. import java.util.logging.Logger;
    # W2 f4 R3 U8 c+ `! j! |: F! t7 C
  7. 9 \4 d6 ~2 F$ S" J5 T5 o
  8. import org.l2jmobius.Config;: J; Q  w' l+ R- v- d% v
  9. import org.l2jmobius.commons.util.CommonUtil;) H* Z+ w0 y7 t  |+ |3 a* Z/ T+ m
  10. import org.l2jmobius.gameserver.model.quest.Quest;
    ' T( x! [0 [6 w( |
  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 — менеджер для работы с игровыми скриптами.3 a7 @& ~2 i- l
. m% z, }7 ~# r* W  |
3. Описание класса QuestManager. V; N9 Z$ g0 _; ]9 V3 L
  1. /**, n# `, w( l/ I) ]
  2. * Менеджер квестов и скриптов.
    ; d" D' K9 H% K$ c' N. y
  3. * Автор: Zoey76: a' K: {; o2 R
  4. */
    # O" x& T& {+ P: c4 s: A  v/ P
  5. public class QuestManager. h1 {: j, P# f0 i+ `
  6. {
    3 A+ _" U0 g! Y5 v
  7.     private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());4 V3 }0 v' B0 S8 H7 \
  8.    
    6 a! v$ c# U8 q+ J. \* ?2 {: b/ b
  9.     /** Карта, содержащая все квесты. */( T" Z5 i" {, }" s4 G! z2 P' G5 M
  10.     private final Map<String, Quest> _quests = new ConcurrentHashMap<>();+ n, C9 Z% G, s( G* R
  11.     /** Карта, содержащая все скрипты. */4 C$ {" U. e, Q% O+ d* B. [
  12.     private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();. x+ T& i% {8 _9 @9 k! r: S! z9 F
  13.    
    5 ?1 ~) r- ?0 w! @- _
  14.     protected QuestManager()
    $ D+ Y, e1 W2 Z& T( @) d
  15.     {
    # ^+ Y) p9 L( R$ Y  H
  16.     }
      Y: D! w: v( ]0 F
  17. }
Скопировать код
4. Методы
2 R: ^4 f- ~# \$ g! PМетод reload(String questFolder)* |% o1 A, P! `
  1. public boolean reload(String questFolder)! X2 m+ e4 f/ @' l1 m) S& w8 g
  2. {9 C+ p; P1 d% ]3 h: Q. p7 W
  3.     final Quest q = getQuest(questFolder);0 x$ J+ z0 a7 D
  4.     if (q == null)
    ) `, L- V; [! e. |) e  {; _
  5.     {
    & K  b. n% _# D: K5 [% @& t/ M
  6.         return false;6 \. v3 w! d# }3 Y1 b* o$ }
  7.     }
    : s8 O  N2 }" k
  8.     return q.reload();
    , ?1 U; l0 _/ F4 z+ s9 U. h
  9. }
Скопировать код
8 M; g- Y  u! c2 C1 Z% x. i

( s, b" N/ |: A' Y( ], {Метод перезагружает квест по имени папки, в которой он хранится.Если квест с таким именем не найден, возвращается false, иначе вызывается метод reload() у объекта квеста.* I% ^$ x$ g0 e7 h  z, G; j5 J! c
Метод reload(int questId)% Y6 M; ]; `* h, i( N

) L2 Y. R; r3 l6 A3 p: L
  1. /**
    6 W. T% ~( _) P( \3 k( Z9 H& b
  2. * Перезагружает квест по ID.
    6 {, |9 S6 A) ]
  3. * @param questId ID квеста для перезагрузки
    0 \0 @- m, L) Y1 v0 F' K7 Y
  4. * @return {@code true} если перезагрузка успешна, {@code false} в противном случае: ^5 l5 F& m$ K" W% I! o
  5. */
    8 Q" K" D' k% j6 [" @' o) K9 K1 n
  6. public boolean reload(int questId)
    , u. @/ H1 z! f
  7. {
    6 Y3 t+ ?" n* |2 ^1 D' ^5 t
  8.     final Quest q = getQuest(questId);% I. a4 S% d+ E0 L. K! Y' q
  9.     if (q == null)- m3 J1 P" B1 m+ K. E
  10.     {
    / x' ?. C; \  X+ _- f5 f; |1 U
  11.         return false;
    * |7 d2 P0 V* L3 ?  h5 i9 A$ f
  12.     }
    + T9 t. D3 [( ]" M) [7 V5 ^
  13.     return q.reload();- N# a* i6 n0 f9 G# W$ [
  14. }
Скопировать код
  • Аналогично предыдущему методу, но перезагружает квест по его ID.
    7 N# P5 @3 |+ R

8 }4 I" v3 v5 V8 V7 T5 \Метод reloadAllScripts()
$ n; l1 C) ]1 T
/ u' m7 h  J" N2 o' {. |
  1. /**
    5 h+ h8 @% ^- T7 j0 r# Q/ k
  2. * Выгружает все квесты и скрипты, а затем перезагружает их.
    5 @7 O5 a# q0 s! h4 ]# s
  3. */' k7 B/ g5 q2 Y0 Q8 ~7 Y9 I$ U. S8 c
  4. public void reloadAllScripts()* ]/ F( f1 N( i; W+ \' m9 w6 l) q
  5. {
    . k+ z3 c" l% y  ?* F
  6.     unloadAllScripts();4 \4 \: B( ?1 x8 w! i2 f6 S, Y
  7.    
    + M. \% U  i) R- @
  8.     LOGGER.info("Перезагрузка всех серверных скриптов.");9 \/ U9 d  [$ u) s1 B& Y+ Z
  9.     try
    ; e( I7 ?7 d4 j6 G6 ]: l
  10.     {
    8 c6 G' [# N! n/ b1 a6 K" _$ ^
  11.         ScriptEngineManager.getInstance().executeScriptList();
    . @( z2 Z3 b) V% y0 w) [
  12.     }
    ( F6 X4 B6 ^  o6 Z
  13.     catch (Exception e)+ a: l, o/ W8 W- b9 F
  14.     {
    / E+ h9 {; e7 h7 S$ M
  15.         LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
    + X3 W! X  |+ u3 X1 Q& a
  16.     }4 O2 f# T! q0 v8 s, b4 e  r
  17.    
    8 B6 g3 D/ T; e& e4 U( F$ O* m5 A
  18.     getInstance().report();2 q( S* h/ G6 C
  19. }
Скопировать код
Метод unloadAllScripts()8 o. I! b: g# p4 u% t

- [% w: ?! y' _5 u  f
  1. /**5 s& f) H; G- i0 Q+ b5 k7 l
  2. * Выгружает все квесты и скрипты.$ o0 M2 y$ K) l# R
  3. */
    % L: k, O, b/ J0 Q& \  X
  4. public void unloadAllScripts()* }; r+ w: c2 Q8 p1 T( m
  5. {# d/ G% b- j, e7 x) c
  6.     LOGGER.info("Выгрузка всех серверных скриптов.");
    . N4 ^/ m, o) G4 }7 v8 ?/ p6 K
  7.     4 N' j$ h8 d$ u0 }
  8.     // Выгрузка квестов.
      ?+ @; N! }- N+ q
  9.     for (Quest quest : _quests.values())
      o% s6 F% T- A1 y: |
  10.     {
    4 A2 U3 T7 x! ~' _& H  p
  11.         if (quest != null)" c2 Q7 }5 v, @; ~
  12.         {& z! n! w7 v# y, E, g' W. w7 Q
  13.             quest.unload(false);. G5 W  @% f, m9 M# W. x: w' F! a, ?; j
  14.         }0 @$ b: h) N& |6 ~4 w/ Y) Y+ T) w; W' n4 K
  15.     }& c9 _  r% j7 m
  16.     _quests.clear();0 s, b& q1 a6 U$ y1 Q+ Z* X8 V
  17.     // Выгрузка скриптов.0 J  h  d) k( v5 L  w/ f4 R
  18.     for (Quest script : _scripts.values())
    8 o3 U: W- A3 B
  19.     {% `) A7 k0 H& e3 O, A' l
  20.         if (script != null)
    ( o4 A* E/ D* Z& W" O( `- f
  21.         {
    $ i- j6 d, l0 p5 L
  22.             script.unload(false);
    - _0 g9 _! S2 k4 z
  23.         }- `" X9 S& m5 ^% F5 q4 K( |5 g
  24.     }$ I/ H% d" S( T) b/ C/ y! N. }
  25.     _scripts.clear();
      K/ D4 T9 @  {. A3 \
  26. }
Скопировать код
  • Этот метод проходит по всем квестам и скриптам и вызывает метод unload() для каждого, а затем очищает коллекции _quests и _scripts.; d$ O: L+ A) F) }) h9 K

8 R! N2 O2 ?& x" W% oМетод report()
  T: R) o$ z2 s- X/ v
: X0 R# m7 ^# ~8 u
  1. /**
    , E9 X+ I" v/ e/ x
  2. * Логирует количество загруженных квестов и скриптов.
    & H2 L+ `3 F1 P+ U9 ^6 E
  3. */
    1 n" F) ^- e" o1 S' _+ }
  4. public void report(), @: g+ l# h% \, t) d- p8 @- k4 s
  5. {
    * R" }7 A* H$ P) x& w$ F) A9 a
  6.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");3 V; A, |0 l8 j8 s* N
  7.     LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");- g# U7 c2 k0 j- V$ j
  8. }
Скопировать код
  • Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.; _: t8 J0 n* N: W7 R
- \. p$ E# i& z: F2 _) `% m. ]
Метод getQuest(String name)
4 m1 ?8 \+ f2 }3 e
9 k% P' U6 t  `/ x2 [: w( E' Q
  1. /**
    # D2 J, e6 J3 k- H
  2. * Получает квест по имени.
    * B& z1 r  V* N$ |6 V
  3. * @param name имя квеста
    # N7 B$ [4 z/ H; Y1 W9 Y6 \
  4. * @return квест; W" D- P! }0 {# V" D
  5. */$ }/ Q# y6 L7 {' {/ [9 S; D1 b
  6. public Quest getQuest(String name)4 u% l; r9 i7 F+ u' l; r% R/ K& d
  7. {: F  u/ k% K1 O  A* x. q/ q: m# g, s2 w' v
  8.     if (_quests.containsKey(name))
    . |. g2 r( _6 p  s
  9.     {
    & C5 C4 w2 C9 X. i
  10.         return _quests.get(name);8 _& ]: F: b9 m6 F) y1 m5 l
  11.     }
    5 z8 m+ ], _8 O2 a* O: _
  12.     return _scripts.get(name);/ D) \4 D# c4 M
  13. }
Скопировать код
  • Этот метод возвращает квест по его имени, если он зарегистрирован в системе.5 L; `( r6 l: c- u! B) |" r
" A% A0 `; q8 m& O* B  M
Метод getQuest(int questId)$ l9 y- o% i3 u" U' b. U% ~  ~
" f5 W3 [+ J" L, y7 S' l
  1. /**0 E. Q. m8 G7 U* f, g( P
  2. * Получает квест по ID.
    # [: @/ \: d! T' y8 n* d1 U1 n+ j; W
  3. * @param questId ID квеста
    . ]; f. r( d  W" W) h) ?: z) l
  4. * @return квест, если найден, {@code null} в противном случае8 E) U0 F' C* `3 k
  5. */+ W! k7 ^" l8 o1 N6 y. |- G$ @
  6. public Quest getQuest(int questId)
    9 {* d9 \3 {3 n! L4 x; m6 }9 F, M
  7. {
    * s: @: w; ~( S/ [7 [  p3 W0 v2 `
  8.     for (Quest q : _quests.values())' I" J% m+ D+ x6 P& v% p( D4 i
  9.     {
    1 o- g" K1 p1 w& m& Q6 q: r
  10.         if (q.getId() == questId)8 u' O/ J7 v2 y% Y! r
  11.         {
    1 N& S/ j6 {6 _1 W+ O( T& i4 @
  12.             return q;
    ) @6 N2 W, l/ o6 m% n' z, x7 a0 `
  13.         }
    : `% D4 o+ M% p
  14.     }
    " W* ?" s1 S- d
  15.     return null;
    9 \5 [2 J% `! |  Q6 {$ x
  16. }
Скопировать код
  • Этот метод ищет квест по его уникальному идентификатору.
    $ {% U: R9 K! R  W1 M

" s- M; L: g" M) UМетод addQuest(Quest quest)9 [) e5 V! b! I) x6 a9 j

9 h5 i6 E, Y9 U8 ~# S
  1. /**
    - j7 N1 N+ ?$ T% ?7 t
  2. * Добавляет новый квест.
    5 v7 M7 E% z7 `
  3. * @param quest квест для добавления: c# T; }( {1 K* t$ q
  4. */
    , f+ g5 ^  j  G) ]3 d
  5. public void addQuest(Quest quest)( Q% }( D) S9 }$ a+ f
  6. {0 p7 B! G% J4 V% m4 ?
  7.     if (quest == null)
    . }7 G6 h* O9 K+ T; ^$ F' j
  8.     {2 L& c$ ^# `- n
  9.         throw new IllegalArgumentException("Аргумент квеста не может быть null");- T2 E7 ~7 `. w2 D) M# g
  10.     }
    . v. [$ t$ D5 D1 _, ~  b
  11.    
    , X- t, v( t$ d2 O) ?; b2 Q
  12.     final Quest old = _quests.put(quest.getName(), quest);
    $ u" q/ h1 `# U  J: }
  13.     if (old != null)! U: G8 t3 K/ ^3 X$ a# Q: C
  14.     {% \$ r7 h, v. @; a9 U/ B, E" T5 v: U
  15.         old.unload();
    9 L7 |. y  Y7 \( S* q
  16.         LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
    ' L& k$ B+ E, N1 E+ S- k
  17.     }
    / ^/ S# m8 N  [8 a( `1 {
  18.     " v. S3 W- L1 o. [6 X
  19.     if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
      b$ n5 @1 v, \. h6 l! t, D( O
  20.     {
    , Z- _, B+ R/ m+ x. n% a& v
  21.         final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
    & g: z& i0 j+ ]% w
  22.         LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");6 k; P4 X  f5 l6 ]  L9 n& f6 `
  23.     }
    : m/ `" W4 a7 ]' m7 I. f. J7 D
  24. }
    + o1 t  `4 `+ J: N. D/ _2 n
  25. ``
Скопировать код
Логика работыQuestManager управляет процессом загрузки, перезагрузки и выгрузки квестов и скриптов на сервере. Он поддерживает кэширование квестов и скриптов в картах _quests и _scripts, а также обеспечивает возможность их перезагрузки без перезапуска сервера.$ C, t$ @$ _' R# e  A' Z# y: p! l
ЗаключениеQuestManager.java — это ключевой элемент в управлении системой квестов и скриптов. Основная его функция — это управление квестами и скриптами, их загрузка, перезагрузка, выгрузка и хранение на сервере.5 T; ?2 Z7 M& R( r" V

: E7 @" a+ O' ~. }% P
$ o' y, w# _  p5 h% @! G( z
1 V5 F7 ]; o* E
Чтобы ответить, вам надо авторизироваться в системе Вход | Зарегистрироваться

Правил начисления баллов

Опубликовать
Сектор творческих людей
Горячая линия

638638758

С понедельника по воскресенье с 9:00 до 23:00

Обратной связь

admin@artace.ru Онлайн

QR-код

Powered by Discuz! X3.5© 2001-2021 Comsenz Inc.