Class: Bingo5x5Event

5x5 ビンゴイベント。

9Fields
1Constructors
16Methods
250Lines
Package
com.example.rankingplugin.scoreboard.events
Source
scoreboard/events/Bingo5x5Event.java
Kind
class
Roles
DB / 永続化
このクラスにも章立て解説を追加しています。 自動抽出の一覧だけでなく、下の『重点クラスの詳細解説』で読む順番・内部サブシステム・変更時の注意点まで追えます。 全クラス章立てガイドを見る

クラス説明

5x5 ビンゴイベント。行表示は5行まで(必要なら6行目空)

責務と見どころ

重点クラスの詳細解説

5x5 ビンゴイベント。scoreboard.events パッケージの 小〜中規模クラスで、運用中の主ループ・永続化境界を確認する起点です。全面展開版では、他の重点クラスと同じ章立てで読めるように補強しています。

最初に追う読む順番

  1. Bingo5x5Event
    依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。
  2. ensureTables
    不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
  3. buildLineMasks
    表示用または出力用のデータを組み立てます。
  4. renderHeaderLines
    表示用または出力用のデータを組み立てます。
  5. onEnd
    運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。
  6. applyParams
    結果を反映・永続化する境界です。表示だけ直って保存が壊れる系の切り分けに向きます。
  7. eventId
    eventId の主要処理を担当します。
  8. indexForMobKey
    ====== ここからビンゴ進捗API（既存BingoMob側から呼ぶ） ======

内部サブシステムの地図

起動・前提準備

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

主なメソッド
ensureTables Bingo5x5Event
主なフィールド
serverId DS_SINGLETON

運用中の主ループ

イベント受理、定期監視、判定、進行更新など、実際に挙動を生む中心ロジックです。

主なメソッド
onEnd
主なフィールド
なし

代表フロー詳解

通常運用の中心フロー

  1. onEnd
  2. applyParams
  3. setGlobalDataSource

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

反映・保存・終了の流れ

  1. applyParams
  2. setGlobalDataSource

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

変更時の注意点

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

外部接点

外部ルート

このクラス内で直接見つかる主な Web ルート／項目名です。

GET spawn_boostGET score_per_lineGET symbol_hitGET symbol_missGET mob_pool

主な永続化テーブル

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

event_bingo5_stateevent_bingo5_award_loghits_mask

フィールド

VisibilityTypeName役割
privateinteventIdeventId の状態を保持します。
privateStringserverIdserverId の状態を保持します。
privatedoublespawnBoostspawnBoost の状態を保持します。
privatelongscorePerLinescorePerLine の状態を保持します。
privateStringsymbolHitsymbolHit の状態を保持します。
privateStringsymbolMisssymbolMiss の状態を保持します。
privateint[]LINE_MASKSLINE_MASKS の状態を保持します。
privateList<String>mobPoolmobPool の状態を保持します。
privateDataSourceDS_SINGLETONDB 接続元を保持します。

コンストラクタ / 初期化

Signature説明主要呼び出し
public Bingo5x5Event(int eventId, String serverId)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。主要呼び出しなし

メソッド索引

NameVisibilityKind説明
buildLineMasksprivateメソッド表示用または出力用のデータを組み立てます。
ensureTablespublicメソッド必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
Bingo5x5Eventpublicコンストラクタ依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
eventIdpublicメソッドeventId の主要処理を担当します。
eventIdpublicメソッドeventId の主要処理を担当します。
eventIdpublicメソッドeventId の主要処理を担当します。
onEndpublicメソッドonEnd の主要処理を担当します。
renderHeaderLinespublicメソッド表示用または出力用のデータを組み立てます。
applyParamspublicメソッドapplyParams の主要処理を担当します。
indexForMobKeyprivateメソッド====== ここからビンゴ進捗API（既存BingoMob側から呼ぶ） ======
markHitpublicメソッド（例）BingoMob撃破等のタイミングで呼ぶ
getHitsMaskFromMemoryOrDBprivateメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
countLinesprivateメソッドcountLines の主要処理を担当します。
awardAndFinalizepublicメソッドDB への問い合わせまたは更新処理を担当します。
setGlobalDataSourcepublicメソッドsetGlobalDataSource の主要処理を担当します。
getDsprivateメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

メソッド詳細

buildLineMasks

メソッドprivatestatic
private static int[] buildLineMasks()

表示用または出力用のデータを組み立てます。

引数

  • 引数なし

throws

なし

主要な呼び出し順

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

ensureTables

メソッドpublicstatic
public static void ensureTables(DataSource ds)

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

引数

  • DataSource ds

throws

なし

主要な呼び出し順

getConnectioncreateStatementexecuteUpdateevent_bingo5_stateevent_bingo5_award_logprintStackTrace

Bingo5x5Event

コンストラクタpublic
public Bingo5x5Event(int eventId, String serverId)

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

引数

  • int eventId
  • String serverId

throws

なし

主要な呼び出し順

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

eventId

メソッドpublic
public int eventId()

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

引数

  • 引数なし

throws

なし

主要な呼び出し順

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

eventId

メソッドpublic
public int eventId() { return eventId; } public String kind()

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

引数

  • ) { return eventId; } public String kind(

throws

なし

主要な呼び出し順

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

eventId

メソッドpublic
public int eventId() { return eventId; } public String kind() { return "BINGO5X5"; } public void onStart(Plugin plugin)

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

引数

  • ) { return eventId; } public String kind() { return "BINGO5X5"; } public void onStart(Plugin plugin

throws

なし

主要な呼び出し順

setSpawnMultipliergetLoggerinfostarted

onEnd

メソッドpublic
public void onEnd(Plugin plugin)

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

引数

  • Plugin plugin

throws

なし

主要な呼び出し順

setSpawnMultipliergetLoggerinfoended

renderHeaderLines

メソッドpublic
public List<String> renderHeaderLines(Player p, int maxLines)

表示用または出力用のデータを組み立てます。

引数

  • Player p
  • int maxLines

throws

なし

主要な呼び出し順

getHitsMaskFromMemoryOrDBgetNameappendtoStringsizesubList

applyParams

メソッドpublic
public void applyParams(Map<String, Object> params)

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

引数

  • Map<String, Object> params

throws

なし

主要な呼び出し順

doubleValuelongValueisBlankvalueOfsizeremove

indexForMobKey

メソッドprivatestatic
private static int indexForMobKey(String key, List<String> pool)

====== ここからビンゴ進捗API（既存BingoMob側から呼ぶ） ======

引数

  • String key
  • List<String> pool

throws

なし

主要な呼び出し順

sizeindexOfabshashCode

markHit

メソッドpublic
public void markHit(DataSource ds, UUID playerId, String playerName, String mobKey)

（例）BingoMob撃破等のタイミングで呼ぶ

引数

  • DataSource ds
  • UUID playerId
  • String playerName
  • String mobKey

throws

なし

主要な呼び出し順

indexForMobKeytoStringgetConnectionprepareStatementsetIntsetStringexecuteQuerynext

getHitsMaskFromMemoryOrDB

メソッドprivate
private int getHitsMaskFromMemoryOrDB(String playerName)

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

引数

  • String playerName

throws

なし

主要な呼び出し順

getDsgetConnectionprepareStatementsetIntsetStringexecuteQuerynextgetInt

countLines

メソッドprivatestatic
private static int countLines(int mask25)

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

引数

  • int mask25

throws

なし

主要な呼び出し順

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

awardAndFinalize

メソッドpublicstatic
public static int awardAndFinalize(DataSource ds, int eventId, long scorePerLine, java.util.function.BiConsumer<String,Long> addScore)

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

引数

  • DataSource ds
  • int eventId
  • long scorePerLine
  • java.util.function.BiConsumer<String,Long> addScore

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetIntexecuteQuerynextgetStringgetIntaccept

setGlobalDataSource

メソッドpublicstatic
public static void setGlobalDataSource(DataSource ds)

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

引数

  • DataSource ds

throws

なし

主要な呼び出し順

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

getDs

メソッドprivatestatic
private static DataSource getDs()

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

引数

  • 引数なし

throws

なし

主要な呼び出し順

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

代表的な処理フロー

  1. onEnd フロー
    onEnd → setSpawnMultiplier → getLogger → info → ended
    onEnd の主要処理を担当します。
  2. ensureTables フロー
    ensureTables → getConnection → createStatement → executeUpdate → event_bingo5_state → event_bingo5_award_log
    必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
  3. renderHeaderLines フロー
    renderHeaderLines → getHitsMaskFromMemoryOrDB → getName → append → toString → size
    表示用または出力用のデータを組み立てます。
  4. awardAndFinalize フロー
    awardAndFinalize → getConnection → prepareStatement → setInt → executeQuery → next
    DB への問い合わせまたは更新処理を担当します。

外部との接点

Web ルート

GET spawn_boostGET score_per_lineGET symbol_hitGET symbol_missGET mob_pool

SQL / テーブル

event_bingo5_stateCURRENT_TIMESTAMPevent_bingo5_award_loghits_mask

関連クラス

補足