Class: DiscordXpDao

Discord経験値/レベルを保存するDAO。

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

クラス説明

Discord経験値/レベルを保存するDAO。

★ server_id でサーバー単位に切り分け

責務と見どころ

重点クラスの詳細解説

Discord経験値/レベルを保存するDAO。discordxp パッケージの 小〜中規模クラスで、責務境界の要点を確認する起点です。全面展開版では、他の重点クラスと同じ章立てで読めるように補強しています。

最初に追う読む順番

  1. DiscordXpDao
    依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。
  2. ensureTables
    不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
  3. load
    実体や対象状態を作る段階で、後続フローがどのデータを前提に動くかを掴めます。
  4. loadAll
    実体や対象状態を作る段階で、後続フローがどのデータを前提に動くかを掴めます。
  5. tryMigrateLegacy
    DB への問い合わせまたは更新処理を担当します。
  6. upsert
    DB への問い合わせまたは更新処理を担当します。
  7. batchUpsert
    DB への問い合わせまたは更新処理を担当します。

内部サブシステムの地図

起動・前提準備

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

主なメソッド
DiscordXpDao ensureTables
主なフィールド
ds

入口 API と対象解決

外部から呼ばれる公開メソッドや、対象プレイヤー・対象データ・対象ワールドを引き当てる経路です。

主なメソッド
load loadAll
主なフィールド
ds

永続化と状態同期

DB テーブルとの境界です。スキーマ変更や保存漏れの切り分けはここから行います。

主なメソッド
ensureTables load loadAll
主なフィールド
なし

代表フロー詳解

初期化と起動の流れ

  1. DiscordXpDao
  2. ensureTables
  3. load
  4. loadAll

このクラスが前提状態を揃え、外部から利用可能な形まで立ち上がる流れです。新規依存の追加や起動失敗の調査はまずここから追います。

通常運用の中心フロー

  1. DiscordXpDao
  2. ensureTables
  3. load
  4. loadAll
  5. tryMigrateLegacy
  6. upsert

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

反映・保存・終了の流れ

  1. DiscordXpDao
  2. ensureTables
  3. load
  4. loadAll
  5. tryMigrateLegacy

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

変更時の注意点

  • DB スキーマと実装が密結合です。列追加や型変更を行うときは ensure / load / save 系をセットで見直し、古いデータとの互換も確認してください。

外部接点

主な永続化テーブル

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

IFthisxp

フィールド

VisibilityTypeName役割
publicStringTABLE_STATSTABLE_STATS の状態を保持します。
privateDataSourcedsDB 接続元を保持します。

コンストラクタ / 初期化

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

メソッド索引

NameVisibilityKind説明
DiscordXpDaopublicコンストラクタ依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
ensureTablespublicメソッド必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
tryMigrateLegacyprivateメソッドDB への問い合わせまたは更新処理を担当します。
loadpublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
upsertpublicメソッドDB への問い合わせまたは更新処理を担当します。
batchUpsertpublicメソッドDB への問い合わせまたは更新処理を担当します。
loadAllpublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

メソッド詳細

DiscordXpDao

コンストラクタpublic
public DiscordXpDao(DataSource ds)

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

引数

  • DataSource ds

throws

なし

主要な呼び出し順

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

ensureTables

メソッドpublic
public void ensureTables(String serverIdForLegacy) throws SQLException

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

引数

  • String serverIdForLegacy

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementexecutetryMigrateLegacy

tryMigrateLegacy

メソッドprivate
private void tryMigrateLegacy(String serverIdForLegacy)

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

引数

  • String serverIdForLegacy

throws

なし

主要な呼び出し順

getConnectionprepareStatementexecuteQueryexecutesetStringexecuteUpdate

load

メソッドpublic
public Optional<Stats> load(String serverId, UUID uuid) throws SQLException

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

引数

  • String serverId
  • UUID uuid

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementsetStringtoStringexecuteQuerynextemptygetLong

upsert

メソッドpublic
public void upsert(String serverId, UUID uuid, long xp, int level) throws SQLException

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

引数

  • String serverId
  • UUID uuid
  • long xp
  • int level

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementsetStringtoStringsetLongsetIntexecuteUpdate

batchUpsert

メソッドpublic
public void batchUpsert(String serverId, Map<UUID, Stats> stats) throws SQLException

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

引数

  • String serverId
  • Map<UUID, Stats> stats

throws

SQLException

主要な呼び出し順

getConnectionprepareStatemententrySetsetStringgetKeytoStringsetLonggetValue

loadAll

メソッドpublic
public Map<UUID, Stats> loadAll(String serverId) throws SQLException

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

引数

  • String serverId

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementsetStringexecuteQuerynextfromStringgetStringgetLong

代表的な処理フロー

  1. load フロー
    load → getConnection → prepareStatement → setString → toString → executeQuery
    必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
  2. loadAll フロー
    loadAll → getConnection → prepareStatement → setString → executeQuery → next
    必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
  3. ensureTables フロー
    ensureTables → getConnection → prepareStatement → execute → tryMigrateLegacy
    必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
  4. batchUpsert フロー
    batchUpsert → getConnection → prepareStatement → entrySet → setString → getKey
    DB への問い合わせまたは更新処理を担当します。
  5. upsert フロー
    upsert → getConnection → prepareStatement → setString → toString → setLong
    DB への問い合わせまたは更新処理を担当します。

外部との接点

Web ルート

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

SQL / テーブル

IFCURRENT_TIMESTAMPthisxp

関連クラス

補足