Package top.wcpe.beacon.agent.api

Class DeclarationOutcome

java.lang.Object

top.wcpe.beacon.agent.api.DeclarationOutcome

public final class DeclarationOutcome
extends Object

声明结果（FR-243，见 ADR-0086 决策 3）：取值层面区分三类结论。

「通道不可用」（可重试）与「声明被拒」（稳定事实，改正后重报）的处置完全不同， 因此不得用同一个返回值承载两类失败——applied() 只在 DeclarationOutcome.Status.APPLIED 时有值，rejectReason() 只在 DeclarationOutcome.Status.REJECTED 时有值， 两者的取值集合没有交集。

控制面状态码 → 门面取值的映射（真源见规格 §3.4）：

• 200 → DeclarationOutcome.Status.APPLIED（回带生效值）
• 400 → DeclarationOutcome.Status.REJECTED（带拒绝原因：格式非法 / 超界 / 键不合法等）
• 401 / 404 → DeclarationOutcome.Status.UNAVAILABLE（token 缺错 / 实例不在册，退避后重报）
• 连接失败或尚未就绪 → DeclarationOutcome.Status.UNAVAILABLE

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	DeclarationOutcome.Status	声明结论三档。

Method Summary

Modifier and Type	Method	Description
Optional<DeclarationApplied>	applied()	生效后的取值；仅 DeclarationOutcome.Status.APPLIED 时非空。
static DeclarationOutcome	applied(DeclarationApplied applied)	声明已生效（回带控制面生效值）。
static DeclarationOutcome	rejected(String reason)	声明被拒（带原因，改正后可重报）。
Optional<String>	rejectReason()	拒绝原因；仅 DeclarationOutcome.Status.REJECTED 时非空。
DeclarationOutcome.Status	status()	结论。
static DeclarationOutcome	unavailable()	通道不可用（可退避后重报）。

Methods inherited from class java.lang.Object

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

Method Details

applied

public static DeclarationOutcome applied(DeclarationApplied applied)

声明已生效（回带控制面生效值）。

rejected

public static DeclarationOutcome rejected(String reason)

声明被拒（带原因，改正后可重报）。

unavailable

public static DeclarationOutcome unavailable()

通道不可用（可退避后重报）。

status

public DeclarationOutcome.Status status()

结论。

applied

public Optional<DeclarationApplied> applied()

生效后的取值；仅 DeclarationOutcome.Status.APPLIED 时非空。

rejectReason

public Optional<String> rejectReason()

拒绝原因；仅 DeclarationOutcome.Status.REJECTED 时非空。

文案已脱敏（不携带任何凭据），供业务侧日志与运维定位「为什么没成功」。