如何通过命令在Help菜单添加Cheat Sheets项并解决转换错误

这个问题很典型——Eclipse从ActionSet迁移到Commands时，最容易踩的就是旧IAction和新IHandler的类型适配坑。你遇到的org.eclipse.ui.internal.cheatsheets.actions.CheatSheetHelpMenuAction cannot be cast to org.eclipse.core.commands.IHandler错误，本质是因为CheatSheetExtensionFactory:helpMenuAction返回的是旧的IAction实现类，而Commands系统要求绑定的是IHandler接口的实现，直接绑定肯定不兼容。

既然你不想新建包含业务逻辑的Handler，那我们只需要做一个无业务的桥接适配就行，下面给你两种极简方案：

方案一：极简委托Handler（几乎无代码） #

创建一个超轻量的Handler类，只负责调用旧Action的run()方法，完全复用原有业务逻辑：

package org.eclipse.ui.cheatsheets;

import org.eclipse.core.commands.AbstractHandler;
import org.eclipse.core.commands.ExecutionEvent;
import org.eclipse.core.commands.ExecutionException;
import org.eclipse.jface.action.IAction;

public class CheatSheetHandler extends AbstractHandler {

    @Override
    public Object execute(ExecutionEvent event) throws ExecutionException {
        // 直接复用原工厂类创建的旧Action实例
        IAction cheatSheetAction = CheatSheetExtensionFactory.createHelpMenuAction();
        if (cheatSheetAction != null) {
            cheatSheetAction.run();
        }
        return null;
    }
}

然后更新你的命令配置，把defaultHandler指向这个新类：

<extension point="org.eclipse.ui.commands">
  <command 
    defaultHandler="org.eclipse.ui.cheatsheets.CheatSheetHandler"
    id="org.eclipse.ui.cheatsheets.actions.CheatSheetHelpMenuAction" 
    name="Cheat sheets">
  </command>
</extension>

你的menuContribution配置可以保持不变，不需要修改。

方案二：用Eclipse内置ActionHandler+工厂类桥接 #

如果你连上面这个极简类都不想写，可以用Eclipse官方提供的ActionHandler（它本身就是IHandler的实现类，专门用来桥接旧IAction），配合一个简单的工厂类来创建实例：

1. 先创建一个工厂类，负责生成包装了旧Action的ActionHandler：

package org.eclipse.ui.cheatsheets;

import org.eclipse.core.runtime.CoreException;
import org.eclipse.core.runtime.IExecutableExtensionFactory;
import org.eclipse.jface.action.IAction;
import org.eclipse.ui.handlers.ActionHandler;

public class CheatSheetHandlerFactory implements IExecutableExtensionFactory {

    @Override
    public Object create() throws CoreException {
        // 复用原工厂类创建旧Action，再用ActionHandler包装成IHandler
        IAction action = CheatSheetExtensionFactory.createHelpMenuAction();
        return new ActionHandler(action);
    }
}

2. 然后更新命令配置，把defaultHandler指向这个工厂类：

<extension point="org.eclipse.ui.commands">
  <command 
    defaultHandler="org.eclipse.ui.cheatsheets.CheatSheetHandlerFactory"
    id="org.eclipse.ui.cheatsheets.actions.CheatSheetHelpMenuAction" 
    name="Cheat sheets">
  </command>
</extension>

这两种方案都完全复用了你原来的Cheat Sheet业务逻辑，只是做了一层类型适配，没有新增任何业务代码，完美符合你“不想新建handler”的需求。

内容的提问来源于stack exchange，提问作者user9838627