起動・前提準備
初期テーブル、依存状態、定期処理の点灯など、このクラスが動き始める前提をまとめています。
Animaツリーの現在階/最大階を管理し、節目で報酬付与。
com.example.rankingplugin.bingobingo/AnimaTreeProgressService.javaclassAnimaツリーの現在階/最大階を管理し、節目で報酬付与。 - 10Fごと:通貨報酬 - 100F到達:JACKPOTスコア加算(一度到達したら毎回ではなく到達時に付与) 表示は常に 3 段構成。 下段=現在階、中段=次階、上段=次々階。 現在階ヒット時は、連続して事前ヒットしている上位階の数だけまとめて上昇する。
Animaツリーの現在階/最大階を管理し、節目で報酬付与。bingo パッケージの中でも 663 行規模の中核クラスで、運用中の主ループ・永続化境界・スケジューラが一か所に集まっています。中規模クラス群の中では変更影響が広く、章立てで読む価値が高いため重点解説へ追加しています。
AnimaTreeProgressServiceensureTableensurePairloadPairFromDbrenderSidebaronBingoNumbersavePairToDbupdateCurrentFloorkey初期テーブル、依存状態、定期処理の点灯など、このクラスが動き始める前提をまとめています。
外部から呼ばれる公開メソッドや、対象プレイヤー・対象データ・対象ワールドを引き当てる経路です。
イベント受理、定期監視、判定、進行更新など、実際に挙動を生む中心ロジックです。
メモリ状態と保存状態を揃え、結果を次の呼び出しや画面表示へ繋ぐ部分です。
DB テーブルとの境界です。スキーマ変更や保存漏れの切り分けはここから行います。
このクラスが前提状態を揃え、外部から利用可能な形まで立ち上がる流れです。新規依存の追加や起動失敗の調査はまずここから追います。
イベント受理、判定、状態更新、通知までの主経路です。体感不具合や想定外の分岐はこの流れのどこで止まるかを見ると切り分けやすいです。
結果を保持し、必要なら永続化し、最後に掃除まで行う出口です。画面更新だけ合って保存が壊れるケースや残骸が残るケースの確認に向きます。
SQL 文字列から抽出できた主要テーブルです。スキーマ変更時の確認用です。
| Signature | 説明 | 主要呼び出し |
|---|---|---|
public AnimaTreeProgressService(JavaPlugin plugin, DataSource ds, CurrencyService currencyService, ScoreService scoreService, String serverId) | 依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 | ensureTable |
| Name | Visibility | Kind | 説明 |
|---|---|---|---|
| key | private | メソッド | key の主要処理を担当します。 |
| AnimaTreeProgressService | public | コンストラクタ | 依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 |
| ensureTable | private | メソッド | 必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。 |
| runAlterIgnoreExpected | private | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| isIgnorableSqlError | private | メソッド | 条件判定を行い、後続処理の分岐に使える真偽値を返します。 |
| sqlErrorSummary | private | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| toCsv | private | メソッド | toCsv の主要処理を担当します。 |
| fromCsv | private | メソッド | fromCsv の主要処理を担当します。 |
| loadPairFromDb | private | メソッド | 必要な状態を取得し、呼び出し側で利用しやすい形へ返します。 |
| savePairToDb | private | メソッド | 状態を永続化または更新し、最新状態へ反映します。 |
| ensurePair | private | メソッド | 必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。 |
| onBingoNumber | public | メソッド | onBingoNumber の主要処理を担当します。 |
| renderSidebar | public | メソッド | 表示用または出力用のデータを組み立てます。 |
| computeAdvanceSteps | private | メソッド | computeAdvanceSteps の主要処理を担当します。 |
| advanceWindow | private | メソッド | advanceWindow の主要処理を担当します。 |
| fmtRowColored | private | メソッド | fmtRowColored の主要処理を担当します。 |
| rollNonOverlappingTriplet | public | メソッド | rollNonOverlappingTriplet の主要処理を担当します。 |
| sanitizeTriplet | public | メソッド | sanitizeTriplet の主要処理を担当します。 |
| normalizeTargets | private | メソッド | normalizeTargets の主要処理を担当します。 |
| fillDistinctPreserving | private | メソッド | fillDistinctPreserving の主要処理を担当します。 |
| drawDistinctExcluding | private | メソッド | drawDistinctExcluding の主要処理を担当します。 |
| isFloorHit | private | メソッド | 条件判定を行い、後続処理の分岐に使える真偽値を返します。 |
| trimHits | private | メソッド | trimHits の主要処理を担当します。 |
| union | private | メソッド | union の主要処理を担当します。 |
| sortedCopy | private | メソッド | sortedCopy の主要処理を担当します。 |
| refreshSidebarSoon | private | メソッド | refreshSidebarSoon の主要処理を担当します。 |
| getFloors | public | メソッド | 必要な状態を取得し、呼び出し側で利用しやすい形へ返します。 |
| updateCurrentFloor | public | メソッド | 状態を永続化または更新し、最新状態へ反映します。 |
| resetCurrentFloor | public | メソッド | DB への問い合わせまたは更新処理を担当します。 |
private String key(Player p)key の主要処理を担当します。
Player pなし
public AnimaTreeProgressService(JavaPlugin plugin, DataSource ds, CurrencyService currencyService, ScoreService scoreService, String serverId)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
JavaPlugin pluginDataSource dsCurrencyService currencyServiceScoreService scoreServiceString serverIdなし
private void ensureTable()必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
なし
private void runAlterIgnoreExpected(Statement st, String sql, String label, int... ignorableErrorCodes)DB への問い合わせまたは更新処理を担当します。
Statement stString sqlString labelint... ignorableErrorCodesなし
private boolean isIgnorableSqlError(SQLException e, int... ignorableErrorCodes)条件判定を行い、後続処理の分岐に使える真偽値を返します。
SQLException eint... ignorableErrorCodesなし
private String sqlErrorSummary(SQLException e)DB への問い合わせまたは更新処理を担当します。
SQLException eなし
private static String toCsv(Collection<Integer> src)toCsv の主要処理を担当します。
Collection<Integer> srcなし
private static LinkedHashSet<Integer> fromCsv(String s)fromCsv の主要処理を担当します。
String sなし
private Pair loadPairFromDb(String player)必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
String playerなし
private void savePairToDb(String player, Pair s)状態を永続化または更新し、最新状態へ反映します。
String playerPair sなし
private Pair ensurePair(Player p)必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
Player pなし
public void onBingoNumber(Player player, int number)onBingoNumber の主要処理を担当します。
Player playerint numberなし
public List<String> renderSidebar(Player p)表示用または出力用のデータを組み立てます。
Player pなし
private int computeAdvanceSteps(Pair s)computeAdvanceSteps の主要処理を担当します。
Pair sなし
private void advanceWindow(Pair s, int inc)advanceWindow の主要処理を担当します。
Pair sint incなし
private String fmtRowColored(Set<Integer> targets, Set<Integer> hits, ChatColor rowColor)fmtRowColored の主要処理を担当します。
Set<Integer> targetsSet<Integer> hitsChatColor rowColorなし
public TreeTriplet rollNonOverlappingTriplet()rollNonOverlappingTriplet の主要処理を担当します。
なし
public TreeTriplet sanitizeTriplet(Set<Integer> floor1, Set<Integer> floor2, Set<Integer> floor3)sanitizeTriplet の主要処理を担当します。
Set<Integer> floor1Set<Integer> floor2Set<Integer> floor3なし
private LinkedHashSet<Integer> normalizeTargets(Set<Integer> src)normalizeTargets の主要処理を担当します。
Set<Integer> srcなし
private LinkedHashSet<Integer> fillDistinctPreserving(Set<Integer> src, Set<Integer> exclude, int count)fillDistinctPreserving の主要処理を担当します。
Set<Integer> srcSet<Integer> excludeint countなし
private LinkedHashSet<Integer> drawDistinctExcluding(Set<Integer> exclude, int count)drawDistinctExcluding の主要処理を担当します。
Set<Integer> excludeint countなし
private static boolean isFloorHit(Set<Integer> hits)条件判定を行い、後続処理の分岐に使える真偽値を返します。
Set<Integer> hitsなし
private static Set<Integer> trimHits(Set<Integer> hits, Set<Integer> targets)trimHits の主要処理を担当します。
Set<Integer> hitsSet<Integer> targetsなし
private static LinkedHashSet<Integer> union(Set<Integer>... sets)union の主要処理を担当します。
Set<Integer>... setsなし
private static List<Integer> sortedCopy(Set<Integer> src)sortedCopy の主要処理を担当します。
Set<Integer> srcなし
private void refreshSidebarSoon(Player player)refreshSidebarSoon の主要処理を担当します。
Player playerなし
public FloorPair getFloors(String player)必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
String playerなし
public void updateCurrentFloor(Player player, int newCurrent)状態を永続化または更新し、最新状態へ反映します。
Player playerint newCurrentなし
public void resetCurrentFloor(Player player)DB への問い合わせまたは更新処理を担当します。
Player playerなし
AnimaTreeProgressService → ensureTableonBingoNumber → ensurePair → contains → savePairToDb → getName → computeAdvanceStepsloadPairFromDb → getConnection → prepareStatement → setString → executeQuery → nextsavePairToDb → getConnection → prepareStatement → anima_tree_progress → setString → toCsvupdateCurrentFloor → requireNonNull → getName → getConnection → setAutoCommit → prepareStatementensureTable → getConnection → createStatement → executeUpdate → anima_tree_progress → runAlterIgnoreExpected