Class: JackpotService

クラス説明

Jackpot pool (global / DB-shared).

重要:
- addToPool() は高頻度で呼ばれるため、メインスレッドで DB を叩かない。
- DB への反映は非同期でバッチ更新（UPDATE amount = amount + ?）。
- getAndReset() は「当選時」など低頻度なので DB をロックして原子的に取り出す。

責務と見どころ

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

フィールド

コンストラクタ / 初期化

メソッド索引

メソッド詳細

代表的な処理フロー

1. 初期化フロー
   JackpotService → getConnection → createStatement → executeUpdate → jackpot_pool → onFailure
   依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
2. shutdown フロー
   shutdown → cancel → flushPending
   プラグイン終了時に呼ぶ（未フラッシュ分をできるだけ反映）
3. flushPending フロー
   flushPending → isOffline → compareAndSet → sumThenReset → getConnection → prepareStatement
   DBに溜まった差分を反映（非同期タスクから呼ばれる前提）。
4. getAndReset フロー
   getAndReset → flushPending → isOffline → getConnection → setAutoCommit → prepareStatement
   現在のプールを取り出して0にリセット（原子的）。
5. refreshCacheSync フロー
   refreshCacheSync → isOffline → getConnection → createStatement → executeQuery → next
   DB への問い合わせまたは更新処理を担当します。

外部との接点

関連クラス

• DbCircuitBreaker (db) — DBが落ちた/重い時に、一定時間アクセス自体を止める（サーキットブレーカー）。
• PluginLocator (util) — プラグインインスタンス取得のユーティリティ。

補足

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