继承PageBookView实现自己的“属性视图”-白红宇

很多Eclipse应用程序在提供一个Editor的同时还提供一些View，这些View监视Editor的Selection，提供一些上下文相关的信息。Eclipse自带的PropertySheet（属性视图）就是这样一个例子，Outline（大纲视图）也是如此，从功能上看，不妨把这类用途的视图称为“广义的属性视图”。

以前我都是直接继承ViewPart来实现自己的属性视图的，但我发现要花不少功夫在处理View与Editor的协调上。例如当Editor被关闭时，View里的信息也应该隐藏，切换Editor时也需要进行处理，等等。最近看一个项目的代码时发现他们是继承org.eclipse.ui.part.PageBookView来实现同样功能的，就像PropertySheet所做的一样，效果很不错，而且需要自己写的代码量不是很多，因为PageBookView里已经帮助处理了以上提到的大部分功能。因此这里介绍一下使用PageBookView的方法供大家参考。

顾名思义，PageBookView是这样一种View，它就像一本书，里面可以容纳多个Page，但同一时间只给用户显示一个Page。PageBookView负责根据当前活动的WorkbenchPart切换到合适的Page，实际显示的内容主要由Page提供，这些Page一般是通过WorkbenchPart的getAdapter()方法提供的。

继承PageBookView实现自己的属性视图时，PageBookView子类的实现几乎是固定的，如果你的View与WorkbenchPart里的Selection有关（上下文敏感），则继承PageBookView的时候应顺便实现ISelectionListener，然后在init()方法里注册自己为WorkbenchPage的选择监听器，并在selectionChanged()方法里把事件转发给当前显示的Page，下面的代码是一个典型的上下文敏感的PageBookView子类：

import org.eclipse.jface.viewers.ISelection;import org.eclipse.swt.widgets.Composite;import org.eclipse.ui.IEditorPart;import org.eclipse.ui.ISelectionListener;import org.eclipse.ui.IViewSite;import org.eclipse.ui.IWorkbenchPage;import org.eclipse.ui.IWorkbenchPart;import org.eclipse.ui.PartInitException;import org.eclipse.ui.part.IPage;import org.eclipse.ui.part.IPageBookViewPage;import org.eclipse.ui.part.MessagePage;import org.eclipse.ui.part.PageBook;import org.eclipse.ui.part.PageBookView;public class ExampleView extends PageBookView implements ISelectionListener{    public ExampleView() {    }    @Override    protected IPage createDefaultPage(PageBook book) {        MessagePage page = new MessagePage();        initPage(page);        page.createControl(book);        page.setMessage("An example view is not available.");        return page;    }    @Override    public void init(IViewSite site) throws PartInitException {        super.init(site);        site.getPage().addSelectionListener(this);    }    @Override    public void dispose() {        getSite().getPage().removeSelectionListener(this);        super.dispose();    }    @Override    protected PageRec doCreatePage(IWorkbenchPart part) {        // Try to get a custom page        Object obj = part.getAdapter(IExamplePage.class);        if (obj instanceof IExamplePage) {            IExamplePage page = (IExamplePage)obj;            if (page instanceof IPageBookViewPage)                 initPage((IPageBookViewPage)page);            page.createControl(getPageBook());            return new PageRec(part, page);        }        // Use the default page        return null;    }    @Override    protected void doDestroyPage(IWorkbenchPart part, PageRec pageRecord) {        IExamplePage page = (IExamplePage) pageRecord.page;        page.dispose();        pageRecord.dispose();    }    @Override    protected IWorkbenchPart getBootstrapPart() {        IWorkbenchPage page = getSite().getPage();        if (page != null)            return page.getActiveEditor();        else            return null;    }    @Override    protected boolean isImportant(IWorkbenchPart part) {        return (part instanceof IEditorPart);    }    @Override    public void createPartControl(Composite parent) {        super.createPartControl(parent);    }    public void selectionChanged(IWorkbenchPart part, ISelection selection) {        // we ignore our own selection or null selection        if (part == this || selection == null) {            return;        }        // pass the selection to the page        if (!(getCurrentPage() instanceof IExamplePage))            return;        IExamplePage page = (IExamplePage) getCurrentPage();        if (page != null) {            page.selectionChanged(part, selection);        }    }}

在上面这个View里，createDefaultPage()方法创建的Page是当活动WorkbenchPart不是我们所关心类型时所显示的信息，由MessagePage实现；isImportant()规定了这个View对什么样的WorkbenchPart感兴趣，在上面的例子里是只处理IEditorPart，作为对照，Eclipse的PropertySheet对所有类型的WorkbenchPart都有兴趣，除了它自己；如果活动WorkbenchPart是"Important"的，并且通过它的getAdapter()方法能得到我们需要的Page，则这个Page会显示在这个View里，否则还将显示缺省的MessagePage。

现在来看一下怎样实现自己的Page。一般要先定义一个继承自IPage的接口，它的一个作用是给WorkbenchPart#getAdapter()方法作为参数以标识我们需要的Page类型，如果前面PageBookView子类已经实现了ISelectionListener则它多半也要实现此接口，如下所示：

import org.eclipse.ui.ISelectionListener;import org.eclipse.ui.part.IPage;public interface IExamplePage extends IPage, ISelectionListener{}

然后是具体的Page类，这个类其实和以前我们实现ViewPart的代码很相似，它继承自org.eclipse.ui.part.Page并实现刚才定义的接口，最重要的当然就是createControl()方法，如果需要还有selectionChanged()方法：

import org.eclipse.swt.SWT;import org.eclipse.swt.widgets.Composite;import org.eclipse.swt.widgets.Control;import org.eclipse.ui.part.Page;/** * @author zhanghao * */public class ExamplePage extends Page implements IExamplePage {    Text txtName;    public ExamplePage() {        super();    }    @Override    public void createControl(Composite parent) {        //Create your autual view UI here        txtName = new Text(parent, SWT.BORDER);    }    @Override    public Control getControl() {        return txtName;    }    @Override    public void setFocus() {    }    public void selectionChanged(IWorkbenchPart part, ISelection selection) {        String name = ; //Get information from selection        txtName.setText(name);    }}

补充一点，每个Page具有独立的ActionBar，也就是说要为PageBookView添加菜单或工具条项应该在Page里完成，一般实现在init()方法里。

现在还差一个步骤没做，那就是要在WorkbenchPart的getAdapter()方法里对这个View做出反应（这要求WorkbenchPart可访问自定义的Page类），典型情况下我们用自己的Page接口作为参数，代码类似下面这样：

public Object getAdapter(Class type) {    if (type == IExamplePage.class) {        return new ExamplePage();    }    return super.getAdapter(type);}

当然，和以前一样还是要在plugin.xml里注册这个View，以便使用者能够在Eclipse里通过"Window->Show View"菜单命令把它显示出来。

最后，和PropertySheet相比，这样的实现还有一个小缺陷，那就是第一次打开这个View的时候不能显示Editor里当前选择的信息，大家不妨试着解决这个问题。（提示：参考PropertySheet的partActivated()方法）

本文转自博客园八进制的博客，原文链接：，如需转载请自行联系原博主。