起動・前提準備
初期テーブル、依存状態、定期処理の点灯など、このクラスが動き始める前提をまとめています。
主なメソッド
Class: CurrencyServiceImpl
Currency Service Impl を担当するclassです。
4Fields
1Constructors
5Methods
156Lines
- Package
com.example.rankingplugin.currency- Source
currency/CurrencyServiceImpl.java- Kind
class- Roles
- DB / 永続化初期化 / ブートストラップ
このクラスにも章立て解説を追加しています。 自動抽出の一覧だけでなく、下の『重点クラスの詳細解説』で読む順番・内部サブシステム・変更時の注意点まで追えます。 全クラス章立てガイドを見る
クラス説明
クラス直前の Javadoc は見つかりませんでした。ソースとメソッド構成から責務を補完しています。
責務と見どころ
- DB / 永続化 — テーブル作成、読込、更新、削除など永続化責務を持ちます。
- 初期化 / ブートストラップ — 他コンポーネントを組み立て、起動時の全体配線を担います。
重点クラスの詳細解説
Currency Service Impl を担当するclassです。currency パッケージの 小〜中規模クラスで、永続化境界を確認する起点です。全面展開版では、他の重点クラスと同じ章立てで読めるように補強しています。
最初に追う読む順番
CurrencyServiceImpl依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。getBalance必要な状態を取得し、呼び出し側で利用しやすい形へ返します。setBalanceDB への問い合わせまたは更新処理を担当します。addCurrencyDB への問い合わせまたは更新処理を担当します。tryTakeCurrencyDB への問い合わせまたは更新処理を担当します。
内部サブシステムの地図
入口 API と対象解決
外部から呼ばれる公開メソッドや、対象プレイヤー・対象データ・対象ワールドを引き当てる経路です。
主なメソッド
主なフィールド
状態反映と永続化
メモリ状態と保存状態を揃え、結果を次の呼び出しや画面表示へ繋ぐ部分です。
主なメソッド
主なフィールド
永続化と状態同期
DB テーブルとの境界です。スキーマ変更や保存漏れの切り分けはここから行います。
主なメソッド
主なフィールド
代表フロー詳解
初期化と起動の流れ
このクラスが前提状態を揃え、外部から利用可能な形まで立ち上がる流れです。新規依存の追加や起動失敗の調査はまずここから追います。
通常運用の中心フロー
イベント受理、判定、状態更新、通知までの主経路です。体感不具合や想定外の分岐はこの流れのどこで止まるかを見ると切り分けやすいです。
反映・保存・終了の流れ
結果を保持し、必要なら永続化し、最後に掃除まで行う出口です。画面更新だけ合って保存が壊れるケースや残骸が残るケースの確認に向きます。
変更時の注意点
- DB スキーマと実装が密結合です。列追加や型変更を行うときは ensure / load / save 系をセットで見直し、古いデータとの互換も確認してください。
外部接点
主な永続化テーブル
SQL 文字列から抽出できた主要テーブルです。スキーマ変更時の確認用です。
currenciesbalanceplayer_name
フィールド
| Visibility | Type | Name | 役割 |
|---|---|---|---|
private | JavaPlugin | plugin | プラグイン本体参照です。 |
private | DataSource | ds | DB 接続元を保持します。 |
private | String | serverId | serverId の状態を保持します。 |
private | Map<String, Long> | balanceCache | キャッシュまたは直近計算結果を保持します。 |
コンストラクタ / 初期化
| Signature | 説明 | 主要呼び出し |
|---|---|---|
public CurrencyServiceImpl(JavaPlugin plugin, DataSource ds) | 依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 | resolve |
メソッド索引
| Name | Visibility | Kind | 説明 |
|---|---|---|---|
| CurrencyServiceImpl | public | コンストラクタ | 依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 |
| getBalance | public | メソッド | 必要な状態を取得し、呼び出し側で利用しやすい形へ返します。 |
| setBalance | public | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| addCurrency | public | メソッド | DB への問い合わせまたは更新処理を担当します。 |
| tryTakeCurrency | public | メソッド | DB への問い合わせまたは更新処理を担当します。 |
メソッド詳細
CurrencyServiceImpl
public CurrencyServiceImpl(JavaPlugin plugin, DataSource ds)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
引数
JavaPlugin pluginDataSource ds
throws
なし
主要な呼び出し順
resolve
getBalance
public long getBalance(String playerName)必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
引数
String playerName
throws
なし
主要な呼び出し順
isBlankgetConnectionprepareStatementsetStringexecuteQuerynextgetLonggetLogger
setBalance
public void setBalance(String playerName, long playerBalance)DB への問い合わせまたは更新処理を担当します。
引数
String playerNamelong playerBalance
throws
なし
主要な呼び出し順
isBlankmaxgetConnectionprepareStatementcurrenciessetStringsetLongexecuteUpdate
addCurrency
public long addCurrency(String playerName, long amount)DB への問い合わせまたは更新処理を担当します。
引数
String playerNamelong amount
throws
なし
主要な呼び出し順
isBlankgetBalancecurrenciesgetConnectionsetAutoCommitprepareStatementsetStringsetLong
tryTakeCurrency
public boolean tryTakeCurrency(String playerName, long amount)DB への問い合わせまたは更新処理を担当します。
引数
String playerNamelong amount
throws
なし
主要な呼び出し順
isBlankcurrenciesgetConnectionsetAutoCommitprepareStatementsetStringexecuteUpdatesetLong
代表的な処理フロー
- 初期化フロー
CurrencyServiceImpl → resolve依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。 - addCurrency フロー
addCurrency → isBlank → getBalance → currencies → getConnection → setAutoCommitDB への問い合わせまたは更新処理を担当します。 - getBalance フロー
getBalance → isBlank → getConnection → prepareStatement → setString → executeQuery必要な状態を取得し、呼び出し側で利用しやすい形へ返します。 - setBalance フロー
setBalance → isBlank → max → getConnection → prepareStatement → currenciesDB への問い合わせまたは更新処理を担当します。 - tryTakeCurrency フロー
tryTakeCurrency → isBlank → currencies → getConnection → setAutoCommit → prepareStatementDB への問い合わせまたは更新処理を担当します。
外部との接点
Web ルート
このクラス内に目立つ Web ルート定義は見つかりませんでした。
SQL / テーブル
currenciesbalanceplayer_name
関連クラス
- ServerIdResolver (util) — Server Id Resolver を担当するclassです。
補足
- メソッド説明と処理フローは、Javadoc とソース本体の呼び出し列から自動要約しています。
- 匿名クラスや複雑なラムダ初期化を多用する箇所では、一部のフィールド / 呼び出し順が簡略表示になる場合があります。