Execution Context

ExecutionContextからOperation ID、相関情報、Actor Context、Deferred Attemptを読み取る。

ExecutionContextはOperationの追跡情報を保持するRead-onlyなPublic APIです。Operationが必要とする場合だけTyped Self-handled handle()の第二引数へ指定します。

use BlackOps\Core\ExecutionContext;

public function handle(ProcessPaymentValue $value, ExecutionContext $context): PaymentProcessed
{
    $operationId = $context->operationId();
    $correlationId = $context->correlationId();
    $attempt = $context->attempt();
    $actors = $context->actorContext();

    return new PaymentProcessed($operationId->toString());
}

読み取れる情報

• operationId(): 現在のOperation ID
• receivedAt(): 受付時刻。UTCへ正規化される
• correlationId(): 関連OperationをまとめるCorrelation ID
• causationId(): 原因となるOperationがある場合のID
• attempt(): Deferred Attempt。Inlineではnull
• deadline(): Deadlineが構成されている場合のUTC時刻
• actorContext(): Operationの原因、認可対象、実行主体。Actor未設定の経路ではnull

ContextはFrameworkが生成し、ApplicationはGetterで読み取ります。公開with...() Methodはありません。

Actor Context

ActorContextは「誰が起点か」「誰の権限を評価するか」「どのSystemが実行したか」を分けて保持します。

各ActorはActorRefのid()とtype()だけを持ちます。Password、Session ID、Bearer Token、API Key、Role、Permission、ClaimはExecutionContextやDeferred Transportへ保存しません。Policy等で詳細が必要な場合は、Actor ID／Typeを使ってApplication Serviceから現在の情報を取得します。

Deferred Workerはoriginとauthorizationを維持し、AttemptごとにexecutionだけをWorker System Actorへ置き換えます。Worker Actorはexecution.worker.idをID、systemをTypeとして持ちます。この分離により、User起点の処理をWorkerが実行しても、元Userの権限をWorker自身の権限へ強化しません。

受付時にActorがないOperationでも、Worker Attemptではorigin=null、authorization=null、execution=<worker ID>/systemのActor Contextを持ちます。Policy付きOperationはauthorization ActorがないためHandlerを実行せずRejectedになります。PolicyなしOperationはWorker Actorを監査記録へ残して通常どおり実行します。

RetryとLease Expired Recoveryも受付時のorigin／authorizationと現在のWorker execution Actorを復元します。Retry先のWorker IDが変わればexecution Actorも変わるため、Journalから「誰が要求し、誰の権限で評価し、どのWorkerが各Attemptを実行したか」を区別できます。

Identifierの関係

Identifierは同じUUID値を共有する場合でも別のPHP型です。Operation IDをCorrelation IDやCausation IDの引数へそのまま渡すことはできません。RetryではOperation IDとCorrelation IDを維持し、Attempt IDだけが変わります。

InlineとDeferred

Inline ContextにもOperation IDがありますが、Deferred Claimではないためattempt()はnullです。Deferred Workerでは現在のAttempt Numberや開始情報をAttemptContextから読めます。

OperationがContextを使わない場合は第二引数を省略してください。第一引数は常に具象OperationValueであり、Contextだけを受け取るSignatureはBuildで拒否されます。