Package top.wcpe.beacon.agent.api

Class ServiceInstance

java.lang.Object

top.wcpe.beacon.agent.api.ServiceInstance

public final class ServiceInstance
extends Object

服务发现返回的单个在线实例（只读值对象）。

字段与控制面 discovery 返回对齐：无 canary。

Constructor Summary

Constructors

Constructor	Description
ServiceInstance(String serverId, String role, String group, String zone, String address, String version, String status, int playerCount, int capacity, int weight)
ServiceInstance(String serverId, String role, String group, String zone, String address, String version, String status, int playerCount, int capacity, int weight, boolean zoneDefaultEntry)
ServiceInstance(String serverId, String role, String group, String zone, String address, String version, String status, int playerCount, int capacity, int weight, boolean zoneDefaultEntry, boolean lobbyClusterMember)

Method Summary

Modifier and Type	Method	Description
String	address()
int	capacity()
String	group()
boolean	lobbyClusterMember()	该子服是否属于 namespace 全局 LobbyCluster。
int	playerCount()	在线人数（仅展示，不参与任何决策）。
String	role()
String	serverId()
String	status()	健康状态：online / lost / offline。
String	version()
int	weight()
String	zone()
boolean	zoneDefaultEntry()	该子服是否被指定为其小区（zone）的默认入口（FR-48）。

Methods inherited from class java.lang.Object

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

Constructor Details

ServiceInstance

public ServiceInstance(String serverId,
 String role,
 String group,
 String zone,
 String address,
 String version,
 String status,
 int playerCount,
 int capacity,
 int weight)

ServiceInstance

public ServiceInstance(String serverId,
 String role,
 String group,
 String zone,
 String address,
 String version,
 String status,
 int playerCount,
 int capacity,
 int weight,
 boolean zoneDefaultEntry)

ServiceInstance

public ServiceInstance(String serverId,
 String role,
 String group,
 String zone,
 String address,
 String version,
 String status,
 int playerCount,
 int capacity,
 int weight,
 boolean zoneDefaultEntry,
 boolean lobbyClusterMember)

Method Details

serverId

public String serverId()

role

public String role()

group

public String group()

zone

public String zone()

address

public String address()

version

public String version()

status

public String status()

健康状态：online / lost / offline。

playerCount

public int playerCount()

在线人数（仅展示，不参与任何决策）。

capacity

public int capacity()

weight

public int weight()

zoneDefaultEntry

public boolean zoneDefaultEntry()

该子服是否被指定为其小区（zone）的默认入口（FR-48）。

仅 role=bukkit 子服可能为 true；BC 代理 agent 据此把它设为 BungeeCord 默认/fallback 服。 旧控制面不返回该字段时解析为 false（向后兼容）。

lobbyClusterMember

public boolean lobbyClusterMember()

该子服是否属于 namespace 全局 LobbyCluster。

这是控制面发现快照的权威归属事实，与“当前可调度大厅候选”不同；后者受健康、容量和排水状态影响。 旧控制面不返回该字段时解析为 false（向后兼容）。