3.5.5.4. 基础操作

BaseAction 是所有操作实现的基类。当声明式创建操作不能满足需求时，建议从这个类派生自定义操作。

在创建自定义操作类时，应该实现 actionPerform() 方法并将操作标识符传递给 BaseAction 构造函数。可以重写任何属性的 getter 方法： getCaption() 、 getDescription() 、 getIcon() 、 getShortcut() 、 isEnabled() 、 isVisible() 、 isPrimary()。除了 getCaption() 方法之外，这些方法的标准实现返回由 setter 方法设置的值。如果操作名称未通过 setCaption() 方法显式设置，则它使用操作标识符作为键从与操作类包对应的本地化消息包中检索消息。如果没有带有这种键的消息，则返回键本身，即操作标识符。

或者，可以使用流式 API 设置属性并提供 lambda 表达式来处理操作：请参阅 withXYZ() 方法。

BaseAction 可以根据用户权限和当前上下文更改其 enabled 和 visible 属性。

如果满足以下条件，则 BaseAction 是可见的：

• setVisible(false) 方法没有被调用；

• 此操作没有 **hide** UI 权限；

如果满足以下条件，则该操作被启用：

• setEnabled(false) 方法没有被调用；

• 此操作没有 **hide** 或只读 UI 权限；

• isPermitted() 方法返回 true。

• isApplicable() 方法返回 true。

用法示例：

• Button 操作：

  @Inject
  private Notifications notifications;
  @Inject
  private Button helloBtn;
  @Subscribe
  protected void onInit(InitEvent event) {
      helloBtn.setAction(new BaseAction("hello") {
          @Override
          public boolean isPrimary() {
              return true;
          }
          @Override
          public void actionPerform(Component component) {
              notifications.create()
                      .withCaption("Hello!")
                      .withType(Notifications.NotificationType.TRAY)
                      .show();
          }
      });
      // OR
      helloBtn.setAction(new BaseAction("hello")
              .withPrimary(true)
              .withHandler(e ->
                      notifications.create()
                              .withCaption("Hello!")
                              .withType(Notifications.NotificationType.TRAY)
                              .show()));
  }

  在这个例子中，helloBtn 按钮标题将被设置为位于消息包中的带有 hello 键的字符串。可以重写 getCaption() 操作方法以不同的方式初始化按钮名称。

• 以编程方式创建PickerField的操作：

  @Inject
  private UiComponents uiComponents;
  @Inject
  private Notifications notifications;
  @Inject
  private MessageBundle messageBundle;
  @Inject
  private HBoxLayout box;
  @Subscribe
  protected void onInit(InitEvent event) {
      PickerField pickerField = uiComponents.create(PickerField.NAME);
      pickerField.addAction(new BaseAction("hello") {
          @Override
          public String getCaption() {
              return null;
          }
          @Override
          public String getDescription() {
              return messageBundle.getMessage("helloDescription");
          }
          @Override
          public String getIcon() {
              return "icons/hello.png";
          }
          @Override
          public void actionPerform(Component component) {
              notifications.create()
                      .withCaption("Hello!")
                      .withType(Notifications.NotificationType.TRAY)
                      .show();
          }
      });
      // OR
      pickerField.addAction(new BaseAction("hello")
              .withCaption(null)
              .withDescription(messageBundle.getMessage("helloDescription"))
              .withIcon("icons/ok.png")
              .withHandler(e ->
                      notifications.create()
                              .withCaption("Hello!")
                              .withType(Notifications.NotificationType.TRAY)
                              .show()));
      box.add(pickerField);
  }

  在此示例中，匿名 BaseAction 派生类用于设置选择器字段按钮的操作。不显示按钮标题，而是在光标悬停在按钮时弹出的带有描述的图标。

• Table操作：

  @Inject
  private Notifications notifications;
  @Inject
  private Table<Customer> table;
  @Inject
  private Security security;
  @Subscribe
  protected void onInit(InitEvent event) {
      table.addAction(new HelloAction());
  }
  private class HelloAction extends BaseAction {
      public HelloAction() {
          super("hello");
      }
      @Override
      public void actionPerform(Component component) {
          notifications.create()
                  .withCaption("Hello " + table.getSingleSelected())
                  .withType(Notifications.NotificationType.TRAY)
                  .show();
      }
      @Override
      protected boolean isPermitted() {
          return security.isSpecificPermitted("myapp.allow-greeting");
      }
      @Override
      public boolean isApplicable() {
          return table != null && table.getSelected().size() == 1;
      }
  }

  在此示例中，声明了 HelloAction 类，它的实例被添加到表格的操作列表中。对具有 **myapp.allow-greeting** 安全权限的用户启用该操作且仅在只选择了表格中的一行时启用。后面这个选中一行启用能有效，是因为 BaseAction 的 target 属性会在操作添加到 ListComponent 的继承者（Table 或者 Tree）时被自动设置。

• 如果需要一个在选择一行或多行时启用的操作，请使用 BaseAction 的子类 - ItemTrackingAction，它添加了 isApplicable() 方法的默认实现：

  @Inject
  private Table table;
  @Inject
  private Notifications notifications;
  @Subscribe
  protected void onInit(InitEvent event) {
      table.addAction(new ItemTrackingAction("hello") {
          @Override
          public void actionPerform(Component component) {
              notifications.create()
                      .withCaption("Hello " + table.getSelected().iterator().next())
                      .withType(Notifications.NotificationType.TRAY)
                      .show();
          }
      });
  }