Class: SeasonService

シーズン旅路の中核サービス。

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

クラス説明

シーズン旅路の中核サービス。

責務と見どころ

重点クラスの詳細解説

シーズン旅路の中核サービス。season パッケージの中でも 693 行規模の中核クラスで、永続化境界・スケジューラが一か所に集まっています。中規模クラス群の中では変更影響が広く、章立てで読む価値が高いため重点解説へ追加しています。

最初に追う読む順番

  1. SeasonService
    依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。
  2. ensureTables
    不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
  3. loadTiers
    実体や対象状態を作る段階で、後続フローがどのデータを前提に動くかを掴めます。
  4. addForeignKeyIgnoreErrors
    DB への問い合わせまたは更新処理を担当します。
  5. seedIfEmpty
    DB への問い合わせまたは更新処理を担当します。
  6. getTaskOverview
    必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
  7. isSidebarEnabled
    条件判定を行い、後続処理の分岐に使える真偽値を返します。
  8. setSidebarEnabled
    DB への問い合わせまたは更新処理を担当します。
  9. bootstrapSchemaAndSeed
    DDL→シードまで一括（便利メソッド）

内部サブシステムの地図

起動・前提準備

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

主なメソッド
SeasonService ensureTables
主なフィールド
plugin ds tz SCORE_KEY

状態反映と永続化

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

主なメソッド
setSidebarEnabled
主なフィールド
plugin ds

非同期処理と定期実行

メインスレッド境界とバックグラウンド処理が交差します。重い処理やタイミング起因の不具合を追うときの要所です。

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

代表フロー詳解

通常運用の中心フロー

  1. setSidebarEnabled

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

反映・保存・終了の流れ

  1. setSidebarEnabled

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

変更時の注意点

  • Bukkit 実体やワールド状態を触る処理はスレッド境界を崩さないようにしてください。重い計算だけを分離し、実体操作は既存の同期経路へ寄せるのが安全です。
  • DB スキーマと実装が密結合です。列追加や型変更を行うときは ensure / load / save 系をセットで見直し、古いデータとの互換も確認してください。

外部接点

主な永続化テーブル

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

seasonsseason_tiersseason_tasksseason_task_progressseason_profilesseason_prefssidebar_enabledcount

フィールド

VisibilityTypeName役割
privatePluginpluginプラグイン本体参照です。
publicDataSourcedsDB 接続元を保持します。
privateZoneIdtztz の状態を保持します。
publicStringSCORE_KEYSCORE_KEY の状態を保持します。

コンストラクタ / 初期化

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

メソッド索引

NameVisibilityKind説明
SeasonServicepublicコンストラクタ依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
addForeignKeyIgnoreErrorsprivateメソッドDB への問い合わせまたは更新処理を担当します。
ensureTablespublicメソッド必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
seedIfEmptypublicメソッドDB への問い合わせまたは更新処理を担当します。
getTaskOverviewpublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
isSidebarEnabledpublicメソッド条件判定を行い、後続処理の分岐に使える真偽値を返します。
setSidebarEnabledpublicメソッドDB への問い合わせまたは更新処理を担当します。
bootstrapSchemaAndSeedpublicメソッドDDL→シードまで一括（便利メソッド）
getActiveSeasonpublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
loadTierspublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getOrCreateProfilepublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
addSeasonPointspublicメソッドDB への問い合わせまたは更新処理を担当します。
claimUpTopublicメソッドDB への問い合わせまたは更新処理を担当します。
addTaskProgresspublicメソッドDB への問い合わせまたは更新処理を担当します。
scheduleResetspublicメソッドデイリー/ウィークリーの定時リセット。
resetTasksprivateメソッドDB への問い合わせまたは更新処理を担当します。
getTaskCountspublicメソッド必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
uuidToBytespublicメソッドuuidToBytes の主要処理を担当します。

メソッド詳細

SeasonService

コンストラクタpublic
public SeasonService(Plugin plugin, DataSource ds, ZoneId tz)

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

引数

  • Plugin plugin
  • DataSource ds
  • ZoneId tz

throws

なし

主要な呼び出し順

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

addForeignKeyIgnoreErrors

メソッドprivate
private void addForeignKeyIgnoreErrors(Connection c, String sql, String label)

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

引数

  • Connection c
  • String sql
  • String label

throws

なし

主要な呼び出し順

createStatementexecuteUpdategetLoggerinfovalueOfgetMessagecontainsfine

ensureTables

メソッドpublic
public void ensureTables()

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

引数

  • 引数なし

throws

なし

主要な呼び出し順

seasonsseason_tiersidx_seasonseason_tasksuk_taskseason_task_progressidx_taskseason_profiles

seedIfEmpty

メソッドpublic
public void seedIfEmpty()

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

引数

  • 引数なし

throws

なし

主要な呼び出し順

getConnectionprepareStatementexecuteQuerynextgetIntnowplusMonthswithDayOfMonth

getTaskOverview

メソッドpublic
public List<TaskOverview> getTaskOverview(UUID uuid, int seasonId, String kind, int limit)

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

引数

  • UUID uuid
  • int seasonId
  • String kind
  • int limit

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetBytesuuidToBytessetIntsetStringmaxexecuteQuery

isSidebarEnabled

メソッドpublic
public boolean isSidebarEnabled(UUID uuid)

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

引数

  • UUID uuid

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetBytesuuidToBytesexecuteQuerynextgetIntgetLogger

setSidebarEnabled

メソッドpublic
public void setSidebarEnabled(UUID uuid, boolean enabled)

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

引数

  • UUID uuid
  • boolean enabled

throws

なし

主要な呼び出し順

getConnectionprepareStatementseason_prefssetBytesuuidToBytessetIntexecuteUpdategetLogger

bootstrapSchemaAndSeed

メソッドpublic
public void bootstrapSchemaAndSeed()

DDL→シードまで一括（便利メソッド）

引数

  • 引数なし

throws

なし

主要な呼び出し順

ensureTablesseedIfEmpty

getActiveSeason

メソッドpublic
public Optional<Season> getActiveSeason() throws SQLException

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

引数

  • 引数なし

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementexecuteQuerynextgetIntgetStringgetTimestamptoInstant

loadTiers

メソッドpublic
public Map<Integer, Tier> loadTiers(int seasonId) throws SQLException

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

引数

  • int seasonId

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementsetIntexecuteQuerynextgetIntgetString

getOrCreateProfile

メソッドpublic
public Profile getOrCreateProfile(UUID uuid, int seasonId) throws SQLException

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

引数

  • UUID uuid
  • int seasonId

throws

SQLException

主要な呼び出し順

getConnectionuuidToBytesprepareStatementsetBytessetIntexecuteQuerynextgetInt

addSeasonPoints

メソッドpublic
public void addSeasonPoints(Player p, int delta, String reason)

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

引数

  • Player p
  • int delta
  • String reason

throws

なし

主要な呼び出し順

getActiveSeasonisEmptygetConnectionsetAutoCommitgetOrCreateProfilegetUniqueIdidpoints

claimUpTo

メソッドpublic
public ClaimResult claimUpTo(Player p, int targetTier, Consumer<String> runRewardCommand)

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

引数

  • Player p
  • int targetTier
  • Consumer<String> runRewardCommand

throws

なし

主要な呼び出し順

getActiveSeasonisEmptyerrorloadTiersidcontainsKeygetConnectionsetAutoCommit

addTaskProgress

メソッドpublic
public void addTaskProgress(UUID uuid, String taskKey, int delta)

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

引数

  • UUID uuid
  • String taskKey
  • int delta

throws

なし

主要な呼び出し順

getActiveSeasonisEmptygetConnectionsetAutoCommitprepareStatementsetIntidsetString

scheduleResets

メソッドpublic
public void scheduleResets()

デイリー/ウィークリーの定時リセット。

引数

  • 引数なし

throws

なし

主要な呼び出し順

getSchedulerrunTaskTimerAsynchronouslynowgetHourgetMinuteresetTasksgetDayOfWeekprintStackTrace

resetTasks

メソッドprivate
private void resetTasks(String kind) throws SQLException

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

引数

  • String kind

throws

SQLException

主要な呼び出し順

getActiveSeasonisEmptygetConnectionprepareStatementsetIntidsetStringexecuteUpdate

getTaskCounts

メソッドpublic
public TaskCounts getTaskCounts(UUID uuid, int seasonId)

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

引数

  • UUID uuid
  • int seasonId

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetBytesuuidToBytessetIntexecuteQuerynextgetString

uuidToBytes

メソッドpublicstatic
public static byte[] uuidToBytes(UUID u)

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

引数

  • UUID u

throws

なし

主要な呼び出し順

allocateputLonggetMostSignificantBitsgetLeastSignificantBitsarray

代表的な処理フロー

  1. loadTiers フロー
    loadTiers → getConnection → prepareStatement → setInt → executeQuery → next
    必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
  2. ensureTables フロー
    ensureTables → seasons → season_tiers → idx_season → season_tasks → uk_task
    必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
  3. addForeignKeyIgnoreErrors フロー
    addForeignKeyIgnoreErrors → createStatement → executeUpdate → getLogger → info → valueOf
    DB への問い合わせまたは更新処理を担当します。
  4. addSeasonPoints フロー
    addSeasonPoints → getActiveSeason → isEmpty → getConnection → setAutoCommit → getOrCreateProfile
    DB への問い合わせまたは更新処理を担当します。
  5. addTaskProgress フロー
    addTaskProgress → getActiveSeason → isEmpty → getConnection → setAutoCommit → prepareStatement
    DB への問い合わせまたは更新処理を担当します。

外部との接点

Web ルート

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

SQL / テーブル

seasonsCURRENT_TIMESTAMPseason_tiersseason_tasksseason_task_progressseason_profilesseason_prefssidebar_enabledcount

関連クラス

補足