阅读数:146 评论数:0

Eclipse application model允许你指定command和handlers。

command和handlers model element的使用是可选的，你可以使用Direct MenuItem或Direct ToolItem model elements。它们定义了对类（handler class）的引用。框架会创建handler的实例，在必要的时候由框架调用其中的注解方法。

一个command就是执行的抽象行为的陈述性行为描述，例如save、edit或copy。Eclipse framework不提供标准的commands。

一个command的行为通过handler定义，一个handler model element指向一个handler class（通过contributionURI属性指定）。

commands被Handled MenuItem和Handled ToolItem model elements使用。

handler的注解和依赖注入

在一个handler class中，只能有一个方法使用@Execute注解，其它方法可以使用@CanExecute注解，当有多个方法使用@CanExecute注解时，框架只会调用其中的一个。Eclipse 在运行时使用依赖注入来为方法提供参数。

（1）@Execute

用于标记handler class对于行为的响应，框架只执行一次这个方法。例如菜单被选择。

（2）@CanExecute

标记一个方法，这个方法会被Eclipse framework访问来检查这个handler class是否可以被执行。如果返回false，Eclipse会禁用相关的用户接口元素。

package com.vogella.tasks.ui.handlers;

// import statements cut out
// ..

public class ExitHandler {
    @Execute
    public void execute(IWorkbench workbench) {
        workbench.close();
    }

    // NOT REQUIRED IN THIS EXAMPLE
    // just to demonstrates the usage of
    // the annotation
    @CanExecute
    public boolean canExecute() {
        return true;
    }

}

一个handler实例没有它自己的Eclipse context，它一般使用当前活动的model element的context，一般情况下是活动的part的context。

使用@Execute注解的方法需要注入所有需要的参数。

为一个command确定相关的handler

当一个command被选择时，在运行时为command确定相关的handler。application model允许你为application、a window和a part创建一个handler。

每一个command在一个给定的域中只会有一个有效的handler，Eclipse 框架会选择最具体的那个handler。例如，"Copy" command有两个handler，一个用于window，另一个用于part，当用户选择时会使用离当前model element最近的那个handler。

菜单快捷键

对于一个菜单，当用户按下alt+其它键时，可以激活菜单。使用&指定快捷键，例如，如果label是&Save，当按下alt+S时会激活save菜单。

command和handler IDs的命名模式

command和handler的IDs应该反应它们的关系，例如你实现了一个command为com.example.contacts.commands.show ID，你应当为handler命令为com.example.contacts.handler.show。如果一个command有多个handler，可以在ID添加一个后缀，例如com.example.contacts.handler.show.details。

常用command的默认IDs