Зарегистрируйтесь сейчас чтобы найти еще больше друзей, и получить полноценный доступ ко всем функциям сайта!
Для просмотра Вам необходимо авторизоваться Если Вы еще не зарегистрированы, перейдите по ссылке:Зарегистрироваться
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
- /*
- t6 M; R( c* `/ y9 u5 \ - * Этот файл является частью проекта L2J Mobius.1 e- y9 X; N+ p: }# l/ i! f7 h
- *
' Q6 b" r/ v2 _: q - * Эта программа является свободным ПО: вы можете распространять её и/или изменять& x+ W3 g1 q- j6 R* J
- * её в соответствии с условиями GNU General Public License, опубликованной
* A* i" o& a) @) S - * Free Software Foundation, либо версии 3 лицензии, либо (по вашему выбору) любой более поздней версии.
( x7 `, O8 ]* x - *
7 Y# o n: o1 \1 ?4 s - * Эта программа распространяется в надежде, что она будет полезной,
; U) V* O/ Q& ^: I+ x8 F - * но БЕЗ КАКИХ-ЛИБО ГАРАНТИЙ; даже без подразумеваемой гарантии2 p! o# D2 ]3 e0 g) f- _
- * КОММЕРЧЕСКОЙ ПРИГОДНОСТИ или ПРИГОДНОСТИ ДЛЯ КОНКРЕТНОЙ ЦЕЛИ.
9 o. X0 H1 `6 ?* I7 b: N, t - * См. GNU General Public License для получения более подробной информации.& m$ _$ x9 t! ?" D
- * ' O3 d U; N, A" g2 n
- * Вы должны были получить копию GNU General Public License/ A& l' W' }( e9 X8 N" N: v* t% l9 R
- * вместе с этой программой. Если нет, см. <http://www.gnu.org/licenses/>.; q5 d9 r7 v- h5 r, O; L
- */
Скопировать код Это стандартный блок лицензии, который описывает, что этот код является открытым исходным кодом, распространяемым по лицензии 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
- package org.l2jmobius.gameserver.instancemanager;& h g* c" K; ]0 N! M! j
- ) C5 v8 G4 L* s/ l, a, m
- import java.util.Map;
: G2 l- C b* J- _0 I2 u - import java.util.concurrent.ConcurrentHashMap;
! a" h0 _5 D) g$ g) e& B" X - import java.util.logging.Level;# b" G7 @7 q; }$ \6 c* \3 p3 h
- import java.util.logging.Logger;
# W2 f4 R3 U8 c+ `! j! |: F! t7 C - 9 \4 d6 ~2 F$ S" J5 T5 o
- import org.l2jmobius.Config;: J; Q w' l+ R- v- d% v
- import org.l2jmobius.commons.util.CommonUtil;) H* Z+ w0 y7 t |+ |3 a* Z/ T+ m
- import org.l2jmobius.gameserver.model.quest.Quest;
' T( x! [0 [6 w( | - 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
- /**, n# `, w( l/ I) ]
- * Менеджер квестов и скриптов.
; d" D' K9 H% K$ c' N. y - * Автор: Zoey76: a' K: {; o2 R
- */
# O" x& T& {+ P: c4 s: A v/ P - public class QuestManager. h1 {: j, P# f0 i+ `
- {
3 A+ _" U0 g! Y5 v - private static final Logger LOGGER = Logger.getLogger(QuestManager.class.getName());4 V3 }0 v' B0 S8 H7 \
-
6 a! v$ c# U8 q+ J. \* ?2 {: b/ b - /** Карта, содержащая все квесты. */( T" Z5 i" {, }" s4 G! z2 P' G5 M
- private final Map<String, Quest> _quests = new ConcurrentHashMap<>();+ n, C9 Z% G, s( G* R
- /** Карта, содержащая все скрипты. */4 C$ {" U. e, Q% O+ d* B. [
- private final Map<String, Quest> _scripts = new ConcurrentHashMap<>();. x+ T& i% {8 _9 @9 k! r: S! z9 F
-
5 ?1 ~) r- ?0 w! @- _ - protected QuestManager()
$ D+ Y, e1 W2 Z& T( @) d - {
# ^+ Y) p9 L( R$ Y H - }
Y: D! w: v( ]0 F - }
Скопировать код 4. Методы
2 R: ^4 f- ~# \$ g! PМетод reload(String questFolder)* |% o1 A, P! `
- public boolean reload(String questFolder)! X2 m+ e4 f/ @' l1 m) S& w8 g
- {9 C+ p; P1 d% ]3 h: Q. p7 W
- final Quest q = getQuest(questFolder);0 x$ J+ z0 a7 D
- if (q == null)
) `, L- V; [! e. |) e {; _ - {
& K b. n% _# D: K5 [% @& t/ M - return false;6 \. v3 w! d# }3 Y1 b* o$ }
- }
: s8 O N2 }" k - return q.reload();
, ?1 U; l0 _/ F4 z+ s9 U. h - }
Скопировать код 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- /**
6 W. T% ~( _) P( \3 k( Z9 H& b - * Перезагружает квест по ID.
6 {, |9 S6 A) ] - * @param questId ID квеста для перезагрузки
0 \0 @- m, L) Y1 v0 F' K7 Y - * @return {@code true} если перезагрузка успешна, {@code false} в противном случае: ^5 l5 F& m$ K" W% I! o
- */
8 Q" K" D' k% j6 [" @' o) K9 K1 n - public boolean reload(int questId)
, u. @/ H1 z! f - {
6 Y3 t+ ?" n* |2 ^1 D' ^5 t - final Quest q = getQuest(questId);% I. a4 S% d+ E0 L. K! Y' q
- if (q == null)- m3 J1 P" B1 m+ K. E
- {
/ x' ?. C; \ X+ _- f5 f; |1 U - return false;
* |7 d2 P0 V* L3 ? h5 i9 A$ f - }
+ T9 t. D3 [( ]" M) [7 V5 ^ - return q.reload();- N# a* i6 n0 f9 G# W$ [
- }
Скопировать код- Аналогично предыдущему методу, но перезагружает квест по его 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' {. |- /**
5 h+ h8 @% ^- T7 j0 r# Q/ k - * Выгружает все квесты и скрипты, а затем перезагружает их.
5 @7 O5 a# q0 s! h4 ]# s - */' k7 B/ g5 q2 Y0 Q8 ~7 Y9 I$ U. S8 c
- public void reloadAllScripts()* ]/ F( f1 N( i; W+ \' m9 w6 l) q
- {
. k+ z3 c" l% y ?* F - unloadAllScripts();4 \4 \: B( ?1 x8 w! i2 f6 S, Y
-
+ M. \% U i) R- @ - LOGGER.info("Перезагрузка всех серверных скриптов.");9 \/ U9 d [$ u) s1 B& Y+ Z
- try
; e( I7 ?7 d4 j6 G6 ]: l - {
8 c6 G' [# N! n/ b1 a6 K" _$ ^ - ScriptEngineManager.getInstance().executeScriptList();
. @( z2 Z3 b) V% y0 w) [ - }
( F6 X4 B6 ^ o6 Z - catch (Exception e)+ a: l, o/ W8 W- b9 F
- {
/ E+ h9 {; e7 h7 S$ M - LOGGER.log(Level.SEVERE, "Не удалось выполнить список скриптов!", e);
+ X3 W! X |+ u3 X1 Q& a - }4 O2 f# T! q0 v8 s, b4 e r
-
8 B6 g3 D/ T; e& e4 U( F$ O* m5 A - getInstance().report();2 q( S* h/ G6 C
- }
Скопировать код Метод unloadAllScripts()8 o. I! b: g# p4 u% t
- [% w: ?! y' _5 u f- /**5 s& f) H; G- i0 Q+ b5 k7 l
- * Выгружает все квесты и скрипты.$ o0 M2 y$ K) l# R
- */
% L: k, O, b/ J0 Q& \ X - public void unloadAllScripts()* }; r+ w: c2 Q8 p1 T( m
- {# d/ G% b- j, e7 x) c
- LOGGER.info("Выгрузка всех серверных скриптов.");
. N4 ^/ m, o) G4 }7 v8 ?/ p6 K - 4 N' j$ h8 d$ u0 }
- // Выгрузка квестов.
?+ @; N! }- N+ q - for (Quest quest : _quests.values())
o% s6 F% T- A1 y: | - {
4 A2 U3 T7 x! ~' _& H p - if (quest != null)" c2 Q7 }5 v, @; ~
- {& z! n! w7 v# y, E, g' W. w7 Q
- quest.unload(false);. G5 W @% f, m9 M# W. x: w' F! a, ?; j
- }0 @$ b: h) N& |6 ~4 w/ Y) Y+ T) w; W' n4 K
- }& c9 _ r% j7 m
- _quests.clear();0 s, b& q1 a6 U$ y1 Q+ Z* X8 V
- // Выгрузка скриптов.0 J h d) k( v5 L w/ f4 R
- for (Quest script : _scripts.values())
8 o3 U: W- A3 B - {% `) A7 k0 H& e3 O, A' l
- if (script != null)
( o4 A* E/ D* Z& W" O( `- f - {
$ i- j6 d, l0 p5 L - script.unload(false);
- _0 g9 _! S2 k4 z - }- `" X9 S& m5 ^% F5 q4 K( |5 g
- }$ I/ H% d" S( T) b/ C/ y! N. }
- _scripts.clear();
K/ D4 T9 @ {. A3 \ - }
Скопировать код- Этот метод проходит по всем квестам и скриптам и вызывает метод 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- /**
, E9 X+ I" v/ e/ x - * Логирует количество загруженных квестов и скриптов.
& H2 L+ `3 F1 P+ U9 ^6 E - */
1 n" F) ^- e" o1 S' _+ } - public void report(), @: g+ l# h% \, t) d- p8 @- k4 s
- {
* R" }7 A* H$ P) x& w$ F) A9 a - LOGGER.info(getClass().getSimpleName() + ": Загружено " + _quests.size() + " квестов.");3 V; A, |0 l8 j8 s* N
- LOGGER.info(getClass().getSimpleName() + ": Загружено " + _scripts.size() + " скриптов.");- g# U7 c2 k0 j- V$ j
- }
Скопировать код- Этот метод просто выводит в лог информацию о количестве загруженных квестов и скриптов.; _: 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- /**
# D2 J, e6 J3 k- H - * Получает квест по имени.
* B& z1 r V* N$ |6 V - * @param name имя квеста
# N7 B$ [4 z/ H; Y1 W9 Y6 \ - * @return квест; W" D- P! }0 {# V" D
- */$ }/ Q# y6 L7 {' {/ [9 S; D1 b
- public Quest getQuest(String name)4 u% l; r9 i7 F+ u' l; r% R/ K& d
- {: F u/ k% K1 O A* x. q/ q: m# g, s2 w' v
- if (_quests.containsKey(name))
. |. g2 r( _6 p s - {
& C5 C4 w2 C9 X. i - return _quests.get(name);8 _& ]: F: b9 m6 F) y1 m5 l
- }
5 z8 m+ ], _8 O2 a* O: _ - return _scripts.get(name);/ D) \4 D# c4 M
- }
Скопировать код- Этот метод возвращает квест по его имени, если он зарегистрирован в системе.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
- /**0 E. Q. m8 G7 U* f, g( P
- * Получает квест по ID.
# [: @/ \: d! T' y8 n* d1 U1 n+ j; W - * @param questId ID квеста
. ]; f. r( d W" W) h) ?: z) l - * @return квест, если найден, {@code null} в противном случае8 E) U0 F' C* `3 k
- */+ W! k7 ^" l8 o1 N6 y. |- G$ @
- public Quest getQuest(int questId)
9 {* d9 \3 {3 n! L4 x; m6 }9 F, M - {
* s: @: w; ~( S/ [7 [ p3 W0 v2 ` - for (Quest q : _quests.values())' I" J% m+ D+ x6 P& v% p( D4 i
- {
1 o- g" K1 p1 w& m& Q6 q: r - if (q.getId() == questId)8 u' O/ J7 v2 y% Y! r
- {
1 N& S/ j6 {6 _1 W+ O( T& i4 @ - return q;
) @6 N2 W, l/ o6 m% n' z, x7 a0 ` - }
: `% D4 o+ M% p - }
" W* ?" s1 S- d - return null;
9 \5 [2 J% `! | Q6 {$ x - }
Скопировать код- Этот метод ищет квест по его уникальному идентификатору.
$ {% 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- /**
- j7 N1 N+ ?$ T% ?7 t - * Добавляет новый квест.
5 v7 M7 E% z7 ` - * @param quest квест для добавления: c# T; }( {1 K* t$ q
- */
, f+ g5 ^ j G) ]3 d - public void addQuest(Quest quest)( Q% }( D) S9 }$ a+ f
- {0 p7 B! G% J4 V% m4 ?
- if (quest == null)
. }7 G6 h* O9 K+ T; ^$ F' j - {2 L& c$ ^# `- n
- throw new IllegalArgumentException("Аргумент квеста не может быть null");- T2 E7 ~7 `. w2 D) M# g
- }
. v. [$ t$ D5 D1 _, ~ b -
, X- t, v( t$ d2 O) ?; b2 Q - final Quest old = _quests.put(quest.getName(), quest);
$ u" q/ h1 `# U J: } - if (old != null)! U: G8 t3 K/ ^3 X$ a# Q: C
- {% \$ r7 h, v. @; a9 U/ B, E" T5 v: U
- old.unload();
9 L7 |. y Y7 \( S* q - LOGGER.info("Заменен квест " + old.getName() + " (" + old.getId() + ") новой версией!");
' L& k$ B+ E, N1 E+ S- k - }
/ ^/ S# m8 N [8 a( `1 { - " v. S3 W- L1 o. [6 X
- if (Config.ALT_DEV_SHOW_QUESTS_LOAD_IN_LOGS)
b$ n5 @1 v, \. h6 l! t, D( O - {
, Z- _, B+ R/ m+ x. n% a& v - final String questName = quest.getName().contains("_") ? quest.getName().substring(quest.getName().indexOf('_') + 1) : quest.getName();
& g: z& i0 j+ ]% w - LOGGER.info("Загружен квест " + CommonUtil.splitWords(questName) + ".");6 k; P4 X f5 l6 ] L9 n& f6 `
- }
: m/ `" W4 a7 ]' m7 I. f. J7 D - }
+ o1 t `4 `+ J: N. D/ _2 n - ``
Скопировать код Логика работы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 |