Package top.wcpe.beacon.agent.api

Interface SelfDeclaration

public interface SelfDeclaration
节点自声明门面（FR-243，见 ADR-0086）：刷新本节点自己的容量与自定义标签。

窄写入面：只能声明自己的容量与标签，改配置 / 改 zone / 写他人一律不可达 （请求体里的 namespace / serverId 只用于定位，身份以 agent 自身在册归属为准）。

线程：同步 HTTP，调用方须在异步线程发起，绝不在 MC 主线程调用 （与 Discovery.query(top.wcpe.beacon.agent.api.DiscoveryQuery) 的既有约定一致）。

幂等：重复声明 = 刷新，不新增实例、不叠加标签；NodeDeclaration 里缺省的字段 保持原值（部分刷新）。

结论：见 DeclarationOutcome——三类结论取值可区分，绝不外抛异常 （不可用时返回 DeclarationOutcome.Status.UNAVAILABLE，业务侧据此优雅降级）。

  • Method Summary

    Modifier and Type
    Method
    Description
    DeclarationOutcome
    declare(NodeDeclaration declaration)
    声明（刷新）本节点的容量与 / 或标签。

  • Method Details

    • declare

      DeclarationOutcome declare(NodeDeclaration declaration)
      声明（刷新）本节点的容量与 / 或标签。
      Parameters:
      declaration - 本次要刷新的字段（各自可选）；null 由实现按「无有效字段」拒绝
      Returns:
      三档结论：APPLIED（回带生效值）/ REJECTED（带原因）/ UNAVAILABLE（可重试）；绝不返回 null