BlogJava-nighty-随笔分类-Eclipse

MyEclipse 9.0 安装freemarker编辑器

寒武纪 — Sun, 22 May 2011 14:15:00 GMT

    freemarker几天前才发布了2.3.17版本，5月21号又发布了2.3.18，距2.3.16已经一年多了。老的编辑器已经不能安装在新版本的eclipse和myeclipse上面了，最新的官方编辑器仍在开发阶段，有网友貌似知道最新的源代码链接位置，不过肯定是不稳定的。
    另一个可选的编辑器就是JBoss Tools 3.2中的FreeMarker编辑器，值得安慰，启动MyEclipse9.0后进入MyEclipse Configuration Center --> Software --> add site，输入Name: freemarker,
    URL:   http://download.jboss.org/jbosstools/updates/stable/helios/ 然后在All JBoss Tools 3.2.0下选择FreeMarker IDE，其它的大概你不需要都不用管，也不影响下载时间，然后一路确认安装就OK!

寒武纪 2011-05-22 22:15 发表评论

RssOwl2源码阅读 -- ActionSet

寒武纪 — Thu, 21 Aug 2008 03:29:00 GMT

    ActionSet是Eclipse RCP里面一非常重要的概念，因为菜单、工具栏、上下文菜单、状态栏很多操作都是共享的，所以Action就是用来处理重复出现的东西。至于Eclipse里面定义ActionSet有非常多的技巧，可能无法一一列举，而且使用方法也多种多样。下面介绍的是RssOwl2项目的ui源代码部分的一小块。
   1. 菜单的插入点 -- GroupMarker和Separator的使用
        ApplicationActionBarAdvisor类是定义全局所有Action插入点和入口，查看fillMenuBar(IMenuManager)方法，为了简化，以其中的辅助方法createFileMenu(IMenuManager)为例，讲述一下实现菜单“文件”的内容，先看一下菜单的结构

像Close，Import...之类的非常简单，看一下它是如何实现New这个子菜单的。首先看一下它的源代码如何定义插入点

/* Menu: File */
  private void createFileMenu(IMenuManager menuBar) {
    MenuManager fileMenu = new MenuManager("&File", IWorkbenchActionConstants.M_FILE);
    menuBar.add(fileMenu);

    fileMenu.add(new GroupMarker(IWorkbenchActionConstants.FILE_START));
    fileMenu.add(new GroupMarker(IWorkbenchActionConstants.NEW_EXT));
    fileMenu.add(new Separator());

    fileMenu.add(getAction(ActionFactory.CLOSE.getId()));
    fileMenu.add(getAction(ActionFactory.CLOSE_ALL.getId()));
    fileMenu.add(new GroupMarker(IWorkbenchActionConstants.CLOSE_EXT));
    fileMenu.add(new Separator());
    fileMenu.add(getAction(ActionFactory.SAVE_AS.getId()));
    fileMenu.add(new GroupMarker(IWorkbenchActionConstants.SAVE_EXT));
    fileMenu.add(new Separator());
    fileMenu.add(getAction(ActionFactory.PRINT.getId()));

    fileMenu.add(new Separator());
    fileMenu.add(new GroupMarker(IWorkbenchActionConstants.MB_ADDITIONS));

    fileMenu.add(fReopenEditors); // TODO Consider moving into a "Go" Menu!

    fileMenu.add(new Separator());
    fileMenu.add(new GroupMarker(IWorkbenchActionConstants.FILE_END));
    fileMenu.add(new Separator());

    fileMenu.add(getAction(ActionFactory.QUIT.getId()));
  }

       其中有一行fileMenu.add(new GroupMarker(IWorkbenchActionConstants.NEW_EXT)); 这里是定义一个GroupMarker作为组标记，把子菜单New容纳进来。这个NEW_EXT的值是：new.ext
      现在跳回到plugin.xml去看一下它的ActionSet定义，结构如下：
，点击New(menu)，它的path值为：file/new.ext，这个路径就是在createFileMenu方法定义的路径，第一个是“File”本身的ID。也就是把子菜单New(menu)插入到指定的那个GroupMarker，ID为new.ext。然后定义了三个ID分别为bookmark，newsbin,searchmark,的groupmarker和一个folder的separator，这个三ID分别就对应上面actionSet定义的三个action，以其中的Bookmark（action）为例，它的menubarPath为：file/new_sub/bookmark，代表插入到"File"主菜单中定义的new_sub子菜单中，new_sub是New(menu)的ID。因为folder是定义为separator，所以它会有一条分隔线。这只是RssOwl的定义方法，其实以前自己做开发的时候是没有这样定义的，而且把子菜单New也写在方法fillMenuBar中的，菜单把ID都写在里面，ActionSet的配置就没有子菜单出现了，但是这样定义看起来就比较乱。采用这种写法感觉比较简洁。
    2. Action的实现
       仍以bookmark为例，它的实现类是NewBookMarkAction，实现了IWorkbenchWindowActionDelegate, IObjectActionDelegate二个接口，第一个是ActionSet指定实现接口，第二个是对象操作菜单要求实现的接口（但事实发现没有再定义它的配置，可能是internal版本的原因），也就是说这个Action是多功能，它将会出现在主菜单，工具栏，和局部的右键菜单上。主菜单和工具栏的位置都在ActionSet配置定义了，看看它的右键菜单实现是在哪里的，这个右键是在视图Bookmarks定义的，那么跳转到org.rssowl.ui.internal.views.explorer.BookMarkExplorer类去看看。里面有一个hookContextualMenu()方法，就是定义它的右键菜单的，看一下代码实现：

private void hookContextualMenu() {
    MenuManager manager = new MenuManager();

    /* New Menu */
    MenuManager newMenu = new MenuManager("New");
    manager.add(newMenu);

    /* New BookMark */
    newMenu.add(new Action("Bookmark") {
      @Override
      public void run() {
        IStructuredSelection selection = (IStructuredSelection) fViewer.getSelection();
        IFolder parent = getParent(selection);
        IMark position = (IMark) ((selection.getFirstElement() instanceof IMark) ? selection.getFirstElement() : null);
        new NewBookMarkAction(fViewSite.getShell(), parent, position).run(null);
      }

      @Override
      public ImageDescriptor getImageDescriptor() {
        return OwlUI.BOOKMARK;
      }
    });

   //其它定义
}

     原来实现也很简单，只是往MenuManager里面添加一个Action而已,而且run方法就是直接调用定义好的NewBookMarkAction的run方法，但是把选中对象做为参数传进去，因为这个new是涉及当前上下文选择对象的。
    3. 下拉类型的工具按钮定义
    非常常见的Dropdown类型的工具栏按钮可以把功能类型的按钮归为一类，做成一个下拉菜单形式，有默认的按下功能，也有可以选择其它类似功能的下三角形式，样子如下：

    这个dropdown的Action是定义在ActionSet配置里的。style是pulldown类型的，所以实现类NewTypeDropdownAction实现了IWorkbenchWindowPulldownDelegate接口，它的run方法就是定义默认点击不做选择时的事情，这个下拉菜单是实现getMenu(Control parent)方法而来，它定义了如何生成这个菜单，这就用到了最原始的SWT中的MenuItem了，并且为它们添加SelectionListener，方法实现，不用说都知道了，又是New一个先前定义好的NewBookMarkAction类，然后又是调用它的run方法。所以总结一下，Action的重用不一定是这个类的重用，关键是它的run方法的重用，在不同的场景下它的外在表现形式可能会多种多样，但是它的run内容是一致的。像添加这种添加的run大部分时候都是弹出一个对话框，而对话框大都又是Winzard类型的，因为Winzard可以共享放到dialog里面。所以这种复用的思想在Eclipse里面随处可见。
   归结一下，其实这些技巧都是次要的，因为做GUI一个比较痛苦的事情就是经常要写很多重复类似的代码，抽取的不好，可能就变得不伦不类了。怎么利用它的这种思想，把复用的代码都抽取在一起，而阅读起来又比较轻松才是关键。
   知道的就这些，先介绍到这里，下次再谈谈其它新的发现。

寒武纪 2008-08-21 11:29 发表评论

学习RssOwl2中的添加隐藏工具栏和状态栏的功能

寒武纪 — Thu, 31 Jul 2008 07:13:00 GMT

摘要: 许久没有弄RCP了，刚好近来闲暇一点，找来个RSSOwl的源代码看看，有点收获。RssOwl非常出名，只是可能很多人不知道它是用Java做的。以前看过RssOwl第一版的源码，没有详细研究，down下来之后放上公司的共享CVS服务器，倒是几个同事饶有兴趣地研究起来。第一个版本写得较早，可能Eclipse的RCP框架都还没有出来，所以全部采用的SWT/JFace... 阅读全文

寒武纪 2008-07-31 15:13 发表评论

Eclipse3.3安装中文语言包

寒武纪 — Fri, 30 May 2008 07:44:00 GMT

   Eclipse3.3出来很久了，一直都使用英文版，刚好看到有网友介绍Eclipse的一个Project，叫Babel，官方的描述这样：Eclipse is a global community. It is in everyone's interest to ensure that Eclipse is available and translated in as many locales as possible. 项目的主页地址是：http://www.eclipse.org/babel/ 。按照说明从这里可以下载安装到语言包。
   直接从Eclipse3.3的菜单"Help --> Software Updates --> Find and Insatll..."，新建一个远程站点，URL为 http://download.eclipse.org/technology/babel/update-site/ ，然后直接在线安装。在弹出的语言选择界面上选择中文简体。如下图：

    网络情况如果正常的话，安装应该不会有问题的，中间可能会弹出几次下载jar文件失败的对话框，继续retry就行。

    最后重启一下，可以看到都变成中文界面的。


原来是3.3的Eclipse，怎么变成3.2呢？原因估计是语言插件的版本是3.2的导致的，所以你看到有一些地方汉化并不完全，像Error Log视图的标题，项目右键菜单，以及一些顶级菜单都没有完全汉化。
希望以后Babel项目后面更新跟得上主版本的变化，不过习惯了英文版的，其实也是差不多的。

寒武纪 2008-05-30 15:44 发表评论

保存你的RCP视图状态

寒武纪 — Tue, 30 Oct 2007 07:51:00 GMT

摘要: 每当做开发的时候，你有可能在一次调试程序的过程中打开很多个编辑器，或是对Eclipse默认的视图布局不满意，手工作了一些调整。如果在工作的过程你因为有事离开或是不小心把Eclipse关掉了，不用担心，在你下次打开的时候，Eclipse仍然会为您记住上次的工作场景。下面是一个例子场景: ... 阅读全文

寒武纪 2007-10-30 15:51 发表评论

添加完整的Eclipse RCP帮助系统

寒武纪 — Thu, 25 Oct 2007 02:30:00 GMT

    开发基于Eclipse开的RCP软件可以直接加入Eclipse的帮助系统，使您的产品更加完善。Eclipse帮助系统提供的良好组织模式以及基于lucene的全文搜索功能。在Eclipse的网站上有一篇文章专门介绍如何为Mail示例RCP添加帮助系统的，但是写的不完全，按照里面的说明添加后无法正常地显示帮助框架。网上有少部分文章也提及这个主题，但是都没有说明白。
    经过一翻摸索，最后终于折腾出来，在这里记录下面，与大家分享。如果你做过RCP产品，下面这些内容应该很熟悉。
    1. 添加帮助的菜单。
       在ApplicationActionBarAdvisor类中加入帮助菜单项。代码片断如下：

//帮助
    private IWorkbenchAction helpAction;

    /**
     * 创建操作
     */
    protected void makeActions(IWorkbenchWindow window) {
        ....

        /* 帮助 */
        .....
        helpAction = ActionFactory.HELP_CONTENTS.create(window);
        register(helpAction);
        .....
     }

    /**
     * 填充主菜单
     */
    protected void fillMenuBar(IMenuManager menuBar) {
        /* 主菜单栏 */
        IMenuManager mainMenu = getActionBarConfigurer().getMenuManager();

        MenuManager helpMenu = new MenuManager("帮助(&H)", IWorkbenchActionConstants.M_HELP);
        helpMenu.add(introAction);
        helpMenu.add(helpAction);
        ....


        mainMenu.add(helpMenu);
    }

2. 添加相关的依赖项。
打开plugin.xml，转到"依赖项"的tab页,点击"添加"按钮，需要加入下面的这些依赖项：

1. org.apache.lucene 2.org.eclipse.help.appserver 3.org.eclipse.help.base 4.org.eclipse.help.ui 5.org.eclipse.help.webapp 6.org.eclipse.tomcat 7.org.eclipse.ui.forms

    3. 添加org.eclipse.help.toc扩展点
       这个非常容易，转到"扩展"tab页，点击“添加”按钮。网上或是相关的书籍有很多关于添加help内容的介绍，为了节省篇幅，这里直接添加一个扩展向导来完成。选择"扩展向导"-->"帮助内容"，确定后可以看到“所有扩展”的列表中多了一个org.eclipse.help.toc扩展，这里可能需要修改一下，生成的toc.xml和testToc.xml里面的label属性标签不能是乱码，不然帮助框架会读不出，到时候显示不出帮助的组织结构。
       结构如下：

<extension
         point="org.eclipse.help.toc">
      <toc file="toc.xml"/>
      <toc
            file="testToc.xml"
            primary="true"/>
   extension>

    4. 部署产品配置
       为您的RCP添加一个产品配置，打开产品配置编辑器（xxx.product），转到"配置"tab页，点击“添加”，加入你的插件，然后点击“添加必需的插件”,这样在“插件和段”列表会看到你的插件以及你的RCP要完整启动的所有必需相关插件。在这里你应该看到你在plugin.xml中依赖的那七个help相关的插件，以及一些以nl1结尾的插件，这些是语言插件。保存，转到“概述”tab页，点击"启动产品"。然后打开“帮助--> 帮助内容”，就可能看到你的帮助系统了。
    到此一个完整的帮助系统就完成了。下面是一个截图：

寒武纪 2007-10-25 10:30 发表评论

一个ActionDelegate代理多个Action

寒武纪 — Wed, 15 Aug 2007 01:55:00 GMT

摘要: 阅读全文

寒武纪 2007-08-15 09:55 发表评论