Package top.wcpe.beacon.agent.api

Class ScheduleResult

java.lang.Object

top.wcpe.beacon.agent.api.ScheduleResult

public final class ScheduleResult
extends Object

一次 acquireCandidate 的决策结果（FR-148）。

无论控制面在线决策还是降级本地决策，future 均正常完成（fail-static，不因控制面不可达而异常完成）； 调用方以 chosen() 是否为 null 判断本次是否取到候选。

Constructor Summary

Constructors

Constructor	Description
ScheduleResult(CandidateView chosen, String traceId, DecisionSource source, String failReason)

Method Summary

Modifier and Type	Method	Description
CandidateView	chosen()	选中的候选；为 null 表示本次调度失败（见 failReason()）。
String	failReason()	失败原因码（如 no_candidate / zone_not_found）；成功为 null。
DecisionSource	source()	决策来源。
String	traceId()	决策唯一标识：控制面决策为服务端 traceId，本地降级为本地 traceId。

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Constructor Details

ScheduleResult

public ScheduleResult(CandidateView chosen,
 String traceId,
 DecisionSource source,
 String failReason)

Method Details

chosen

public CandidateView chosen()

选中的候选；为 null 表示本次调度失败（见 failReason()）。

traceId

public String traceId()

决策唯一标识：控制面决策为服务端 traceId，本地降级为本地 traceId。

source

public DecisionSource source()

决策来源。

failReason

public String failReason()

失败原因码（如 no_candidate / zone_not_found）；成功为 null。