Index
All Classes and Interfaces|All Packages|Serialized Form
A
- acquireCandidate(String) - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
在指定小区内取一台可调度候选。
- acquireCandidate(String, String) - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
在指定小区内取一台可调度候选,并携带业务用途说明。
- acquireCandidate(String, String, AdmissionScope) - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
在指定小区内取一台可调度候选,并带上准入作用域——决策在生成候选的那一刻就按它收窄 (FR-244)。
- acquireCandidateInLobby(String) - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
在 namespace 全局大厅池里取一台可调度候选(FR-281)。等价于
acquireCandidateInLobby(purpose, null)。 - acquireCandidateInLobby(String, AdmissionScope) - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
在 namespace 全局大厅池里取一台可调度候选,并带上准入作用域(FR-281)。
- acquireCandidateInSharedPool(String) - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
在 namespace 共享游戏池里取一台可调度候选(FR-281)。等价于
acquireCandidateInSharedPool(purpose, null)。 - acquireCandidateInSharedPool(String, AdmissionScope) - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
在 namespace 共享游戏池里取一台可调度候选,并带上准入作用域(FR-281)。
- address() - Method in class top.wcpe.beacon.agent.api.ServiceInstance
- admissionExcludedCount() - Method in class top.wcpe.beacon.agent.api.ScheduleResult
-
本次因准入作用域被排除的候选台数(FR-244);没带作用域、或带了但一台都没被排除时为
0。 - AdmissionScope - Class in top.wcpe.beacon.agent.api
-
选服决策的「准入作用域」:一组备选,每个备选是一组「候选节点必须自己声明过的键值标签」 (FR-244,本仓对 FR-243 §2.2「声明不进入调度决策」那一条的重新裁定)。
- admits(Map<String, String>) - Method in class top.wcpe.beacon.agent.api.AdmissionScope
-
判定一组节点自声明标签是否满足本作用域(纯逻辑,无 I/O)。
- AgentIdentity - Class in top.wcpe.beacon.agent.api
-
当前 agent 的身份。
- AgentIdentity(String, String, String, String, String) - Constructor for class top.wcpe.beacon.agent.api.AgentIdentity
- AgentUnavailableException - Exception Class in top.wcpe.beacon.agent.api
-
agent 门面尚未就绪(未初始化或已卸载)时抛出。
- AgentUnavailableException(String) - Constructor for exception class top.wcpe.beacon.agent.api.AgentUnavailableException
- alternatives() - Method in class top.wcpe.beacon.agent.api.AdmissionScope
-
OR 备选:每个元素是一组必须全部满足的键值标签。
- anyOf(List<Map<String, String>>) - Static method in class top.wcpe.beacon.agent.api.AdmissionScope
-
多个备选(OR 语义):任一备选被满足即准入。
- anyOf(AdmissionScope...) - Static method in class top.wcpe.beacon.agent.api.AdmissionScope
-
把若干作用域并列成一个 OR 作用域(便于把
AdmissionScope.of(String, String)的产物拼起来)。 - applied() - Method in class top.wcpe.beacon.agent.api.DeclarationOutcome
-
生效后的取值;仅
DeclarationOutcome.Status.APPLIED时非空。 - applied(DeclarationApplied) - Static method in class top.wcpe.beacon.agent.api.DeclarationOutcome
-
声明已生效(回带控制面生效值)。
- APPLIED - Enum constant in enum class top.wcpe.beacon.agent.api.DeclarationOutcome.Status
-
已生效:控制面已刷新并回带生效值(
DeclarationOutcome.applied()必有值)。 - appliedCount() - Method in class top.wcpe.beacon.agent.api.ConfigReloadResult
-
实际加载的条目/活动数量;未自报时为空。
- appliedMd5() - Method in class top.wcpe.beacon.agent.api.ConfigReloadResult
-
实际加载内容的 md5;未自报时为空。
- appliedVersion() - Method in class top.wcpe.beacon.agent.api.ConfigReloadResult
-
实际解析出的规则/配置版本标识;未自报时为空。
- awaitRegistered(long) - Method in interface top.wcpe.beacon.agent.api.BeaconAgent
-
有界等待 agent 首次注册成功(控制面权威应答返回、zone 已按响应回填)。
B
- BeaconAgent - Interface in top.wcpe.beacon.agent.api
-
Beacon agent 对业务插件暴露的总门面:读有效配置 + 查服务发现 + 节点自声明。
- BeaconAgentProvider - Class in top.wcpe.beacon.agent.api
-
Beacon agent 对外门面的获取入口。
- BeaconScheduling - Interface in top.wcpe.beacon.agent.api
-
本机调度 / 健康门面(FR-148):业务插件取调度候选与健康事实的唯一入口。
- build() - Method in class top.wcpe.beacon.agent.api.DiscoveryQuery.Builder
- builder() - Static method in class top.wcpe.beacon.agent.api.DiscoveryQuery
C
- call(String, String, Object) - Method in interface top.wcpe.beacon.agent.api.Messaging
-
请求-响应(RPC):发请求并立即返回 Future,目标回信后完成;超时则 Future 异常完成 (
TimeoutException)。 - candidatesInLobby() - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
列出 namespace 全局大厅池当前候选快照(本地缓存,O(1) 读,可在主线程调用)。
- candidatesInLobby(AdmissionScope) - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
列出 namespace 全局大厅池当前候选快照,并只保留满足准入作用域的那些(FR-281)。
- candidatesInSharedPool() - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
列出 namespace 共享游戏池当前候选快照(本地缓存,O(1) 读,可在主线程调用)。
- candidatesInSharedPool(AdmissionScope) - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
列出 namespace 共享游戏池当前候选快照,并只保留满足准入作用域的那些(FR-281)。
- candidatesInZone(String) - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
列出指定小区当前候选快照(本地缓存,O(1) 读,可在主线程调用)。
- candidatesInZone(String, AdmissionScope) - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
列出指定小区当前候选快照,并只保留满足准入作用域的那些(FR-244)。
- CandidateView - Class in top.wcpe.beacon.agent.api
-
调度候选的只读快照视图(FR-148)。
- CandidateView(String, String, int, HealthLevel, int, int) - Constructor for class top.wcpe.beacon.agent.api.CandidateView
-
不带标签的候选视图(既有构造器,行为逐位不变)——标签记为空 map。
- CandidateView(String, String, int, HealthLevel, int, int, Map<String, String>) - Constructor for class top.wcpe.beacon.agent.api.CandidateView
-
带节点自声明标签的候选视图(FR-244 新增构造器)。
- capacity() - Method in class top.wcpe.beacon.agent.api.DeclarationApplied
-
生效容量;控制面未回带该字段时为空。
- capacity() - Method in class top.wcpe.beacon.agent.api.NodeDeclaration
-
本次声明的容量。
- capacity() - Method in class top.wcpe.beacon.agent.api.ServiceInstance
- chosen() - Method in class top.wcpe.beacon.agent.api.ScheduleResult
-
选中的候选;为 null 表示本次调度失败(见
ScheduleResult.failReason()与ScheduleResult.state())。 - CHOSEN - Enum constant in enum class top.wcpe.beacon.agent.api.ScheduleState
-
选出了候选(
ScheduleResult.chosen()非 null)。 - config() - Method in interface top.wcpe.beacon.agent.api.BeaconAgent
-
有效配置只读视图。
- ConfigChangeListener - Interface in top.wcpe.beacon.agent.api
-
有效配置变更回调。
- ConfigReloadResult - Class in top.wcpe.beacon.agent.api
-
一次配置重载的结果,由业务插件在
ReportingConfigChangeListener中返回。 - connected() - Method in interface top.wcpe.beacon.agent.api.BeaconAgent
-
agent 当前是否已连上控制面。
- CONTROL_PLANE - Enum constant in enum class top.wcpe.beacon.agent.api.DataSource
-
数据来自控制面在线刷新(最近一次候选刷新成功)。
- CONTROL_PLANE - Enum constant in enum class top.wcpe.beacon.agent.api.DecisionSource
-
控制面在线决策(正常路径,traceId 为服务端 traceId)。
D
- DataIdPrefix - Class in top.wcpe.beacon.agent.api
-
dataId 路径前缀匹配工具:**前缀过滤规则的唯一真源**。
- dataIds() - Method in interface top.wcpe.beacon.agent.api.EffectiveConfig
-
列出当前所有有效配置项的 dataId。
- dataSource() - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
当前数据来源状态与快照年龄。
- DataSource - Enum Class in top.wcpe.beacon.agent.api
-
候选 / 健康视图当前的数据来源(FR-148)。
- DataSourceState - Class in top.wcpe.beacon.agent.api
-
本机候选缓存当前的数据来源状态与快照年龄(FR-148)。
- DataSourceState(DataSource, boolean, long) - Constructor for class top.wcpe.beacon.agent.api.DataSourceState
- DecisionSource - Enum Class in top.wcpe.beacon.agent.api
-
一次调度决策的来源(FR-148)。
- declaration() - Method in interface top.wcpe.beacon.agent.api.BeaconAgent
-
本节点自声明门面(FR-243,见 ADR-0086):在运行期刷新自己的容量与自定义标签。
- DeclarationApplied - Class in top.wcpe.beacon.agent.api
-
一次声明生效后的取值(控制面 200 响应回带,自证刷新结果;FR-243)。
- DeclarationApplied(Integer, Map<String, String>) - Constructor for class top.wcpe.beacon.agent.api.DeclarationApplied
- DeclarationOutcome - Class in top.wcpe.beacon.agent.api
-
声明结果(FR-243,见 ADR-0086 决策 3):取值层面区分三类结论。
- DeclarationOutcome.Status - Enum Class in top.wcpe.beacon.agent.api
-
声明结论三档。
- declare(NodeDeclaration) - Method in interface top.wcpe.beacon.agent.api.SelfDeclaration
-
声明(刷新)本节点的容量与 / 或标签。
- DEGRADED - Enum constant in enum class top.wcpe.beacon.agent.api.HealthLevel
-
亚健康:degradedMin ≤ score < healthyMin,仍可调度、仅排序靠后。
- detailJson() - Method in class top.wcpe.beacon.agent.api.ConfigReloadResult
-
插件自定义结构化详情 JSON;无则空串(永不为 null)。
- discovery() - Method in interface top.wcpe.beacon.agent.api.BeaconAgent
-
服务发现查询(同步 HTTP,请在异步线程调用)。
- Discovery - Interface in top.wcpe.beacon.agent.api
-
服务发现查询。
- DiscoveryQuery - Class in top.wcpe.beacon.agent.api
-
服务发现查询条件(不可变,经
DiscoveryQuery.Builder构造)。 - DiscoveryQuery.Builder - Class in top.wcpe.beacon.agent.api
-
DiscoveryQuery构造器。未设置的字段表示该维度不过滤。
E
- EffectiveConfig - Interface in top.wcpe.beacon.agent.api
-
有效配置只读视图。
- effectiveMd5() - Method in interface top.wcpe.beacon.agent.api.BeaconAgent
-
当前有效配置整体 md5;尚无有效配置时为空。可用于业务侧判断是否已收敛。
- empty() - Static method in class top.wcpe.beacon.agent.api.AdmissionScope
-
空作用域:不按标签收窄(与不带作用域的那条重载等价)。
- equals(Object) - Method in class top.wcpe.beacon.agent.api.AdmissionScope
-
按
AdmissionScope.alternatives()的内容相等比较。
F
- failed(String) - Static method in class top.wcpe.beacon.agent.api.ConfigReloadResult
-
重载失败。
- failed(String, String) - Static method in class top.wcpe.beacon.agent.api.ConfigReloadResult
-
重载失败,并附带结构化详情。
- failReason() - Method in class top.wcpe.beacon.agent.api.ScheduleResult
-
失败原因码(如
no_candidate/no_candidate_in_scope/zone_not_found); 成功为 null。 - filter(String, Collection<String>) - Static method in class top.wcpe.beacon.agent.api.DataIdPrefix
-
取以该前缀开头的 dataId 子集,保持入参顺序,并丢弃
null项。 - format(String) - Method in interface top.wcpe.beacon.agent.api.EffectiveConfig
-
取某 dataId 的格式(yaml / properties / json);不存在返回空。
- fresh() - Method in class top.wcpe.beacon.agent.api.DataSourceState
-
快照年龄是否在阈值内(默认 ≤ 10 分钟为 true;超龄仍可用但标 false)。
G
- get() - Static method in class top.wcpe.beacon.agent.api.BeaconAgentProvider
-
获取 Beacon agent 门面。
- group() - Method in class top.wcpe.beacon.agent.api.AgentIdentity
-
控制面解析的大区;未解析时为空。
- group() - Method in class top.wcpe.beacon.agent.api.DiscoveryQuery
- group() - Method in class top.wcpe.beacon.agent.api.ServiceInstance
- group(String) - Method in class top.wcpe.beacon.agent.api.DiscoveryQuery.Builder
H
- handle(String, Object) - Method in interface top.wcpe.beacon.agent.api.TopicHandler
-
处理一条主题消息。
- handle(IncomingMessage) - Method in interface top.wcpe.beacon.agent.api.MessageHandler
-
处理一条收到的消息。
- hashCode() - Method in class top.wcpe.beacon.agent.api.AdmissionScope
- hasLabels() - Method in class top.wcpe.beacon.agent.api.NodeDeclaration
-
本次声明是否携带标签。
- HealthLevel - Enum Class in top.wcpe.beacon.agent.api
-
健康等级(FR-147)。
- healthOf(String) - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
查询某台服务器的健康视图(本地候选缓存快照)。
- HealthView - Class in top.wcpe.beacon.agent.api
-
某台服务器的健康视图快照(FR-147 / FR-148)。
- HealthView(String, int, HealthLevel, boolean, List<String>, long) - Constructor for class top.wcpe.beacon.agent.api.HealthView
- HEALTHY - Enum constant in enum class top.wcpe.beacon.agent.api.HealthLevel
-
健康:score ≥ healthyMin,正常可调度。
I
- identity() - Method in interface top.wcpe.beacon.agent.api.BeaconAgent
-
当前 agent 身份(namespace/serverId/role/group/zone)。
- IncomingMessage - Interface in top.wcpe.beacon.agent.api
-
收到的一条跨服消息(按类型分发给
MessageHandler)。 - instancesInGroup(String) - Method in interface top.wcpe.beacon.agent.api.Discovery
-
列出某大区(group)下全部在线实例。
- instancesInZone(String, String) - Method in interface top.wcpe.beacon.agent.api.Discovery
-
列出某 zone 下的在线实例(拓扑视角便捷方法)。
- isAvailable() - Static method in class top.wcpe.beacon.agent.api.BeaconAgentProvider
-
agent 是否已就绪(业务插件可据此先行判断,避免触发异常)。
- isAvailable() - Method in interface top.wcpe.beacon.agent.api.Messaging
-
模块是否可用(已启用且控制面可达)。业务侧据此优雅降级。
- isEmpty() - Method in class top.wcpe.beacon.agent.api.AdmissionScope
-
本作用域是否不按标签收窄(true 时决策行为与不带作用域的那条重载逐位一致)。
- isFiltering(String) - Static method in class top.wcpe.beacon.agent.api.DataIdPrefix
-
该前缀是否需要过滤。
- isOk() - Method in class top.wcpe.beacon.agent.api.ConfigReloadResult
-
是否成功。
- isRequest() - Method in interface top.wcpe.beacon.agent.api.IncomingMessage
-
本消息是否为 RPC 请求(可经
IncomingMessage.reply(Object)回信)。
L
- labels() - Method in class top.wcpe.beacon.agent.api.CandidateView
-
该候选节点自己声明的键值标签(FR-243 的写入面,本仓不解释任何 key 的语义)。
- labels() - Method in class top.wcpe.beacon.agent.api.DeclarationApplied
-
生效标签整体集合(不可修改视图;空 Map = 该节点当前无标签)。
- labels() - Method in class top.wcpe.beacon.agent.api.NodeDeclaration
-
本次声明的标签整体集合。
- level() - Method in class top.wcpe.beacon.agent.api.CandidateView
-
健康等级。
- level() - Method in class top.wcpe.beacon.agent.api.HealthView
-
健康等级。
- ListenerHandle - Interface in top.wcpe.beacon.agent.api
-
监听器注销句柄。调用
ListenerHandle.remove()后不再收到回调。 - lobbyClusterMember() - Method in class top.wcpe.beacon.agent.api.ServiceInstance
-
该子服是否属于 namespace 全局 LobbyCluster。
- LOCAL_FALLBACK - Enum constant in enum class top.wcpe.beacon.agent.api.DecisionSource
-
控制面不可用时 agent 依本地候选快照做的降级决策(fail-static,traceId 为本地 traceId)。
- LOCAL_SNAPSHOT - Enum constant in enum class top.wcpe.beacon.agent.api.DataSource
-
控制面不可用,数据来自最后一次落盘快照(含重启后恢复,fail-static)。
M
- maxOnline() - Method in class top.wcpe.beacon.agent.api.CandidateView
-
容量上限。
- md5(String) - Method in interface top.wcpe.beacon.agent.api.EffectiveConfig
-
取某 dataId 的单项 md5;不存在返回空。
- MessageHandler - Interface in top.wcpe.beacon.agent.api
-
按类型分发的消息处理器(函数式接口)。在中间件后台线程触发,绝不在 MC 主线程。
- messaging() - Method in interface top.wcpe.beacon.agent.api.BeaconAgent
-
跨服消息中间件门面(FR-26):定向 / RPC / 主题 / 按玩家寻址的通用传输。
- Messaging - Interface in top.wcpe.beacon.agent.api
-
跨服消息中间件门面(FR-26;传输层现行决策见 ADR-0063,取代 ADR-0016 的 Redis 数据面直连): 对③层业务插件暴露与内容无关的通用传输。
- metadata() - Method in class top.wcpe.beacon.agent.api.ServiceInstance
-
节点声明的键值标签(只读事实)。
N
- namespace() - Method in class top.wcpe.beacon.agent.api.AgentIdentity
-
环境(prod / test)。
- namespace() - Method in class top.wcpe.beacon.agent.api.DiscoveryQuery
- namespace(String) - Method in class top.wcpe.beacon.agent.api.DiscoveryQuery.Builder
- NO_CANDIDATE - Enum constant in enum class top.wcpe.beacon.agent.api.ScheduleState
-
决策成立、结论为「没有满足条件的候选」(
ScheduleResult.chosen()为 null)。 - NodeDeclaration - Class in top.wcpe.beacon.agent.api
-
节点自声明(FR-243,见 ADR-0086):业务插件为本节点声明「容量」与「自定义键值标签」。
O
- of(int, Map<String, String>) - Static method in class top.wcpe.beacon.agent.api.NodeDeclaration
-
同时刷新容量与标签。
- of(String, String) - Static method in class top.wcpe.beacon.agent.api.AdmissionScope
-
单个要求(最常用形态:接入方给「我这台必须服务我这个区」这类单条条件)——一个备选、一条键值。
- of(Map<String, String>) - Static method in class top.wcpe.beacon.agent.api.AdmissionScope
-
一组要求(一个备选,AND 语义)。
- ofCapacity(int) - Static method in class top.wcpe.beacon.agent.api.NodeDeclaration
-
只刷新容量(如
NodeDeclaration.ofCapacity(100))。 - ofLabels(Map<String, String>) - Static method in class top.wcpe.beacon.agent.api.NodeDeclaration
-
只刷新标签(提供即整体替换,不合并)。
- ok() - Static method in class top.wcpe.beacon.agent.api.ConfigReloadResult
-
重载成功。
- ok(String) - Static method in class top.wcpe.beacon.agent.api.ConfigReloadResult
-
重载成功,并附带结构化详情。
- on(String, MessageHandler) - Method in interface top.wcpe.beacon.agent.api.Messaging
-
注册按消息类型分发的处理器(收消息入口)。同 type 重复注册以最后一次为准。
- onChange(String, ConfigChangeListener) - Method in interface top.wcpe.beacon.agent.api.EffectiveConfig
-
注册**按 dataId 路径前缀过滤**的有效配置变更监听。
- onChange(ConfigChangeListener) - Method in interface top.wcpe.beacon.agent.api.EffectiveConfig
-
注册有效配置变更监听(apply 后回调,携带变更的 dataId 集合)。
- onConfigChanged(Set<String>, String) - Method in interface top.wcpe.beacon.agent.api.ConfigChangeListener
- onConfigChanged(Set<String>, String) - Method in interface top.wcpe.beacon.agent.api.ReportingConfigChangeListener
-
默认实现委托给上报方法并丢弃结果,保证老式「只发通知」调用语义仍可工作。
- onConfigChangedReporting(Set<String>, String) - Method in interface top.wcpe.beacon.agent.api.ReportingConfigChangeListener
-
配置已变更,请把新配置应用到运行态并返回结果。
- onlineCount() - Method in class top.wcpe.beacon.agent.api.CandidateView
-
在线人数(仅展示,不参与调用方决策)。
- onTopologyChanged() - Method in interface top.wcpe.beacon.agent.api.TopologyListener
-
拓扑发生变更(上线 / 下线 / 改派);业务侧据此重查发现端点。
P
- payload() - Method in interface top.wcpe.beacon.agent.api.IncomingMessage
-
业务负载(泛型树:Map/List/字符串/数字/布尔/null)。
- playerCount() - Method in class top.wcpe.beacon.agent.api.ServiceInstance
-
在线人数(仅展示,不参与任何决策)。
- publish(String, Object) - Method in interface top.wcpe.beacon.agent.api.Messaging
-
主题发布(可丢广播,FR-180 / ADR-0065):向发送者 namespace 当前全部在线服 fan-out 一条广播 (含发送者自身),topic 落 msg_type,接收方按
Messaging.subscribe(java.lang.String, top.wcpe.beacon.agent.api.TopicHandler)注册的同名处理器分发。 - publish(String, Object, String) - Method in interface top.wcpe.beacon.agent.api.Messaging
-
主题发布 · zone 级定向(FR-180 重载,接口只增不改、守二进制兼容):只向发送者 namespace 内指定
zone的当前在线服 fan-out;其余语义同Messaging.publish(String, Object)(可丢、不补投、不出信任边界)。
Q
- query(DiscoveryQuery) - Method in interface top.wcpe.beacon.agent.api.Discovery
-
按条件过滤在线实例。
R
- raw(String) - Method in interface top.wcpe.beacon.agent.api.EffectiveConfig
-
取某 dataId 的合并后原始文本;不存在返回空。
- reason() - Method in class top.wcpe.beacon.agent.api.ConfigReloadResult
-
可读原因;成功时为空串(永不为 null)。
- reasons() - Method in class top.wcpe.beacon.agent.api.HealthView
-
不可调度原因码(只读,可空为空表)。
- register(BeaconAgent) - Static method in class top.wcpe.beacon.agent.api.BeaconAgentProvider
-
由 agent 实现层在 ENABLE 阶段注册;业务插件不应调用。
- rejected(String) - Static method in class top.wcpe.beacon.agent.api.DeclarationOutcome
-
声明被拒(带原因,改正后可重报)。
- REJECTED - Enum constant in enum class top.wcpe.beacon.agent.api.DeclarationOutcome.Status
-
声明被拒:请求体非法 / 超界等稳定事实,改正后重报(
DeclarationOutcome.rejectReason()必有值)。 - rejectReason() - Method in class top.wcpe.beacon.agent.api.DeclarationOutcome
-
拒绝原因;仅
DeclarationOutcome.Status.REJECTED时非空。 - remove() - Method in interface top.wcpe.beacon.agent.api.ListenerHandle
-
注销监听器。重复调用安全。
- reply(Object) - Method in interface top.wcpe.beacon.agent.api.IncomingMessage
-
回信(仅 RPC 请求有效;非请求调用无副作用)。
- ReportingConfigChangeListener - Interface in top.wcpe.beacon.agent.api
-
可上报重载结果的配置变更回调。
- role() - Method in class top.wcpe.beacon.agent.api.AgentIdentity
-
角色(bukkit / bungee),由壳层固定。
- role() - Method in class top.wcpe.beacon.agent.api.DiscoveryQuery
- role() - Method in class top.wcpe.beacon.agent.api.ServiceInstance
- role(String) - Method in class top.wcpe.beacon.agent.api.DiscoveryQuery.Builder
- roster() - Method in interface top.wcpe.beacon.agent.api.Discovery
-
全量玩家位置名册(FR-31):返回 玩家名 → 所在 serverId 的只读快照。
- rosterInZone(String, String) - Method in interface top.wcpe.beacon.agent.api.Discovery
-
zone 过滤后的玩家位置名册(FR-31):仅含落在该 group/zone 下子服的玩家。
S
- sampledAtMs() - Method in class top.wcpe.beacon.agent.api.HealthView
-
该视图对应的采样时刻(毫秒)。
- schedulable() - Method in class top.wcpe.beacon.agent.api.HealthView
-
是否可调度。
- ScheduleResult - Class in top.wcpe.beacon.agent.api
-
一次
acquireCandidate的决策结果(FR-148)。 - ScheduleResult(CandidateView, String, DecisionSource, String) - Constructor for class top.wcpe.beacon.agent.api.ScheduleResult
- ScheduleResult(CandidateView, String, DecisionSource, String, ScheduleState) - Constructor for class top.wcpe.beacon.agent.api.ScheduleResult
-
带三态结论的构造器(FR-244 新增)。
- ScheduleResult(CandidateView, String, DecisionSource, String, ScheduleState, int) - Constructor for class top.wcpe.beacon.agent.api.ScheduleResult
-
带三态结论与作用域排除台数的构造器(FR-244)。
- ScheduleState - Enum Class in top.wcpe.beacon.agent.api
-
一次选服决策的结论类别(FR-244):把「有结果」「空结果」「没做成」三件事分成三个取值。
- scheduling() - Method in interface top.wcpe.beacon.agent.api.BeaconAgent
-
本机调度 / 健康门面(FR-148):取调度候选与健康事实的唯一入口。
- score() - Method in class top.wcpe.beacon.agent.api.CandidateView
-
健康分(0-100)。
- score() - Method in class top.wcpe.beacon.agent.api.HealthView
-
健康分(0-100)。
- SelfDeclaration - Interface in top.wcpe.beacon.agent.api
-
节点自声明门面(FR-243,见 ADR-0086):刷新本节点自己的容量与自定义标签。
- selfHealth() - Method in interface top.wcpe.beacon.agent.api.BeaconScheduling
-
查询本服自身健康视图(随每次指标上报响应刷新,约 5s 新鲜度)。
- send(String, String, Object) - Method in interface top.wcpe.beacon.agent.api.Messaging
-
定向发送(fire-and-forget,在线尽力送达):经控制面单跳中转投给目标服。
- sendToPlayer(String, String, Object) - Method in interface top.wcpe.beacon.agent.api.Messaging
-
按玩家寻址:解析玩家当前所在服后定向发送(依赖 beacon-proxy 维护的玩家名册)。
- serverId() - Method in class top.wcpe.beacon.agent.api.AgentIdentity
-
本机唯一身份,环境内唯一。
- serverId() - Method in class top.wcpe.beacon.agent.api.CandidateView
-
候选子服 serverId。
- serverId() - Method in class top.wcpe.beacon.agent.api.HealthView
-
服务器 serverId。
- serverId() - Method in class top.wcpe.beacon.agent.api.ServiceInstance
- ServiceInstance - Class in top.wcpe.beacon.agent.api
-
服务发现返回的单个在线实例(只读值对象)。
- ServiceInstance(String, String, String, String, String, String, String, int, int, int) - Constructor for class top.wcpe.beacon.agent.api.ServiceInstance
- ServiceInstance(String, String, String, String, String, String, String, int, int, int, boolean) - Constructor for class top.wcpe.beacon.agent.api.ServiceInstance
- ServiceInstance(String, String, String, String, String, String, String, int, int, int, boolean, boolean) - Constructor for class top.wcpe.beacon.agent.api.ServiceInstance
- ServiceInstance(String, String, String, String, String, String, String, int, int, int, boolean, boolean, Map<String, String>) - Constructor for class top.wcpe.beacon.agent.api.ServiceInstance
-
带节点标签(metadata)的构造器。
- snapshotAgeMs() - Method in class top.wcpe.beacon.agent.api.DataSourceState
-
最近一次候选快照落点距今毫秒;从无快照时为
Long.MAX_VALUE。 - source() - Method in class top.wcpe.beacon.agent.api.DataSourceState
-
当前数据来源。
- source() - Method in interface top.wcpe.beacon.agent.api.IncomingMessage
-
发起方 serverId(可能为 null)。
- source() - Method in class top.wcpe.beacon.agent.api.ScheduleResult
-
决策来源。
- state() - Method in class top.wcpe.beacon.agent.api.ScheduleResult
-
本次结论的类别(FR-244):
ScheduleState.CHOSEN/ScheduleState.NO_CANDIDATE(稳定事实)/ScheduleState.UNAVAILABLE(当前状态、可重试)。 - status() - Method in class top.wcpe.beacon.agent.api.DeclarationOutcome
-
结论。
- status() - Method in class top.wcpe.beacon.agent.api.ServiceInstance
-
健康状态:online / lost / offline。
- subscribe(String, TopicHandler) - Method in interface top.wcpe.beacon.agent.api.Messaging
-
主题订阅(FR-180 / ADR-0065):登记本地按 topic 分发的处理器,接收经
Messaging.publish(java.lang.String, java.lang.Object)广播到本服的该主题消息。 与Messaging.on(java.lang.String, top.wcpe.beacon.agent.api.MessageHandler)的定向消息分发表相互隔离、互不干扰。
T
- tag(String, String) - Method in class top.wcpe.beacon.agent.api.DiscoveryQuery.Builder
-
追加一个自定义元数据过滤条件(key/value 任一为空则忽略)。
- tags() - Method in class top.wcpe.beacon.agent.api.DiscoveryQuery
-
自定义元数据过滤条件(不可变;空表示不按 tag 过滤)。多 tag 取交集。
- top.wcpe.beacon.agent.api - package top.wcpe.beacon.agent.api
- TopicHandler - Interface in top.wcpe.beacon.agent.api
-
主题消息处理器(函数式接口)。在中间件后台线程触发,绝不在 MC 主线程。
- TopologyListener - Interface in top.wcpe.beacon.agent.api
-
拓扑变更回调(FR-29)。
- toString() - Method in class top.wcpe.beacon.agent.api.AdmissionScope
-
诊断用:只印备选个数与各备选的键,不展开值(值可能含运维侧的业务标识)。
- toString() - Method in class top.wcpe.beacon.agent.api.ConfigReloadResult
- traceId() - Method in class top.wcpe.beacon.agent.api.ScheduleResult
-
决策唯一标识:控制面决策为服务端 traceId,本地降级为本地 traceId。
- type() - Method in interface top.wcpe.beacon.agent.api.IncomingMessage
-
业务消息类型。
U
- unavailable() - Static method in class top.wcpe.beacon.agent.api.DeclarationOutcome
-
通道不可用(可退避后重报)。
- UNAVAILABLE - Enum constant in enum class top.wcpe.beacon.agent.api.DeclarationOutcome.Status
-
通道不可用:尚未就绪 / 鉴权不过 / 实例不在册 / 连接失败,可退避后重报(无附加取值)。
- UNAVAILABLE - Enum constant in enum class top.wcpe.beacon.agent.api.ScheduleState
-
决策没做成(结论未知,可重试);
ScheduleResult.chosen()为 null。 - UNHEALTHY - Enum constant in enum class top.wcpe.beacon.agent.api.HealthLevel
-
不健康:score < degradedMin,不可调度。
- unregister() - Static method in class top.wcpe.beacon.agent.api.BeaconAgentProvider
-
由 agent 实现层在 DISABLE 阶段注销;业务插件不应调用。
V
- valueOf(String) - Static method in enum class top.wcpe.beacon.agent.api.DataSource
-
Returns the enum constant of this class with the specified name.
- valueOf(String) - Static method in enum class top.wcpe.beacon.agent.api.DecisionSource
-
Returns the enum constant of this class with the specified name.
- valueOf(String) - Static method in enum class top.wcpe.beacon.agent.api.DeclarationOutcome.Status
-
Returns the enum constant of this class with the specified name.
- valueOf(String) - Static method in enum class top.wcpe.beacon.agent.api.HealthLevel
-
Returns the enum constant of this class with the specified name.
- valueOf(String) - Static method in enum class top.wcpe.beacon.agent.api.ScheduleState
-
Returns the enum constant of this class with the specified name.
- values() - Static method in enum class top.wcpe.beacon.agent.api.DataSource
-
Returns an array containing the constants of this enum class, in the order they are declared.
- values() - Static method in enum class top.wcpe.beacon.agent.api.DecisionSource
-
Returns an array containing the constants of this enum class, in the order they are declared.
- values() - Static method in enum class top.wcpe.beacon.agent.api.DeclarationOutcome.Status
-
Returns an array containing the constants of this enum class, in the order they are declared.
- values() - Static method in enum class top.wcpe.beacon.agent.api.HealthLevel
-
Returns an array containing the constants of this enum class, in the order they are declared.
- values() - Static method in enum class top.wcpe.beacon.agent.api.ScheduleState
-
Returns an array containing the constants of this enum class, in the order they are declared.
- version() - Method in class top.wcpe.beacon.agent.api.ServiceInstance
W
- watch(TopologyListener) - Method in interface top.wcpe.beacon.agent.api.Discovery
-
订阅拓扑变更(FR-29):同 namespace 内实例上线 / 下线 / 改派 zone 时回调 listener。
- weight() - Method in class top.wcpe.beacon.agent.api.ServiceInstance
- withAppliedCount(int) - Method in class top.wcpe.beacon.agent.api.ConfigReloadResult
-
回报「实际加载的条目/活动数量」。
- withAppliedMd5(String) - Method in class top.wcpe.beacon.agent.api.ConfigReloadResult
-
回报「实际加载内容的 md5」,供控制面核对版本是否符合期望。
- withAppliedVersion(String) - Method in class top.wcpe.beacon.agent.api.ConfigReloadResult
-
回报「实际解析出的版本标识」,供控制面核对版本是否符合期望。
Z
- zone() - Method in class top.wcpe.beacon.agent.api.AgentIdentity
-
控制面指派的小区;未指派时为空。
- zone() - Method in class top.wcpe.beacon.agent.api.CandidateView
-
候选所在小区名。
- zone() - Method in class top.wcpe.beacon.agent.api.DiscoveryQuery
- zone() - Method in class top.wcpe.beacon.agent.api.ServiceInstance
- zone(String) - Method in class top.wcpe.beacon.agent.api.DiscoveryQuery.Builder
- zoneDefaultEntry() - Method in class top.wcpe.beacon.agent.api.ServiceInstance
-
该子服是否被指定为其小区(zone)的默认入口(FR-48)。
与
- 与「没有标签」的关系 - Search tag in class top.wcpe.beacon.agent.api.AdmissionScope
- Section
为
- 为什么必须分开 - Search tag in enum class top.wcpe.beacon.agent.api.ScheduleState
- Section
它
- 它解决什么 - Search tag in class top.wcpe.beacon.agent.api.AdmissionScope
- Section
语
- 语义(四条,钉死) - Search tag in class top.wcpe.beacon.agent.api.AdmissionScope
- Section
All Classes and Interfaces|All Packages|Serialized Form