Class: Migrations

Migrations を担当するclassです。

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

クラス説明

クラス直前の Javadoc は見つかりませんでした。ソースとメソッド構成から責務を補完しています。

責務と見どころ

重点クラスの詳細解説

Migrations を担当するclassです。webcoop パッケージの 小〜中規模クラスで、責務境界の要点を確認する起点です。全面展開版では、他の重点クラスと同じ章立てで読めるように補強しています。

最初に追う読む順番

  1. ensure
    不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
  2. runDdlIgnoreExpected
    DB への問い合わせまたは更新処理を担当します。
  3. isIgnorable
    条件判定を行い、後続処理の分岐に使える真偽値を返します。
  4. sqlErrorSummary
    DB への問い合わせまたは更新処理を担当します。

内部サブシステムの地図

起動・前提準備

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

主なメソッド
ensure
主なフィールド
なし

代表フロー詳解

初期化と起動の流れ

  1. ensure

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

通常運用の中心フロー

  1. ensure
  2. runDdlIgnoreExpected
  3. isIgnorable
  4. sqlErrorSummary

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

反映・保存・終了の流れ

  1. ensure
  2. runDdlIgnoreExpected
  3. isIgnorable
  4. sqlErrorSummary

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

変更時の注意点

  • DB スキーマと実装が密結合です。列追加や型変更を行うときは ensure / load / save 系をセットで見直し、古いデータとの互換も確認してください。
  • Web 入口を増やすときは、認証・権限・レスポンス形式・キャッシュ更新を一緒に設計すると後戻りが減ります。

外部接点

主な永続化テーブル

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

webcoop_userswebcoop_sessionswebcoop_chatwebcoop_event_levelwebcoop_banwebcoop_scheduleswebcoop_active_eventwebcoop_event_scorewebcoop_place_cooldownwebcoop_admin

フィールド

VisibilityTypeName役割
フィールドは抽出されませんでした。

コンストラクタ / 初期化

Signature説明主要呼び出し
明示コンストラクタは抽出されませんでした。

メソッド索引

NameVisibilityKind説明
ensurepublicメソッド必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
runDdlIgnoreExpectedprivateメソッドDB への問い合わせまたは更新処理を担当します。
isIgnorableprivateメソッド条件判定を行い、後続処理の分岐に使える真偽値を返します。
sqlErrorSummaryprivateメソッドDB への問い合わせまたは更新処理を担当します。

メソッド詳細

ensure

メソッドpublicstatic
public static void ensure(Db db)

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

引数

  • Db db

throws

なし

主要な呼び出し順

getLoggergetNamedsgetConnectioncreateStatementaddBatchwebcoop_userswebcoop_sessions

runDdlIgnoreExpected

メソッドprivatestatic
private static void runDdlIgnoreExpected(Logger log, Statement st, String sql, String label, int... ignorableErrorCodes)

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

引数

  • Logger log
  • Statement st
  • String sql
  • String label
  • int... ignorableErrorCodes

throws

なし

主要な呼び出し順

executeUpdateisIgnorableseveresqlErrorSummary

isIgnorable

メソッドprivatestatic
private static boolean isIgnorable(SQLException e, int... ignorableErrorCodes)

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

引数

  • SQLException e
  • int... ignorableErrorCodes

throws

なし

主要な呼び出し順

getErrorCode

sqlErrorSummary

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

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

引数

  • SQLException e

throws

なし

主要な呼び出し順

getMessagegetSQLStategetErrorCode

代表的な処理フロー

  1. ensure フロー
    ensure → getLogger → getName → ds → getConnection → createStatement
    必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
  2. runDdlIgnoreExpected フロー
    runDdlIgnoreExpected → executeUpdate → isIgnorable → severe → sqlErrorSummary
    DB への問い合わせまたは更新処理を担当します。
  3. sqlErrorSummary フロー
    sqlErrorSummary → getMessage → getSQLState → getErrorCode
    DB への問い合わせまたは更新処理を担当します。
  4. isIgnorable フロー
    isIgnorable → getErrorCode
    条件判定を行い、後続処理の分岐に使える真偽値を返します。

外部との接点

Web ルート

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

SQL / テーブル

webcoop_userswebcoop_sessionswebcoop_chatwebcoop_event_levelwebcoop_banwebcoop_scheduleswebcoop_active_eventwebcoop_event_scorewebcoop_place_cooldownwebcoop_admin

関連クラス

補足