Class: GuildService | RankingPlugin Wiki

Guild Service に関するサービス層・業務処理を担当します。

4Fields

2Constructors

38Methods

785Lines

Package: com.example.rankingplugin.guild
Source: guild/GuildService.java
Kind: class
Roles: DB / 永続化非同期 / スケジューラサービス層

このクラスにも章立て解説を追加しています。 自動抽出の一覧だけでなく、下の『重点クラスの詳細解説』で読む順番・内部サブシステム・変更時の注意点まで追えます。全クラス章立てガイドを見る

クラス説明

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

責務と見どころ

DB / 永続化 — テーブル作成、読込、更新、削除など永続化責務を持ちます。
非同期 / スケジューラ — 重い処理をメインスレッドから切り離し、定期実行も管理します。
サービス層 — 業務ロジックを公開し、呼び出し側の窓口になります。

重点クラスの詳細解説

Guild Service に関するサービス層・業務処理を担当します。guild パッケージの中でも 785 行規模の中核クラスで、永続化境界・スケジューラが一か所に集まっています。中規模クラス群の中では変更影響が広く、章立てで読む価値が高いため重点解説へ追加しています。

最初に追う読む順番

GuildService
依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。
ensureTables
不足テーブル・設定・内部状態を先に揃える入口です。変更を入れる前提条件の確認地点になります。
createGuild
実体や対象状態を作る段階で、後続フローがどのデータを前提に動くかを掴めます。
updateRole
結果を反映・永続化する境界です。表示だけ直って保存が壊れる系の切り分けに向きます。
dispatchGuildCmds
dispatchGuildCmds の主要処理を担当します。
leaveGuild
後片付けと停止の出口です。残骸や再ログイン後の不整合はここを確認します。
addForeignKeyIgnoreErrors
DB への問い合わせまたは更新処理を担当します。
getGuildId
必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getGuild
必要な状態を取得し、呼び出し側で利用しやすい形へ返します。

内部サブシステムの地図

起動・前提準備

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

主なメソッド

GuildService ensureTables

主なフィールド

plugin ds seasonService tz

入口 API と対象解決

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

主なメソッド

getGuildId getGuild getRole createGuild getActiveBuffs getSidebarMode getSidebarKey getSidebarLayout getRankOfGuild getTodayContributionSum

主なフィールド

plugin ds seasonService

状態反映と永続化

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

主なメソッド

updateRole setBanner setTitleKey dispatchGuildCmds grantBuff setSidebarMode setSidebarKey setSidebarLayout

主なフィールド

plugin ds seasonService

終了処理と掃除

停止時やフロー終端で残る実体・タスク・キャッシュを戻す出口です。

主なメソッド

leaveGuild

主なフィールド

なし

永続化と状態同期

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

主なメソッド

ensureTables getGuildId getGuild getRole updateRole setBanner setTitleKey millisUntilNextReset getActiveBuffs getSidebarMode

主なフィールド

なし

代表フロー詳解

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

通常運用の中心フロー

updateRole
setBanner
setTitleKey
dispatchGuildCmds
grantBuff
setSidebarMode
setSidebarKey

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

反映・保存・終了の流れ

updateRole
setBanner
setTitleKey
dispatchGuildCmds
grantBuff
setSidebarMode

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

変更時の注意点

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

外部接点

主な永続化テーブル

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

guildsguild_membersguild_contribguild_progressserver_goalsguild_buffsguild_invitesguild_metaguild_sidebar_prefsmvaluevaluelevel

フィールド

Visibility	Type	Name	役割
`private`	`Plugin`	`plugin`	プラグイン本体参照です。
`private`	`DataSource`	`ds`	DB 接続元を保持します。
`private`	`ZoneId`	`tz`	tz の状態を保持します。
`private`	`SeasonService`	`seasonService`	関連サービスへの参照です。

コンストラクタ / 初期化

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

メソッド索引

Name	Visibility	Kind	説明
GuildService	`public`	コンストラクタ	依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
GuildService	`public`	コンストラクタ	依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
addForeignKeyIgnoreErrors	`private`	メソッド	DB への問い合わせまたは更新処理を担当します。
ensureTables	`public`	メソッド	必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
getGuildId	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getGuild	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getRole	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
createGuild	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
leaveGuild	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
invite	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
acceptInvite	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
promote	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
demote	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
updateRole	`private`	メソッド	状態を永続化または更新し、最新状態へ反映します。
setBanner	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
setTitleKey	`public`	メソッド	setTitleKey の主要処理を担当します。
upsertMeta	`private`	メソッド	DB への問い合わせまたは更新処理を担当します。
dispatchGuildCmds	`private`	メソッド	dispatchGuildCmds の主要処理を担当します。
addContribution	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
scheduleDailyAggregation	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
fireCompletedGoals	`private`	メソッド	DB への問い合わせまたは更新処理を担当します。
millisUntilNextReset	`private`	メソッド	millisUntilNextReset の主要処理を担当します。
grantBuff	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
getActiveBuffs	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getSidebarMode	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
setSidebarMode	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
getSidebarKey	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
setSidebarKey	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
getSidebarLayout	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
setSidebarLayout	`public`	メソッド	DB への問い合わせまたは更新処理を担当します。
getRankOfGuild	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getTodayContributionSum	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getServerGoalTarget	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getTopGuilds	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
getTopContributors	`public`	メソッド	必要な状態を取得し、呼び出し側で利用しやすい形へ返します。
periodStart	`private`	メソッド	periodStart の主要処理を担当します。
bytesToUuid	`private`	メソッド	bytesToUuid の主要処理を担当します。
uuidToBytes	`public`	メソッド	uuidToBytes の主要処理を担当します。

メソッド詳細

GuildService

コンストラクタpublic

public GuildService(Plugin plugin, DataSource ds, ZoneId tz, SeasonService seasonService)

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

引数

Plugin plugin
DataSource ds
ZoneId tz
SeasonService seasonService

throws

なし

主要な呼び出し順

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

GuildService

コンストラクタpublic

public GuildService(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

なし

主要な呼び出し順

guildsguild_membersuk_uuidguild_contribidx_guildidx_ckeyguild_progressserver_goals

getGuildId

メソッドpublic

public Optional<Integer> getGuildId(UUID uuid)

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

引数

UUID uuid

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetBytesuuidToBytesexecuteQuerynextgetIntgetLogger

getGuild

メソッドpublic

public Optional<GuildInfo> getGuild(int guildId)

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

引数

int guildId

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetIntexecuteQuerynextgetIntgetStringgetLogger

getRole

メソッドpublic

public Role getRole(UUID uuid)

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

引数

UUID uuid

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetBytesuuidToBytesexecuteQuerynextvalueOfgetString

createGuild

メソッドpublic

public int createGuild(UUID owner, String name, String tag) throws SQLException

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

引数

UUID owner
String name
String tag

throws

SQLException

主要な呼び出し順

getConnectionsetAutoCommitprepareStatementsetBytesuuidToBytesexecuteQuerynextguilds

leaveGuild

メソッドpublic

public void leaveGuild(UUID player) throws SQLException

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

引数

UUID player

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementsetBytesuuidToBytesexecuteUpdate

invite

メソッドpublic

public void invite(UUID inviter, UUID invitee, Duration ttl) throws SQLException

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

引数

UUID inviter
UUID invitee
Duration ttl

throws

SQLException

主要な呼び出し順

getGuildIdorElsegetRolegetConnectionprepareStatementguild_invitessetIntsetBytes

acceptInvite

メソッドpublic

public void acceptInvite(UUID invitee) throws SQLException

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

引数

UUID invitee

throws

SQLException

主要な呼び出し順

getConnectiongetGuildIdorElseprepareStatementsetBytesuuidToBytesexecuteQuerynext

promote

メソッドpublic

public void promote(UUID actor, UUID target) throws SQLException

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

引数

UUID actor
UUID target

throws

SQLException

主要な呼び出し順

getGuildIdorElseequalsgetRoleupdateRole

demote

メソッドpublic

public void demote(UUID actor, UUID target) throws SQLException

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

引数

UUID actor
UUID target

throws

SQLException

主要な呼び出し順

getGuildIdorElseequalsgetRoleupdateRole

updateRole

メソッドprivate

private void updateRole(int gid, UUID uuid, Role role) throws SQLException

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

引数

int gid
UUID uuid
Role role

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementsetStringnamesetIntsetBytesuuidToBytesexecuteUpdate

setBanner

メソッドpublic

public void setBanner(int guildId, String bannerData) throws SQLException

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

引数

int guildId
String bannerData

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementsetStringsetIntexecuteUpdategetConfiggetStringListgetGuild

setTitleKey

メソッドpublic

public void setTitleKey(int guildId, String titleKey) throws SQLException

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

引数

int guildId
String titleKey

throws

SQLException

主要な呼び出し順

upsertMetagetConfiggetStringListgetGuildorElsedispatchGuildCmds

upsertMeta

メソッドprivate

private void upsertMeta(int guildId, String key, String value) throws SQLException

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

引数

int guildId
String key
String value

throws

SQLException

主要な呼び出し順

getConnectionprepareStatementguild_metasetIntsetStringexecuteUpdate

dispatchGuildCmds

メソッドprivate

private void dispatchGuildCmds(List<String> cmds, GuildInfo g, Map<String,String> extra)

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

引数

List<String> cmds
GuildInfo g
Map<String,String> extra

throws

なし

主要な呼び出し順

replacenametagentrySetgetKeygetValuedispatchCommandgetConsoleSender

addContribution

メソッドpublic

public void addContribution(UUID uuid, String key, int amount)

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

引数

UUID uuid
String key
int amount

throws

なし

主要な呼び出し順

getGuildIdifPresentgetConnectionprepareStatementguild_contribsetIntsetBytesuuidToBytes

scheduleDailyAggregation

メソッドpublic

public void scheduleDailyAggregation()

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

引数

引数なし

throws

なし

主要な呼び出し順

millisUntilNextResetgetSchedulerrunTaskTimerAsynchronouslygetConnectionsetAutoCommitnowwithHourwithMinute

fireCompletedGoals

メソッドprivate

private void fireCompletedGoals()

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

引数

引数なし

throws

なし

主要な呼び出し順

getConnectionprepareStatementexecuteQuerynextgetStringbroadcastMessagegetConfiggetStringList

millisUntilNextReset

メソッドprivate

private long millisUntilNextReset()

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

引数

引数なし

throws

なし

主要な呼び出し順

nowwithHourwithMinutewithSecondwithNanoisAfterplusDaysbetween

grantBuff

メソッドpublic

public void grantBuff(int guildId, String buffKey, int level, Duration duration) throws SQLException

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

引数

int guildId
String buffKey
int level
Duration duration

throws

SQLException

主要な呼び出し順

valueOfnowplustoLocalDateTimegetConnectionprepareStatementguild_buffssetInt

getActiveBuffs

メソッドpublic

public Map<String,Integer> getActiveBuffs(int guildId)

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

引数

int guildId

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetIntexecuteQuerynextgetStringgetIntgetLogger

getSidebarMode

メソッドpublic

public String getSidebarMode(UUID uuid)

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

引数

UUID uuid

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetBytesuuidToBytesexecuteQuerynextgetString

setSidebarMode

メソッドpublic

public void setSidebarMode(UUID uuid, String mode)

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

引数

UUID uuid
String mode

throws

なし

主要な呼び出し順

equalsIgnoreCasegetConnectionprepareStatementguild_sidebar_prefssetBytesuuidToBytessetStringtoLowerCase

getSidebarKey

メソッドpublic

public String getSidebarKey(UUID uuid)

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

引数

UUID uuid

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetBytesuuidToBytesexecuteQuerynextgetString

setSidebarKey

メソッドpublic

public void setSidebarKey(UUID uuid, String key)

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

引数

UUID uuid
String key

throws

なし

主要な呼び出し順

getConnectionprepareStatementguild_sidebar_prefssetBytesuuidToBytessetStringexecuteUpdategetLogger

getSidebarLayout

メソッドpublic

public String getSidebarLayout(UUID uuid)

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

引数

UUID uuid

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetBytesuuidToBytesexecuteQuerynextgetString

setSidebarLayout

メソッドpublic

public void setSidebarLayout(UUID uuid, String layout)

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

引数

UUID uuid
String layout

throws

なし

主要な呼び出し順

equalsIgnoreCasegetConnectionprepareStatementguild_sidebar_prefssetBytesuuidToBytessetStringtoLowerCase

getRankOfGuild

メソッドpublic

public GuildRank getRankOfGuild(int guildId, String key)

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

引数

int guildId
String key

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetStringexecuteQuerynextgetIntgetLonggetString

getTodayContributionSum

メソッドpublic

public long getTodayContributionSum(int guildId, String key)

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

引数

int guildId
String key

throws

なし

主要な呼び出し順

getConnectionprepareStatementnowwithHourwithMinutewithSecondwithNanoisAfter

getServerGoalTarget

メソッドpublic

public long getServerGoalTarget(String key)

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

引数

String key

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetStringexecuteQuerynextgetLong

getTopGuilds

メソッドpublic

public List<GuildTopRow> getTopGuilds(String key, int limit)

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

引数

String key
int limit

throws

なし

主要な呼び出し順

getConnectionprepareStatementsetStringsetIntmaxexecuteQuerynextgetString

getTopContributors

メソッドpublic

public List<MemberTopRow> getTopContributors(int guildId, String key, int limit, String scope)

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

引数

int guildId
String key
int limit
String scope

throws

なし

主要な呼び出し順

valueOfperiodStarttoLocalDateTimegetConnectionprepareStatementsetStringsetTimestampsetInt

periodStart

メソッドprivate

private ZonedDateTime periodStart(String scope)

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

引数

String scope

throws

なし

主要な呼び出し順

nowwithHourwithMinutewithSecondwithNanovalueOftoLowerCaseisAfter

bytesToUuid

メソッドprivatestatic

private static UUID bytesToUuid(byte[] b)

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

引数

byte[] b

throws

なし

主要な呼び出し順

wrapgetLong

uuidToBytes

メソッドpublicstatic

public static byte[] uuidToBytes(UUID u)

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

引数

UUID u

throws

なし

主要な呼び出し順

wrapputLonggetMostSignificantBitsgetLeastSignificantBitsarray

代表的な処理フロー

updateRole フロー
updateRole → getConnection → prepareStatement → setString → name → setInt
状態を永続化または更新し、最新状態へ反映します。
ensureTables フロー
ensureTables → guilds → guild_members → uk_uuid → guild_contrib → idx_guild
必要なテーブル・状態・前提条件が揃っているかを確認し、不足分を補います。
acceptInvite フロー
acceptInvite → getConnection → getGuildId → orElse → prepareStatement → setBytes
DB への問い合わせまたは更新処理を担当します。
addContribution フロー
addContribution → getGuildId → ifPresent → getConnection → prepareStatement → guild_contrib
DB への問い合わせまたは更新処理を担当します。

外部との接点

Web ルート

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

SQL / テーブル

guildsguild_membersguild_contribguild_progressCURRENT_TIMESTAMPserver_goalsguild_buffsguild_invitesguild_metaguild_sidebar_prefsmvaluevaluelevelmodemetric_keylayout

補足

メソッド説明と処理フローは、Javadoc とソース本体の呼び出し列から自動要約しています。
匿名クラスや複雑なラムダ初期化を多用する箇所では、一部のフィールド / 呼び出し順が簡略表示になる場合があります。