跳至主要内容

Events

在 ChatGPT 中打开
Java API

组件,无论是自定义的还是框架的一部分,都支持事件处理。您可以添加事件侦听器以捕获各种类型的事件,例如用户交互、状态变化或其他自定义事件。这些事件侦听器可以用于在响应事件时触发特定的操作或行为。

在下面的示例中,使用三种支持的方法添加一个事件:lambda 表达式、匿名类和方法引用。

添加事件

添加事件侦听器可以使用以下模式之一,其中:

  • myComponent 是您想要附加事件侦听器的组件。

  • addEventListener 被替换为特定事件的方法。

  • EventListener 被替换为正在监听的事件类型。

myComponent.addEventListener(e -> {
// 事件触发时执行
});

// 或

myComponent.addEventListener(new ComponentEventListener<EventListener>() {
@Override
public void onComponentEvent(ComponentEvent e){
// 事件触发时执行
}
});

// 或

myComponent.addEventListener(this::eventMethod);

还增加了一些额外的语法糖方法或别名,以通过使用 on 前缀后跟事件来允许替代添加事件,例如:

myComponent.onEvent(e -> {
// 事件触发时执行
});

移除事件

在添加事件侦听器时,将返回一个 ListenerRegistration 对象。这可以用于其他事情,也可以用于稍后移除事件。

// 添加事件
ListenerRegistration listenerRegistration = myComponent.addEventListener(e -> {
// 事件触发时执行
});

// 移除事件
listenerRegistration.remove();

使用事件有效载荷

需要注意的是,事件通常伴随有效载荷,其中包含与事件相关的附加信息。您可以在事件处理程序中有效地利用此有效载荷,以获取相关数据,而无需在客户端和服务器之间进行不必要的往返。通过这样做,您可以提高应用程序的性能。

以下代码片段查询组件以获取信息,这在我们的演示中已经包含在事件有效载荷中,代表低效代码:

myComponent.addEventListener(e -> {
// 从组件中访问数据
String componentText = e.getComponent().getText();

// 或者如果组件在函数的作用域内可访问
String componentText = myComponent.getText();

// 使用 componentText 执行其他操作。
});

相反,利用方法的有效载荷,例如文本的组件,可以避免往返:

myComponent.addEventListener(e -> {
// 从事件有效载荷访问数据
String componentText = e.getText();

// 使用 componentText 执行其他操作。
});

这种做法最大限度地减少了查询组件以获取信息的需要,因为数据在事件有效载荷中可以直接获得。通过遵循这种高效的事件处理实践,您可以增强组件的性能和响应能力。有关更多信息,请参考 客户端/服务器交互

示例

以下演示了将 ButtonClickEvent 添加到一个 Button 的过程。这个 Button 还使用事件有效载荷中传递的信息在屏幕上显示信息。

显示代码