Eclipse RCP中Viewer交互的三种方式/Make your Eclipse applications richer with view linking

时间:2023-01-12 22:11:17

简介

      Eclipse平台的插件机制可以使用户方便的创建GUI程序。例如,插件可以给GUI提供Views(查看器)。这些UI的View需要和其他组件关联才能真正发挥发挥作用,否则将形成“孤岛”。

    以下图所示的一个旅游景点介绍的GUI应用程序为例,这个GUI程序将景点列表View和景点介绍View关联在一起,当在景点列表View中选择不同的旅游景点时,景点介绍View会显示相应的介绍。

Eclipse RCP中Viewer交互的三种方式/Make your Eclipse applications richer with view linking

    本文将介绍Eclipse中的View如何与其他View进行交互的三种方式,并分析在不同的情况下这几种方式的优劣。Eclipse开发人员可以使用下面这三种方式来关联View

1 “选择提供者 -- 选择监听者”模式。

2 结合一些事件(Events)使用IAdapatble接口

3 属性变化监听器,它可以在属性变化事将事件推送(Push)到注册的监听器中。

选择提供者 -- 选择监听者”模式

“选择提供者 -- 选择监听者”模式可以使一个View来响应其他View的变化。例如,当用户点击景点列表View的一个城市名时,其他view想获得这个悬着事件并作出响应。这些VIew需要UI Selection对象中的信息(比如表示城市名称的一个String)并使用这些信息来从模型中获取其他相关信息

View应该具备识别和使用UI Selection事件对象的能力。org.eclipse.ui.ISelectionListener是一个用于监听UI选择事件的监听器接口。选择事件监听器必须在workbench page中注册。Workbench page实现rg.eclipse.ui.ISelectionService接口定义的service,将UI Selection事件发送到监听器中。选择事件监听器必须和一个选择服务一起注册。

能被选择的UI View具备发布UI selection事件的能力,view可以通过在他们各自的workbench site中注册“selection provider”来实现这一点。Eclipse中的每一个UI View都通过org.eclipse.ui.IWorkbenchPartSite workbench site相关联。Selection provider是在workbench site中注册的。

views使用“选择提供者 -- 选择监听者”模式关联起来之后,一个viewworkbench page中注册为监听器,其他的view若要发布selection事件,则需在各自的workbench site中注册为selection providerorg.eclipse.ui.ISelectionListener 接口签名如下所示:

public void selectionChanged(IWorkbenchPart part, ISelection selection);

    若要使一个view可以监听选择变化事件,此View必须实现ISelectionListener 接口并在workbench中进行注册,如下面的代码所示:

public class MyView extends ViewPart implements  ISelectionListener{
public void createPartControl(Composite parent) {
// add this view as a selection listener to the workbench page
getSite().getPage().addSelectionListener((ISelectionListener) this);
}
// Implement the method defined in ISelectionListener, to consume UI selections
public void selectionChanged(IWorkbenchPart part, ISelection selection) {
//Examine selection and act on it!
}
}

   更好的方式是指定所监听的View,只需将目标ViewID作为第一个参数传递过去就可以实现,如下所示:

getSite().getPage().addSelectionListener("SampleViewId",(ISelectionListener)this);

    下面的代码展示了如何将一个view中的tableviewer注册为workbench site中的selection provider。注册后在view中的tableviewerUI selection变化将被相应的监听器获得。

public void createPartControl(Composite parent) {
// Set up a JFace Viewer
viewer = new TableViewer(parent, SWT.MULTI | SWT.H_SCROLL | SWT.V_SCROLL);
viewer.setContentProvider(new ViewContentProvider());
viewer.setLabelProvider(new ViewLabelProvider());
viewer.setSorter(new NameSorter());
viewer.setInput(getViewSite());

// ADD the JFace Viewer as a Selection Provider to the View site.
getSite().setSelectionProvider(viewer);
}

这个view将它创建的TableViewer注册为selection provider是因为:

1 这个view将使用tableviewer来显示信息,用户将与TableViewer交互

2 TableViewer实现了selection provider接口,可以将选择事件发布到workbench part site中。

    JFace viewer都是选择事件提供者,因此您在使用它们时不需要创建一个选择事件提供者。一个View仅仅需要在其中使用JFace Viewer并将其注册为selection provider即可实现选择事件的发布。

我们需要不同的关联方法

    尽管“选择提供者 -- 选择监听者”模式使用方便并且能满足大多数的需求,但由于以下原因,我们仍需要一种不同的方式来关联视图:

信息量超过了UI selection对象的承载力。

View需要发布处理后的信息而不仅仅是选择对象信息。

View需要监听一个不包含JFace viewer对象的View

您可以使用org.eclipse.core.runtime.IAdaptable接口来解决第一个问题,这个接口可以使一个选择事件对象承载更多的信息。需求23则需要程序员做更多的工作,也许“属性变化监听器模式”更适用于那种需求。

使用IAdaptable 接口

实现IAdaptable接口的类可以动态地根据需求返回不同适配器,这些适配器可以用来获取更多的信息。若一个viewer中的selection对象实现了IAdaptable接口,那么它可以使用不同类适配器来提供更多信息。org.eclipse.core.runtime.IAdaptable接口的签名如下:

public void object getAdapter(Class adapter);

    很明显,调用者应该知道自己所需要的适配器类型。例如一个以单层树的形式来提供城市列表的TableViewer,其中表示城市的类为CityClass。CityClass对象应该包含一些有关这个城市的基本信息,并只有在需要的时候才返回详细的信息。在下面的代码中,CityClass实现了不同类型的适配器,从而可以根据需要来提供不同的信息。

class CityClass implements IAdaptable { 
private String cityName;

public CityClass(String name) {
this.name = name;
}
public String getName() {
return name;
}
public CityClass getParent() {
return parent;
}
public String toString() {
return getName();
}

public Object getAdapter(Class key) {
if (key.getName().equals("ITransportationInfo"))
return CityPlugin.getInstance().getTransportAdapter();
else (key.getName().equals("IPlacesInfo"))
return CityPlugin.getInstance().getPlacesAdapter();
return null;
}
}

熟悉Eclipse IDE开发者应该了解其中的Outline View,这个View显示了在editor中打开的文件的结构。Outline View这个例子展示了通过使用IAdaptable接口和一些特定的事件类型,如何根据其他view的内容来初始化一个view。一个editor必须为打开的文件创建一个Outline page,这个内容Outline pageIContentOutlinePage接口相关。Editor实现IAdaptable接口之后,便可以提供相关的适配器来作为IContentOutlinePage来使用。

另一个IAdaptable的例子是Properties ViewProperties View追踪活跃的part并在当前选择对象上调用getAdapter()方法。所需的适配器类型为IPropertySourceProperties View从而可以使用IPropertySource适配器来获取属性信息并显示。

在这些视图关联的例子中,应用程序在发生Selection changePart Activation通知时通过IAdaptable接口来获取信息。因此,如果selectionIAdaptable的,用户可以通过适配器来获取更多的信息。

属性变化监听器模式

您可以使用“属性变化监听器模式”来解决前面所说的第23个问题:一个View如何从一个非UI view中获取信息,以及一个View如何发布在选择事件发生后经过处理后的信息。

    您可以创建一个插件来接受注册属性变化监听器的注册,并在需要时通知所注册的插件。应用程序可以创建选择事件并通知监听器,从而使ViewUI View中获取信息。与selection provider不同,property change provider并不需要实现某个特定的接口。你必须自己定义注册的监听器和创建的provider的语义。下面的代码显示了如何在property provider view或插件中添加或删除property change监听器。


//To add a listener for property changes to this notifier:
public void addPropertyChangeListener(IPropertyChangeListener listener);
//To remove the given content change listener from this notifier:
public void removePropertyChangeListener(IPropertyChangeListener listener);

Property provider将使用org.eclipse.jface.util.PropertyChangeEvent 来创建一个可以发布的Event。同时,使用者将维护一个监听器列表,并对property provider提供回调功能。例如,一个每隔一小时从世界气候服务获取城市气象信息的插件,希望将这些气象信息与其他View分享。CityWeatherPlugin 可以暴露一个名为CitiesWeatherXML的服务,需要这些信息的view则将作为Property Change监听器注册到CityWeatherPlugin 中。为了实现这个,监听器必须知道CityWeatherPlugin 中将监听器注册为监听气候信息监听器的方法。CityWeatherPlugin 将负责记录并通知所有注册的监听器,它使用PropertyChangeEvent 对象来给这些监听器提供信息。

class CityPopulationPlugin {
ArrayList myListeners;
// A public method that allows listener registration
public void addPropertyChangeListener(IPropertyChangeListener listener) {
if(!myListeners.contains(listener))
myListeners.add(listener);
}
// A public method that allows listener registration
public void removePropertyChangeListener(IPropertyChangeListener listener) {
myListeners.remove(listener);
}
public CityPopulationPlugin (){
// method to start the thread that invokes the population web service once every hour
// and then notifies the listeners via the propertyChange() callback method.
initWebServiceInvokerThread( myListeners );
}

void initWebServiceInvokerThread(ArrayList listeners) {
// Code to Invoke Web Service Periodically, and retrieve information
// Post Invocation, inform listeners
for (Iterator iter = listeners.iterator(); iter.hasNext();) {
IPropertyChangeListener element = (IProperty ChangeListener) iter.next();
element.propertyChange(new PropertyChangeEvent(this, "CitiesWeatherXML" , null , CityWeatherXMLObj));
}
}
}

    Property change监听器必须实现 org.eclipse.jface.util.IPropertyChangeListener接口来使property change provider可以使用回调函数。这个接口有一个方法:public void propertyChange(PropertyChangeEvent event).

class MyView implements IPropertyChangeListener {
public void createPartControl() {
//register with a Known Plugin that sources Population Data
CityPopulationPlugin.getInstance().addPropertyChangeListener(this);
}
public void propertyChange(PropertyChangeEvent event) {
//This view is interested in the Population Counts of the Cities.
//The population data is being sourced by another plugin in the background.
if( event.getProperty().equals("CitiesWeatherXML")) {
Object val = event.getNewValue();
// do something with val
}
}
}

这种方法使应用程序可以在任何时刻通知监听器并通过自定义的Event传给他们信息。这些信息并不需要和UI selection有什么关系,可以是经过一些处理后的信息。例如它可以包含后台任务的描述或某个模型中包含的信息。例如,City Selector View可以不仅提供选择的城市信息,而且可以异步地将当前选择的城市气候信息推送到其他注册的View

总结

    本文讨论了几种使View相互关联的方法。如果UI selection不能满足您的需求,那么可以考虑使用IAdaptable接口。属性变化监听器模式则更为灵活,尤其适用于包含非UI场景。


原文地址:http://www.ibm.com/developerworks/opensource/library/os-ecllink/