Class: RingRoadTask

Ring Road Task を担当するclassです。

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

クラス説明

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

責務と見どころ

重点クラスの詳細解説

Ring Road Task を担当するclassです。fantasy.task パッケージの 小規模クラスで、スケジューラを確認する起点です。全面展開版では、他の重点クラスと同じ章立てで読めるように補強しています。

最初に追う読む順番

  1. RingRoadTask
    依存オブジェクトと初期状態を束ね、このクラスが担当するランタイムの前提を固めます。
  2. offerUnique
    offerUnique の主要処理を担当します。
  3. step
    step の主要処理を担当します。
  4. isDone
    条件判定を行い、後続処理の分岐に使える真偽値を返します。

内部サブシステムの地図

起動・前提準備

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

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

代表フロー詳解

初期化と起動の流れ

  1. RingRoadTask

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

通常運用の中心フロー

  1. RingRoadTask
  2. offerUnique
  3. step
  4. isDone

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

反映・保存・終了の流れ

  1. RingRoadTask
  2. offerUnique
  3. step
  4. isDone

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

変更時の注意点

  • 公開メソッドと内部補助メソッドの責務境界を保つと読みやすさが落ちにくく、後から責務分割しやすくなります。

フィールド

VisibilityTypeName役割
privateWorldww の状態を保持します。
privateQueue<BlockOp>opsops の状態を保持します。
privatebooleandonedone の状態を保持します。
privateBlockData roadD, curbD, railD,lightDlightD の状態を保持します。

コンストラクタ / 初期化

Signature説明主要呼び出し
public RingRoadTask(Location center, int radius, int width)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。主要呼び出しなし
public RingRoadTask(Location center, int radius, int width, Material road, Material curb, Material rail, Material light)依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。getWorld → createBlockData → getBlockY → getBlockX → getBlockZ → max

メソッド索引

NameVisibilityKind説明
RingRoadTaskpublicコンストラクタ依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
RingRoadTaskpublicコンストラクタ依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
offerUniqueprivateメソッドofferUnique の主要処理を担当します。
steppublicメソッドstep の主要処理を担当します。
isDonepublicメソッド条件判定を行い、後続処理の分岐に使える真偽値を返します。

メソッド詳細

RingRoadTask

コンストラクタpublic
public RingRoadTask(Location center, int radius, int width)

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

引数

  • Location center
  • int radius
  • int width

throws

なし

主要な呼び出し順

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

RingRoadTask

コンストラクタpublic
public RingRoadTask(Location center, int radius, int width, Material road, Material curb, Material rail, Material light)

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

引数

  • Location center
  • int radius
  • int width
  • Material road
  • Material curb
  • Material rail
  • Material light

throws

なし

主要な呼び出し順

getWorldcreateBlockDatagetBlockYgetBlockXgetBlockZmaxroundcos

offerUnique

メソッドprivate
private void offerUnique(Set<Long> set, int x, int y, int z, BlockData bd)

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

引数

  • Set<Long> set
  • int x
  • int y
  • int z
  • BlockData bd

throws

なし

主要な呼び出し順

offer

step

メソッドpublic
public int step(int budget)

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

引数

  • int budget

throws

なし

主要な呼び出し順

isEmptypollgetBlockAtsetBlockData

isDone

メソッドpublic
public boolean isDone()

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

引数

  • 引数なし

throws

なし

主要な呼び出し順

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

代表的な処理フロー

  1. 初期化フロー
    RingRoadTask → getWorld → createBlockData → getBlockY → getBlockX → getBlockZ
    依存オブジェクトや初期状態を受け取り、このクラスの動作を開始できる状態へ組み立てます。
  2. step フロー
    step → isEmpty → poll → getBlockAt → setBlockData
    step の主要処理を担当します。
  3. offerUnique フロー
    offerUnique → offer
    offerUnique の主要処理を担当します。

外部との接点

Web ルート

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

SQL / テーブル

テーブル名の抽出はありませんでした。

関連クラス

補足