Animaツリーの現在階/最大階を管理し、節目で報酬付与。

15Fields
1Constructors
29Methods
663Lines
Package
com.example.rankingplugin.bingo
Source
bingo/AnimaTreeProgressService.java
Kind
class
Roles
DB / 永続化非同期 / スケジューラ初期化 / ブートストラップサービス層
このクラスにも章立て解説を追加しています。 自動抽出の一覧だけでなく、下の『重点クラスの詳細解説』で読む順番・内部サブシステム・変更時の注意点まで追えます。 全クラス章立てガイドを見る

クラス説明

Animaツリーの現在階/最大階を管理し、節目で報酬付与。
- 10Fごと:通貨報酬
- 100F到達:JACKPOTスコア加算(一度到達したら毎回ではなく到達時に付与)

表示は常に 3 段構成。
下段=現在階、中段=次階、上段=次々階。
現在階ヒット時は、連続して事前ヒットしている上位階の数だけまとめて上昇する。

責務と見どころ

重点クラスの詳細解説

Animaツリーの現在階/最大階を管理し、節目で報酬付与。bingo パッケージの中でも 663 行規模の中核クラスで、運用中の主ループ・永続化境界・スケジューラが一か所に集まっています。中規模クラス群の中では変更影響が広く、章立てで読む価値が高いため重点解説へ追加しています。

最初に追う読む順番

  1. AnimaTreeProgressService
    依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。
  2. ensureTable
    不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
  3. ensurePair
    不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
  4. loadPairFromDb
    実体や対象状態を作る段階で、後続フローがどのデータを前提に動くかを掴めます。
  5. renderSidebar
    表示用または出力用のデータを組み立てます。
  6. onBingoNumber
    運用中の中心ループです。イベント受理から状態更新までの主経路を追えます。
  7. savePairToDb
    結果を反映・永続化する境界です。表示だけ直って保存が壊れる系の切り分けに向きます。
  8. updateCurrentFloor
    結果を反映・永続化する境界です。表示だけ直って保存が壊れる系の切り分けに向きます。
  9. key
    key の主要処理を担当します。

内部サブシステムの地図

代表フロー詳解

通常運用の中心フロー

  1. onBingoNumber
  2. savePairToDb
  3. updateCurrentFloor

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

反映・保存・終了の流れ

  1. savePairToDb
  2. updateCurrentFloor

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

変更時の注意点

外部接点

主な永続化テーブル

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

anima_tree_progressplayer_name

フィールド

VisibilityTypeName役割
privateJavaPluginpluginプラグイン本体参照です。
privateDataSourcedsDB 接続元を保持します。
privateCurrencyServicecurrencyService関連サービスへの参照です。
privateScoreServicescoreService関連サービスへの参照です。
privateStringserverIdserverId の状態を保持します。
privatelongCURRENCY_PER_10FCURRENCY_PER_10F の状態を保持します。
privatelongJACKPOT_SCOREJACKPOT_SCORE の状態を保持します。
privateintTREE_MINTREE_MIN の状態を保持します。
privateintTREE_MAXTREE_MAX の状態を保持します。
privateintNUMBERS_PER_FLOORNUMBERS_PER_FLOOR の状態を保持します。
privatelongFLOOR_CACHE_TTL_MSキャッシュまたは直近計算結果を保持します。
privatelongADVANCE_DELAY_TICKSADVANCE_DELAY_TICKS の状態を保持します。
privateRandomtreeRndtreeRnd の状態を保持します。
privateConcurrentHashMap<String, Pair>sessionsession の状態を保持します。
privateConcurrentHashMap<String, FloorCache>floorCacheキャッシュまたは直近計算結果を保持します。

コンストラクタ / 初期化

Signature説明主要呼び出し
public AnimaTreeProgressService(JavaPlugin plugin, DataSource ds, CurrencyService currencyService, ScoreService scoreService, String serverId)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。ensureTable

メソッド索引

NameVisibilityKind説明
keyprivateメソッドkey の主要処理を担当します。
AnimaTreeProgressServicepublicコンストラクタ依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
ensureTableprivateメソッド必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
runAlterIgnoreExpectedprivateメソッドDB への問い合わせまたは更新処理を担当します。
isIgnorableSqlErrorprivateメソッド条件判定を行い、後続処理の分岐に使える真偽値を返します。
sqlErrorSummaryprivateメソッドDB への問い合わせまたは更新処理を担当します。
toCsvprivateメソッドtoCsv の主要処理を担当します。
fromCsvprivateメソッドfromCsv の主要処理を担当します。
loadPairFromDbprivateメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
savePairToDbprivateメソッド状態を永続化または更新し、最新状態へ反映します。
ensurePairprivateメソッド必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
onBingoNumberpublicメソッドonBingoNumber の主要処理を担当します。
renderSidebarpublicメソッド表示用または出力用のデータを組み立てます。
computeAdvanceStepsprivateメソッドcomputeAdvanceSteps の主要処理を担当します。
advanceWindowprivateメソッドadvanceWindow の主要処理を担当します。
fmtRowColoredprivateメソッドfmtRowColored の主要処理を担当します。
rollNonOverlappingTripletpublicメソッドrollNonOverlappingTriplet の主要処理を担当します。
sanitizeTripletpublicメソッドsanitizeTriplet の主要処理を担当します。
normalizeTargetsprivateメソッドnormalizeTargets の主要処理を担当します。
fillDistinctPreservingprivateメソッドfillDistinctPreserving の主要処理を担当します。
drawDistinctExcludingprivateメソッドdrawDistinctExcluding の主要処理を担当します。
isFloorHitprivateメソッド条件判定を行い、後続処理の分岐に使える真偽値を返します。
trimHitsprivateメソッドtrimHits の主要処理を担当します。
unionprivateメソッドunion の主要処理を担当します。
sortedCopyprivateメソッドsortedCopy の主要処理を担当します。
refreshSidebarSoonprivateメソッドrefreshSidebarSoon の主要処理を担当します。
getFloorspublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
updateCurrentFloorpublicメソッド状態を永続化または更新し、最新状態へ反映します。
resetCurrentFloorpublicメソッドDB への問い合わせまたは更新処理を担当します。

メソッド詳細

key

メソッドprivate
private String key(Player p)

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

引数

throws

なし

主要な呼び出し順

getName

AnimaTreeProgressService

コンストラクタpublic
public AnimaTreeProgressService(JavaPlugin plugin, DataSource ds, CurrencyService currencyService, ScoreService scoreService, String serverId)

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

引数

throws

なし

主要な呼び出し順

ensureTable

ensureTable

メソッドprivate
private void ensureTable()

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

引数

throws

なし

主要な呼び出し順

getConnectioncreateStatementexecuteUpdateanima_tree_progressrunAlterIgnoreExpectedprepareStatementsetStringgetLogger

runAlterIgnoreExpected

メソッドprivate
private void runAlterIgnoreExpected(Statement st, String sql, String label, int... ignorableErrorCodes)

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

引数

throws

なし

主要な呼び出し順

executeUpdateisIgnorableSqlErrorgetLoggerseveresqlErrorSummary

isIgnorableSqlError

メソッドprivate
private boolean isIgnorableSqlError(SQLException e, int... ignorableErrorCodes)

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

引数

throws

なし

主要な呼び出し順

getErrorCode

sqlErrorSummary

メソッドprivate
private String sqlErrorSummary(SQLException e)

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

引数

throws

なし

主要な呼び出し順

getMessagegetSQLStategetErrorCode

toCsv

メソッドprivatestatic
private static String toCsv(Collection<Integer> src)

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

引数

throws

なし

主要な呼び出し順

isEmptystreamsortedmapcollectjoining

fromCsv

メソッドprivatestatic
private static LinkedHashSet<Integer> fromCsv(String s)

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

引数

throws

なし

主要な呼び出し順

isBlanksplitparseInttrim

loadPairFromDb

メソッドprivate
private Pair loadPairFromDb(String player)

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

引数

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetStringexecuteQuerynextfromCsvgetStringgetInt

savePairToDb

メソッドprivate
private void savePairToDb(String player, Pair s)

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

引数

throws

なし

主要な呼び出し順

getConnectionprepareStatementanima_tree_progresssetStringtoCsvsetIntisFloorHitexecuteUpdate

ensurePair

メソッドprivate
private Pair ensurePair(Player p)

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

引数

throws

なし

主要な呼び出し順

computeIfAbsentkeyloadPairFromDbgetNamerollNonOverlappingTripletsavePairToDb

onBingoNumber

メソッドpublic
public void onBingoNumber(Player player, int number)

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

引数

throws

なし

主要な呼び出し順

ensurePaircontainssavePairToDbgetNamecomputeAdvanceStepsgetSchedulerrunTaskLatergetFloors

renderSidebar

メソッドpublic
public List<String> renderSidebar(Player p)

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

引数

throws

なし

主要な呼び出し順

ensurePairgetFloorsgetNamemaxcurrentfmtRowColoredlengthsubstring

computeAdvanceSteps

メソッドprivate
private int computeAdvanceSteps(Pair s)

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

引数

throws

なし

主要な呼び出し順

isFloorHit

advanceWindow

メソッドprivate
private void advanceWindow(Pair s, int inc)

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

引数

throws

なし

主要な呼び出し順

rollNonOverlappingTriplettrimHitsdrawDistinctExcludingunion

fmtRowColored

メソッドprivate
private String fmtRowColored(Set<Integer> targets, Set<Integer> hits, ChatColor rowColor)

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

引数

throws

なし

主要な呼び出し順

sortedCopyappendcontainstoString

rollNonOverlappingTriplet

メソッドpublic
public TreeTriplet rollNonOverlappingTriplet()

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

引数

throws

なし

主要な呼び出し順

drawDistinctExcludingemptySetunion

sanitizeTriplet

メソッドpublic
public TreeTriplet sanitizeTriplet(Set<Integer> floor1, Set<Integer> floor2, Set<Integer> floor3)

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

引数

throws

なし

主要な呼び出し順

fillDistinctPreservingnormalizeTargetsemptySetunion

normalizeTargets

メソッドprivate
private LinkedHashSet<Integer> normalizeTargets(Set<Integer> src)

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

引数

throws

なし

主要な呼び出し順

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

fillDistinctPreserving

メソッドprivate
private LinkedHashSet<Integer> fillDistinctPreserving(Set<Integer> src, Set<Integer> exclude, int count)

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

引数

throws

なし

主要な呼び出し順

containssizeshuffle

drawDistinctExcluding

メソッドprivate
private LinkedHashSet<Integer> drawDistinctExcluding(Set<Integer> exclude, int count)

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

引数

throws

なし

主要な呼び出し順

containsshuffleminsizesubList

isFloorHit

メソッドprivatestatic
private static boolean isFloorHit(Set<Integer> hits)

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

引数

throws

なし

主要な呼び出し順

isEmpty

trimHits

メソッドprivatestatic
private static Set<Integer> trimHits(Set<Integer> hits, Set<Integer> targets)

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

引数

throws

なし

主要な呼び出し順

contains

union

メソッドprivatestatic
private static LinkedHashSet<Integer> union(Set<Integer>... sets)

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

引数

throws

なし

主要な呼び出し順

addAll

sortedCopy

メソッドprivatestatic
private static List<Integer> sortedCopy(Set<Integer> src)

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

引数

throws

なし

主要な呼び出し順

emptySetsort

refreshSidebarSoon

メソッドprivate
private void refreshSidebarSoon(Player player)

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

引数

throws

なし

主要な呼び出し順

isOnlinegetScoreManagergetSchedulerrunTaskrefreshBingoAndTreeNow

getFloors

メソッドpublic
public FloorPair getFloors(String player)

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

引数

throws

なし

主要な呼び出し順

currentTimeMillisgetConnectionprepareStatementanima_tree_progresssetStringexecuteUpdateexecuteQuerynext

updateCurrentFloor

メソッドpublic
public void updateCurrentFloor(Player player, int newCurrent)

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

引数

throws

なし

主要な呼び出し順

requireNonNullgetNamegetConnectionsetAutoCommitprepareStatementsetStringexecuteQuerynext

resetCurrentFloor

メソッドpublic
public void resetCurrentFloor(Player player)

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

引数

throws

なし

主要な呼び出し順

getNamemaxgetConnectionprepareStatementsetStringexecuteUpdatecurrentTimeMillisrefreshSidebarSoon

代表的な処理フロー

  1. 初期化フロー
    AnimaTreeProgressService → ensureTable
    依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
  2. onBingoNumber フロー
    onBingoNumber → ensurePair → contains → savePairToDb → getName → computeAdvanceSteps
    onBingoNumber の主要処理を担当します。
  3. loadPairFromDb フロー
    loadPairFromDb → getConnection → prepareStatement → setString → executeQuery → next
    必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
  4. savePairToDb フロー
    savePairToDb → getConnection → prepareStatement → anima_tree_progress → setString → toCsv
    状態を永続化または更新し、最新状態へ反映します。
  5. updateCurrentFloor フロー
    updateCurrentFloor → requireNonNull → getName → getConnection → setAutoCommit → prepareStatement
    状態を永続化または更新し、最新状態へ反映します。
  6. ensureTable フロー
    ensureTable → getConnection → createStatement → executeUpdate → anima_tree_progress → runAlterIgnoreExpected
    必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。

外部との接点

Web ルート

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

SQL / テーブル

anima_tree_progressplayer_name

関連クラス

補足