Class: SlotDataService | RankingPlugin Wiki

Slot Data Service に関するサービス層・業務処理を担当します。

15Fields

1Constructors

24Methods

441Lines

Package: com.example.rankingplugin.slot
Source: slot/SlotDataService.java
Kind: class
Roles: 非同期 / スケジューラ初期化 / ブートストラップサービス層

このクラスにも章立て解説を追加しています。 自動抽出の一覧だけでなく、下の『重点クラスの詳細解説』で読む順番・内部サブシステム・変更時の注意点まで追えます。全クラス章立てガイドを見る

クラス説明

クラス直前の Javadoc は見つかりませんでした。ソースとメソッド構成から責務を補完しています。

責務と見どころ

非同期 / スケジューラ — 重い処理をメインスレッドから切り離し、定期実行も管理します。
初期化 / ブートストラップ — 他コンポーネントを組み立て、起動時の全体配線を担います。
サービス層 — 業務ロジックを公開し、呼び出し側の窓口になります。

重点クラスの詳細解説

Slot Data Service に関するサービス層・業務処理を担当します。slot パッケージの中でも 441 行規模の中核クラスで、永続化境界・スケジューラが一か所に集まっています。中規模クラス群の中では変更影響が広く、章立てで読む価値が高いため重点解説へ追加しています。

最初に追う読む順番

SlotDataService
依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。
ensureLoadedAsync
不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
loadOrCreate
実体や対象状態を作る段階で、後続フローがどのデータを前提に動くかを掴めます。
loadFromDb
実体や対象状態を作る段階で、後続フローがどのデータを前提に動くかを掴めます。
loadRecentJackpotSpins
実体や対象状態を作る段階で、後続フローがどのデータを前提に動くかを掴めます。
recordJackpotSpinAsync
結果を反映・永続化する境界です。表示だけ直って保存が壊れる系の切り分けに向きます。
recordJackpotSpin
結果を反映・永続化する境界です。表示だけ直って保存が壊れる系の切り分けに向きます。
applyLoaded
結果を反映・永続化する境界です。表示だけ直って保存が壊れる系の切り分けに向きます。
saveBatch
結果を反映・永続化する境界です。表示だけ直って保存が壊れる系の切り分けに向きます。

内部サブシステムの地図

起動・前提準備

初期テーブル、依存状態、定期処理の点灯など、このクラスが動き始める前提をまとめています。

主なメソッド

SlotDataService ensureLoadedAsync

主なフィールド

plugin ds serverId

入口 API と対象解決

外部から呼ばれる公開メソッドや、対象プレイヤー・対象データ・対象ワールドを引き当てる経路です。

主なメソッド

getOrCreateCached loadOrCreate loadFromDb getSpins getProbabilityMode loadRecentJackpotSpins

主なフィールド

plugin ds serverId cache pendingKillsDelta pendingResetKills pendingSpinsDelta pendingSetSpins pendingSetKills pendingSlots

状態反映と永続化

メモリ状態と保存状態を揃え、結果を次の呼び出しや画面表示へ繋ぐ部分です。

主なメソッド

saveBatch applyLoaded setSpins setSlots setProbabilityMode save recordJackpotSpinAsync recordJackpotSpin

主なフィールド

cache pendingKillsDelta pendingResetKills pendingSpinsDelta pendingSetSpins pendingSetKills pendingSlots pendingSetModes plugin ds

終了処理と掃除

停止時やフロー終端で残る実体・タスク・キャッシュを戻す出口です。

主なメソッド

shutdown

主なフィールド

cache pendingKillsDelta pendingResetKills pendingSpinsDelta pendingSetSpins pendingSetKills pendingSlots pendingSetModes flushTask

永続化と状態同期

DB テーブルとの境界です。スキーマ変更や保存漏れの切り分けはここから行います。

主なメソッド

saveBatch preload isLoaded getOrCreateCached loadOrCreate ensureLoadedAsync loadFromDb applyLoaded resetKills getSpins

主なフィールド

cache pendingKillsDelta pendingResetKills pendingSpinsDelta pendingSetSpins pendingSetKills pendingSlots pendingSetModes flushTask

代表フロー詳解

このクラスが前提状態を揃え、外部から利用可能な形まで立ち上がる流れです。新規依存の追加や起動失敗の調査はまずここから追います。

通常運用の中心フロー

saveBatch
applyLoaded
setSpins
setSlots
setProbabilityMode
save
recordJackpotSpinAsync

イベント受理、判定、状態更新、通知までの主経路です。体感不具合や想定外の分岐はこの流れのどこで止まるかを見ると切り分けやすいです。

反映・保存・終了の流れ

saveBatch
applyLoaded
setSpins
setSlots
setProbabilityMode
save

結果を保持し、必要なら永続化し、最後に掃除まで行う出口です。画面更新だけ合って保存が壊れるケースや残骸が残るケースの確認に向きます。

変更時の注意点

Bukkit 実体やワールド状態を触る処理はスレッド境界を崩さないようにしてください。重い計算だけを分離し、実体操作は既存の同期経路へ寄せるのが安全です。
DB スキーマと実装が密結合です。列追加や型変更を行うときは ensure / load / save 系をセットで見直し、古いデータとの互換も確認してください。

外部接点

主な永続化テーブル

SQL 文字列から抽出できた主要テーブルです。スキーマ変更時の確認用です。

slot_dataslot_win_historyinit

フィールド

Visibility	Type	Name	役割
`private`	`JavaPlugin`	`plugin`	プラグイン本体参照です。
`private`	`DataSource`	`ds`	DB 接続元を保持します。
`private`	`int`	`serverId`	serverId の状態を保持します。
`private`	`Map<UUID, SlotData>`	`cache`	キャッシュまたは直近計算結果を保持します。
`private`	`Set<UUID>`	`loaded`	loaded の状態を保持します。
`private`	`Set<UUID>`	`loading`	loading の状態を保持します。
`private`	`Set<UUID>`	`dirty`	dirty の状態を保持します。
`private`	`Map<UUID, Integer>`	`pendingKillsDelta`	pendingKillsDelta の状態を保持します。
`private`	`Set<UUID>`	`pendingResetKills`	pendingResetKills の状態を保持します。
`private`	`Map<UUID, Integer>`	`pendingSpinsDelta`	pendingSpinsDelta の状態を保持します。
`private`	`Map<UUID, Integer>`	`pendingSetSpins`	pendingSetSpins の状態を保持します。
`private`	`Map<UUID, Integer>`	`pendingSetKills`	pendingSetKills の状態を保持します。
`private`	`Map<UUID, int[]>`	`pendingSlots`	pendingSlots の状態を保持します。
`private`	`Map<UUID, SlotProbabilityMode>`	`pendingSetModes`	pendingSetModes の状態を保持します。
`private`	`BukkitTask`	`flushTask`	非同期処理やスケジューラ制御に使うハンドルです。

コンストラクタ / 初期化

Signature	説明	主要呼び出し
`public SlotDataService(JavaPlugin plugin, DataSource ds)`	依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。	getServer → getPort → getConnection → createStatement → executeUpdate → slot_data

メソッド索引

Name	Visibility	Kind	説明
SlotDataService	`public`	コンストラクタ	依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
flushDirtyTick	`private`	メソッド	flushDirtyTick の主要処理を担当します。
saveBatch	`private`	メソッド	状態を永続化または更新し、最新状態へ反映します。
preload	`public`	メソッド	preload の主要処理を担当します。
isLoaded	`public`	メソッド	条件判定を行い、後続処理の分岐に使える真偽値を返します。
getOrCreateCached	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
loadOrCreate	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
ensureLoadedAsync	`private`	メソッド	必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
loadFromDb	`private`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
applyLoaded	`private`	メソッド	applyLoaded の主要処理を担当します。
markDirty	`private`	メソッド	markDirty の主要処理を担当します。
incrementKills	`public`	メソッド	incrementKills の主要処理を担当します。
resetKills	`public`	メソッド	resetKills の主要処理を担当します。
incrementSpins	`public`	メソッド	incrementSpins の主要処理を担当します。
getSpins	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
setSpins	`public`	メソッド	setSpins の主要処理を担当します。
setSlots	`public`	メソッド	setSlots の主要処理を担当します。
getProbabilityMode	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
setProbabilityMode	`public`	メソッド	setProbabilityMode の主要処理を担当します。
save	`public`	メソッド	状態を永続化または更新し、最新状態へ反映します。
recordJackpotSpinAsync	`public`	メソッド	recordJackpotSpinAsync の主要処理を担当します。
recordJackpotSpin	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
loadRecentJackpotSpins	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
shutdown	`public`	メソッド	動作中の処理やリソースを安全に停止・解放します。

メソッド詳細

SlotDataService

コンストラクタpublic

public SlotDataService(JavaPlugin plugin, DataSource ds)

依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。

引数

JavaPlugin plugin
DataSource ds

throws

なし

主要な呼び出し順

getServergetPortgetConnectioncreateStatementexecuteUpdateslot_dataslot_win_historyidx_slot_win_history_player

flushDirtyTick

メソッドprivate

private void flushDirtyTick()

flushDirtyTick の主要処理を担当します。

引数

引数なし

throws

なし

主要な呼び出し順

isEmptycontainsremovegetSlot1getSlot2getSlot3getKillsgetSpins

saveBatch

メソッドprivate

private void saveBatch(List<SlotDataSnapshot> snaps)

状態を永続化または更新し、最新状態へ反映します。

引数

List<SlotDataSnapshot> snaps

throws

なし

主要な呼び出し順

slot_datagetConnectionprepareStatementsetIntsetStringtoStringkeyaddBatch

preload

メソッドpublic

public void preload(UUID playerId)

preload の主要処理を担当します。

引数

UUID playerId

throws

なし

主要な呼び出し順

ensureLoadedAsync

isLoaded

メソッドpublic

public boolean isLoaded(UUID playerId)

条件判定を行い、後続処理の分岐に使える真偽値を返します。

引数

UUID playerId

throws

なし

主要な呼び出し順

contains

getOrCreateCached

メソッドpublic

public SlotData getOrCreateCached(UUID playerId)

必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

引数

UUID playerId

throws

なし

主要な呼び出し順

computeIfAbsentensureLoadedAsync

loadOrCreate

メソッドpublic

public SlotData loadOrCreate(UUID playerId)

必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

引数

UUID playerId

throws

なし

主要な呼び出し順

getOrCreateCached

ensureLoadedAsync

メソッドprivate

private void ensureLoadedAsync(UUID playerId)

必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。

引数

UUID playerId

throws

なし

主要な呼び出し順

containsgetSchedulerrunTaskAsynchronouslyloadFromDbrunTaskapplyLoadedremove

loadFromDb

メソッドprivate

private SlotData loadFromDb(UUID playerId)

必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

引数

UUID playerId

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetIntsetStringtoStringexecuteQuerynextgetInt

applyLoaded

メソッドprivate

private void applyLoaded(UUID playerId, SlotData base)

applyLoaded の主要処理を担当します。

引数

UUID playerId
SlotData base

throws

なし

主要な呼び出し順

computeIfAbsentgetSlot1getSlot2getSlot3getKillsgetSpinsgetProbabilityModeremove

markDirty

メソッドprivate

private void markDirty(UUID playerId)

markDirty の主要処理を担当します。

引数

UUID playerId

throws

なし

主要な呼び出し順

目立つ内部呼び出しは抽出されませんでした。

incrementKills

メソッドpublic

public int incrementKills(UUID playerId, int delta)

incrementKills の主要処理を担当します。

引数

UUID playerId
int delta

throws

なし

主要な呼び出し順

getOrCreateCachedsetKillsgetKillscontainsmergemarkDirty

resetKills

メソッドpublic

public void resetKills(UUID playerId)

resetKills の主要処理を担当します。

引数

UUID playerId

throws

なし

主要な呼び出し順

getOrCreateCachedsetKillscontainsremovemarkDirty

incrementSpins

メソッドpublic

public int incrementSpins(UUID playerId, int delta)

incrementSpins の主要処理を担当します。

引数

UUID playerId
int delta

throws

なし

主要な呼び出し順

getOrCreateCachedsetSpinsgetSpinscontainsmergemarkDirty

getSpins

メソッドpublic

public int getSpins(UUID playerId)

必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

引数

UUID playerId

throws

なし

主要な呼び出し順

getOrCreateCached

setSpins

メソッドpublic

public void setSpins(UUID playerId, int spins)

setSpins の主要処理を担当します。

引数

UUID playerId
int spins

throws

なし

主要な呼び出し順

getOrCreateCachedcontainsremovemarkDirty

setSlots

メソッドpublic

public void setSlots(UUID playerId, int s1, int s2, int s3)

setSlots の主要処理を担当します。

引数

UUID playerId
int s1
int s2
int s3

throws

なし

主要な呼び出し順

getOrCreateCachedcontainsmarkDirty

getProbabilityMode

メソッドpublic

public SlotProbabilityMode getProbabilityMode(UUID playerId)

必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

引数

UUID playerId

throws

なし

主要な呼び出し順

getOrCreateCached

setProbabilityMode

メソッドpublic

public void setProbabilityMode(UUID playerId, SlotProbabilityMode mode)

setProbabilityMode の主要処理を担当します。

引数

UUID playerId
SlotProbabilityMode mode

throws

なし

主要な呼び出し順

getOrCreateCachedcontainsgetProbabilityModemarkDirty

save

メソッドpublic

public void save(SlotData data)

状態を永続化または更新し、最新状態へ反映します。

引数

SlotData data

throws

なし

主要な呼び出し順

getOrCreateCachedgetPlayerIdsetSlotsgetSlot1getSlot2getSlot3setKillsgetKills

recordJackpotSpinAsync

メソッドpublic

public void recordJackpotSpinAsync(UUID playerId, int spins, SlotProbabilityMode mode)

recordJackpotSpinAsync の主要処理を担当します。

引数

UUID playerId
int spins
SlotProbabilityMode mode

throws

なし

主要な呼び出し順

getSchedulerrunTaskAsynchronouslyrecordJackpotSpin

recordJackpotSpin

メソッドpublic

public void recordJackpotSpin(UUID playerId, int spins, SlotProbabilityMode mode)

DB への問い合わせまたは更新処理を担当します。

引数

UUID playerId
int spins
SlotProbabilityMode mode

throws

なし

主要な呼び出し順

slot_win_historygetConnectionprepareStatementsetIntsetStringtoStringkeysetTimestamp

loadRecentJackpotSpins

メソッドpublic

public List<String> loadRecentJackpotSpins(int limit)

必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

引数

int limit

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetIntexecuteQuerynextgetStringgetIntfromStorage

shutdown

メソッドpublic

public void shutdown()

動作中の処理やリソースを安全に停止・解放します。

引数

引数なし

throws

なし

主要な呼び出し順

cancelflushDirtyTick

代表的な処理フロー

初期化フロー
SlotDataService → getServer → getPort → getConnection → createStatement → executeUpdate
依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
loadFromDb フロー
loadFromDb → getConnection → prepareStatement → setInt → setString → toString
必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
loadRecentJackpotSpins フロー
loadRecentJackpotSpins → getConnection → prepareStatement → setInt → executeQuery → next
必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
save フロー
save → getOrCreateCached → getPlayerId → setSlots → getSlot1 → getSlot2
状態を永続化または更新し、最新状態へ反映します。
saveBatch フロー
saveBatch → slot_data → getConnection → prepareStatement → setInt → setString
状態を永続化または更新し、最新状態へ反映します。
ensureLoadedAsync フロー
ensureLoadedAsync → contains → getScheduler → runTaskAsynchronously → loadFromDb → runTask
必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。

外部との接点

Web ルート

このクラス内に目立つ Web ルート定義は見つかりませんでした。

SQL / テーブル

slot_dataCURRENT_TIMESTAMPslot_win_historyinit

補足

メソッド説明と処理フローは、Javadoc とソース本体の呼び出し列から自動要約しています。
匿名クラスや複雑なラムダ初期化を多用する箇所では、一部のフィールド / 呼び出し順が簡略表示になる場合があります。