Poikcue：创建页面，内容为“每个可以被监听的 `Event`（事件）都有一个 `HandlerList` 来存储所有监听该事件的监听器。
事件被触发的…”

2022-11-26T05:22:28Z

创建页面，内容为“每个可以被监听的 <code>Event</code>（事件）都有一个 <code>HandlerList</code> 来存储所有监听该事件的监听器。<br /> 事件被触发的…”

新页面

每个可以被监听的 <code>Event</code>（事件）都有一个 <code>HandlerList</code> 来存储所有监听该事件的监听器。<br />
事件被触发的过程本质上是按照优先级顺序依次调用事件类的 <code>HandlerList</code> 中所存储的监听器。

== 获取某一事件的 HandlerList ==

要获取某一事件的 HandlerList，可以对某个事件类调用静态方法 <code>getHandlerList()</code>。

<syntaxhighlight lang="java">
public class ExampleListener implements Listener {

@EventHandler
public void onPlayerJoin(PlayerJoinEvent event) {
HandlerList handlerList = event.getHandlerList();
// ...
}

// Or:

public ExampleListener() {
// Access the handler list through the static getter
HandlerList handlerList = PlayerJoinEvent.getHandlerList();
// ...
}
}
</syntaxhighlight>
== 注销一个监听器 ==

要注销一个监听器，你可以对监听器注册所在的 <code>HandlerList</code> 调用 <code>unregister()</code> 方法。

<syntaxhighlight lang="java">
public class ExampleListener implements Listener {

@EventHandler
public void onPlayerJoin(PlayerJoinEvent event) {
HandlerList handlerList = event.getHandlerList();
handlerList.unregister(this);
// ...
}

// 或者：

public ExampleListener() {
// 通过静态 getter 访问 HandlerList
HandlerList handlerList = PlayerJoinEvent.getHandlerList();
handlerList.unregister(this);
// 的确，这是一个愚蠢的例子...
}
}
</syntaxhighlight>
为了便于使用，你也可以通过 <code>Listener</code> 或 <code>Plugin</code> 对象进行注销。

译注：对于前者，将会注销某个 <code>Listener</code> 类内所有监听器方法。对于后者，将会注销某个插件所注册的全部事件监听器。

你还可以对 <code>HandlerList</code> 对象调用 <code>unregisterAll()</code> 方法以注销监听某一事件的所有监听器。

Paper/HandlerList - 版本历史

Poikcue：​创建页面，内容为“每个可以被监听的 Event（事件）都有一个 HandlerList 来存储所有监听该事件的监听器。 事件被触发的…”

Poikcue：创建页面，内容为“每个可以被监听的 `Event`（事件）都有一个 `HandlerList` 来存储所有监听该事件的监听器。
事件被触发的…”