起動・前提準備
初期テーブル、依存状態、定期処理の点灯など、このクラスが動き始める前提をまとめています。
Event Runtime Service に関するサービス層・業務処理を担当します。
com.example.rankingplugin.eventsevents/EventRuntimeService.javaclassクラス直前の Javadoc は見つかりませんでした。ソースとメソッド構成から責務を補完しています。
Event Runtime Service に関するサービス層・業務処理を担当します。events パッケージの中でも 772 行規模の中核クラスで、運用中の主ループ・永続化境界・スケジューラが一か所に集まっています。中規模クラス群の中では変更影響が広く、章立てで読む価値が高いため重点解説へ追加しています。
EventRuntimeServiceensureEventScoreTableensureAdminEventsPayoutColumnsensureBarsForPlayerbuildRankMappollAndAnnounceonQuitonJoinupdateBossBars初期テーブル、依存状態、定期処理の点灯など、このクラスが動き始める前提をまとめています。
外部から呼ばれる公開メソッドや、対象プレイヤー・対象データ・対象ワールドを引き当てる経路です。
イベント受理、定期監視、判定、進行更新など、実際に挙動を生む中心ロジックです。
メモリ状態と保存状態を揃え、結果を次の呼び出しや画面表示へ繋ぐ部分です。
DB テーブルとの境界です。スキーマ変更や保存漏れの切り分けはここから行います。
EventRuntimeServiceensureEventScoreTableensureAdminEventsPayoutColumnsensureBarsForPlayergetScoreMultiplierForMobKillgetRankAndScoreCachedこのクラスが前提状態を揃え、外部から利用可能な形まで立ち上がる流れです。新規依存の追加や起動失敗の調査はまずここから追います。
イベント受理、判定、状態更新、通知までの主経路です。体感不具合や想定外の分岐はこの流れのどこで止まるかを見ると切り分けやすいです。
結果を保持し、必要なら永続化し、最後に掃除まで行う出口です。画面更新だけ合って保存が壊れるケースや残骸が残るケースの確認に向きます。
このクラス内で直接見つかる主な Web ルート/項目名です。
SQL 文字列から抽出できた主要テーブルです。スキーマ変更時の確認用です。
| Signature | 説明 | 主要呼び出し |
|---|---|---|
public EventRuntimeService(JavaPlugin plugin, DataSource ds, ScoreService scoreService) | 依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 | ensureEventScoreTable → ensureAdminEventsPayoutColumns → run → pollAndAnnounce → runTaskTimerAsynchronously → updateBossBars |
| Name | Visibility | Kind | 説明 |
|---|---|---|---|
| firstNonNull | private | メソッド | firstNonNull の主要処理を担当します。 |
| nameEq | private | メソッド | nameEq の主要処理を担当します。 |
| EventRuntimeService | public | コンストラクタ | 依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 |
| truthy | private | メソッド | truthy の主要処理を担当します。 |
| ensureEventScoreTable | private | メソッド | 必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。 |
| ensureAdminEventsPayoutColumns | private | メソッド | 必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。 |
| nodeId | private | メソッド | nodeId の主要処理を担当します。 |
| tryClaimPayout | private | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| isFantasiaWorld | private | メソッド | 条件判定を行い、後続処理の分岐に使える真偽値を返します。 |
| getScoreMultiplierForMobKill | public | メソッド | スコア倍増(モブ討伐用)の倍率。 |
| isNoDeathPenaltyActive | public | メソッド | 条件判定を行い、後続処理の分岐に使える真偽値を返します。 |
| addMobKillIfActive | public | メソッド | MOB_KILLイベントが動作中なら、討伐数を +1 する |
| addOreGatherIfActive | public | メソッド | ORE_GATHERイベントが動作中なら、採掘数を +1 する |
| addFishingCatchIfActive | public | メソッド | 釣りイベントが動作中なら、対象アイテムなら +1 する |
| notifyPlayerJoin | public | メソッド | プレイヤーが入ってきた時に、開催中のイベント一覧を案内&BossBar表示 |
| pollAndAnnounce | private | メソッド | DBから running を読み直して差分を放送 |
| broadcastStart | private | メソッド | broadcastStart の主要処理を担当します。 |
| isRankingEvent | private | メソッド | 条件判定を行い、後続処理の分岐に使える真偽値を返します。 |
| broadcastEnd | private | メソッド | broadcastEnd の主要処理を担当します。 |
| fetchTopRows | private | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| announceTopAndPayout | private | メソッド | announceTopAndPayout の主要処理を担当します。 |
| ensureBarsForPlayer | private | メソッド | 必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。 |
| removeBarsForEvent | private | メソッド | 対象データや登録状態を削除・解除します。 |
| updateBossBars | private | メソッド | 状態を永続化または更新し、最新状態へ反映します。 |
| formatRemain | private | メソッド | formatRemain の主要処理を担当します。 |
| getRankAndScoreCached | private | メソッド | 必要な状態を取得し、呼び出し側で利用しやすい形へ返します。 |
| buildRankMap | private | メソッド | 表示用または出力用のデータを組み立てます。 |
| addEventScore | private | メソッド | addEventScore の主要処理を担当します。 |
| flushPendingEventScores | private | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| markEndedInDb | private | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| onQuit | public | イベント処理 | イベント発生時の分岐と後続処理を担当します。 |
| onJoin | public | イベント処理 | イベント発生時の分岐と後続処理を担当します。 |
| shutdown | public | メソッド | 動作中の処理やリソースを安全に停止・解放します。 |
private static Object firstNonNull(Object a, Object b)firstNonNull の主要処理を担当します。
Object aObject bなし
private static boolean nameEq(Object o, String expect)nameEq の主要処理を担当します。
Object oString expectなし
public EventRuntimeService(JavaPlugin plugin, DataSource ds, ScoreService scoreService)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
JavaPlugin pluginDataSource dsScoreService scoreServiceなし
private static boolean truthy(Object v)truthy の主要処理を担当します。
Object vなし
private void ensureEventScoreTable()必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
なし
private void ensureAdminEventsPayoutColumns()必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
なし
private String nodeId()nodeId の主要処理を担当します。
なし
private boolean tryClaimPayout(int eventId)DB への問い合わせまたは更新処理を担当します。
int eventIdなし
private static boolean isFantasiaWorld(World w)条件判定を行い、後続処理の分岐に使える真偽値を返します。
World wなし
public double getScoreMultiplierForMobKill()スコア倍増(モブ討伐用)の倍率。
なし
public boolean isNoDeathPenaltyActive()条件判定を行い、後続処理の分岐に使える真偽値を返します。
なし
public void addMobKillIfActive(org.bukkit.entity.Entity killed, String playerName)MOB_KILLイベントが動作中なら、討伐数を +1 する
org.bukkit.entity.Entity killedString playerNameなし
public void addOreGatherIfActive(Block block, Player player)ORE_GATHERイベントが動作中なら、採掘数を +1 する
Block blockPlayer playerなし
public void addFishingCatchIfActive(org.bukkit.Material caughtItem, String playerName)釣りイベントが動作中なら、対象アイテムなら +1 する
org.bukkit.Material caughtItemString playerNameなし
public void notifyPlayerJoin(Player p)プレイヤーが入ってきた時に、開催中のイベント一覧を案内&BossBar表示
Player pなし
private void pollAndAnnounce()DBから running を読み直して差分を放送
なし
private void broadcastStart(Ev ev)broadcastStart の主要処理を担当します。
Ev evなし
private static boolean isRankingEvent(Ev ev)条件判定を行い、後続処理の分岐に使える真偽値を返します。
Ev evなし
private void broadcastEnd(Ev ev)broadcastEnd の主要処理を担当します。
Ev evなし
private List<Row> fetchTopRows(int eventId, int limit)DB への問い合わせまたは更新処理を担当します。
int eventIdint limitなし
private void announceTopAndPayout(Ev ev)announceTopAndPayout の主要処理を担当します。
Ev evなし
private void ensureBarsForPlayer(UUID uuid)必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
UUID uuidなし
private void removeBarsForEvent(int eventId)対象データや登録状態を削除・解除します。
int eventIdなし
private void updateBossBars() throws SQLException状態を永続化または更新し、最新状態へ反映します。
SQLException
private String formatRemain(long millis)formatRemain の主要処理を担当します。
long millisなし
private int[] getRankAndScoreCached(int eventId, String player) throws SQLException必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
int eventIdString playerSQLException
private Map<String,int[]> buildRankMap(int eventId) throws SQLException表示用または出力用のデータを組み立てます。
int eventIdSQLException
private void addEventScore(int eventId, String player, int delta)addEventScore の主要処理を担当します。
int eventIdString playerint deltaなし
private void flushPendingEventScores()DB への問い合わせまたは更新処理を担当します。
なし
private void markEndedInDb(int eventId)DB への問い合わせまたは更新処理を担当します。
int eventIdなし
public void onQuit(PlayerQuitEvent e)イベント発生時の分岐と後続処理を担当します。
PlayerQuitEvent eなし
public void onJoin(PlayerJoinEvent e)イベント発生時の分岐と後続処理を担当します。
PlayerJoinEvent eなし
public void shutdown()動作中の処理やリソースを安全に停止・解放します。
なし
EventRuntimeService → ensureEventScoreTable → ensureAdminEventsPayoutColumns → run → pollAndAnnounce → runTaskTimerAsynchronouslyonQuit → getPlayer → getUniqueId → remove → values → forEachonJoin → notifyPlayerJoin → getPlayerupdateBossBars → isEmpty → now → entrySet → getPlayer → getKeyensureBarsForPlayer → computeIfAbsent → values → equals → createBossBar → getPlayerensureEventScoreTable → getConnection → createStatement → executeUpdate → event_scores → getLogger