跳至主要内容

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 还使用事件负载中传递来的信息在屏幕上显示信息。

显示代码