API 参考 / 事件系统
EventResult
想先跑起来?
这一页是签名与行为参考。DEFAULT / ALLOW / DENY 的三态语义。直接做一遍:教程 · 订阅游玩事件。
监听器对事件的处理结论。只有 DEFAULT 会让总线继续通知后续监听器;ALLOW 与 DENY 都短路,共同构成「高优先级先下定论、低优先级不再被征询」的审批模型。
常量
| 常量 | 总线是否继续通知 | 含义 |
|---|---|---|
DEFAULT | 继续 | 不干预,宿主执行默认动作 |
ALLOW | 停止 | 提前放行,压过后续监听器的否决意图 |
DENY | 停止 | 否决本次默认动作(仅对可取消事件有意义) |
方法速览
| 方法 | 用途 |
|---|---|
values() | 按声明顺序返回全部常量 |
valueOf(String) | 按名称取常量,名称非法时抛 IllegalArgumentException |
values()
java
public static EventResult[] values();行为:返回 {DEFAULT, ALLOW, DENY},每次调用返回新数组。
valueOf(String name)
java
public static EventResult valueOf(String name);行为:按名称精确匹配;null 或未知名称抛 IllegalArgumentException。
示例
java
event.setResult(EventResult.DENY);
boolean denied = event.isDenied();完整签名
java
public enum EventResult {
DEFAULT,
ALLOW,
DENY
}稳定性:2.0 起冻结,2.x 内只增不破。