Class: TradeMailDao

/rp trade で送った「オフライン配送アイテム」を保存するDAO。

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

クラス説明

/rp trade で送った「オフライン配送アイテム」を保存するDAO。

- 受け取り完了したら DELETE します（未読/既読フラグは持たないシンプル構成）。
- 複数サーバーが同じDBを共有している場合、サーバーを跨いで受け取り可能です。

責務と見どころ

重点クラスの詳細解説

/rp trade で送った「オフライン配送アイテム」を保存するDAO。trade パッケージの 小〜中規模クラスで、永続化境界を確認する起点です。全面展開版では、他の重点クラスと同じ章立てで読めるように補強しています。

最初に追う読む順番

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

内部サブシステムの地図

起動・前提準備

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

主なメソッド
TradeMailDao initTable
主なフィールド
ds

入口 API と対象解決

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

主なメソッド
loadMail
主なフィールド
ds

状態反映と永続化

メモリ状態と保存状態を揃え、結果を次の呼び出しや画面表示へ繋ぐ部分です。

主なメソッド
insertMail deleteMail
主なフィールド
ds

永続化と状態同期

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

主なメソッド
insertMail loadMail deleteMail
主なフィールド
なし

代表フロー詳解

初期化と起動の流れ

  1. TradeMailDao
  2. initTable
  3. loadMail

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

通常運用の中心フロー

  1. insertMail
  2. deleteMail

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

反映・保存・終了の流れ

  1. insertMail
  2. deleteMail

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

変更時の注意点

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

外部接点

主な永続化テーブル

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

rp_trade_mail

フィールド

VisibilityTypeName役割
privateDataSourcedsDB 接続元を保持します。

コンストラクタ / 初期化

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

メソッド索引

NameVisibilityKind説明
TradeMailDaopublicコンストラクタ依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
initTableprivateメソッド初期化と各種登録を行い、機能を有効化します。
insertMailpublicメソッド状態を永続化または更新し、最新状態へ反映します。
countMailspublicメソッドDB への問い合わせまたは更新処理を担当します。
listMailspublicメソッドDB への問い合わせまたは更新処理を担当します。
loadMailpublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
deleteMailpublicメソッド対象データや登録状態を削除・解除します。

メソッド詳細

TradeMailDao

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

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

引数

  • DataSource ds

throws

なし

主要な呼び出し順

initTable

initTable

メソッドprivate
private void initTable()

初期化と各種登録を行い、機能を有効化します。

引数

  • 引数なし

throws

なし

主要な呼び出し順

getConnectioncreateStatementexecuteUpdaterp_trade_mailidx_receiver_createdprintStackTrace

insertMail

メソッドpublic
public long insertMail(String receiverName, String senderName, String payloadBase64, int itemCount) throws SQLException

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

引数

  • String receiverName
  • String senderName
  • String payloadBase64
  • int itemCount

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementrp_trade_mailsetStringsetIntexecuteUpdategetGeneratedKeysnext

countMails

メソッドpublic
public int countMails(String receiverName) throws SQLException

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

引数

  • String receiverName

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementsetStringexecuteQuerynextgetInt

listMails

メソッドpublic
public List<MailHeader> listMails(String receiverName, int limit, int offset) throws SQLException

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

引数

  • String receiverName
  • int limit
  • int offset

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementsetStringsetIntexecuteQuerynextgetLonggetString

loadMail

メソッドpublic
public Mail loadMail(long id, String receiverName) throws SQLException

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

引数

  • long id
  • String receiverName

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementsetLongsetStringexecuteQuerynextgetLonggetString

deleteMail

メソッドpublic
public boolean deleteMail(long id, String receiverName) throws SQLException

対象データや登録状態を削除・解除します。

引数

  • long id
  • String receiverName

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementsetLongsetStringexecuteUpdate

代表的な処理フロー

  1. 初期化フロー
    TradeMailDao → initTable
    依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
  2. loadMail フロー
    loadMail → getConnection → prepareStatement → setLong → setString → executeQuery
    必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
  3. initTable フロー
    initTable → getConnection → createStatement → executeUpdate → rp_trade_mail → idx_receiver_created
    初期化と各種登録を行い、機能を有効化します。
  4. insertMail フロー
    insertMail → getConnection → prepareStatement → rp_trade_mail → setString → setInt
    状態を永続化または更新し、最新状態へ反映します。
  5. listMails フロー
    listMails → getConnection → prepareStatement → setString → setInt → executeQuery
    DB への問い合わせまたは更新処理を担当します。
  6. countMails フロー
    countMails → getConnection → prepareStatement → setString → executeQuery → next
    DB への問い合わせまたは更新処理を担当します。

外部との接点

Web ルート

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

SQL / テーブル

rp_trade_mail

関連クラス

補足