Eclipse中的IAdaptable阐明

副标题#e#

Java是一种强范例语言，每个实例都必需有指定的范例。实际上，Java范例有两种声明范例和 运行时范例 (也可以相应的说是静态范例 和动态范例 ). 像Python这样的弱范例语言凡是称为无范例，可是这样说并不严谨，因为每个实例都有它的运行时范例。你只是不消事先声明一个实例的范例罢了。

要想挪用一个工具中的要领，这个要领需要在声明范例中存在。也就是说，你只能挪用界说在父类中的要领，纵然该实例是一个确定的子范例：

List list = new ArrayList();
list.add("data"); // 在这里没问题
list.ensureCapacity(4); // 这里就不可了ensureCapacity() 只在ArrayList中才有。

假如我们要挪用实际范例中的要领，我们首先要将它转为正确的范例。在本例中，我们可以把 ArrayList 转为List,因为ArrayList实现了List 接口. 也可以在运行时动态的检讨，利用 list instanceof ArrayList.

可扩展的接口

糟糕的是，一个类不能老是实现你所需要实现的接口。大概是因为这只对少数几种环境才有效，可能它是一个没有被关联的库中的范例，可能这个接口在后期又被改变了。

这种环境就可以利用IAdaptable。 你可以把 IAdaptable 动态的举办范例转化。利用如下要领制止直接的范例转化:

Object o = new ArrayList();
List list = (List)o;

我们可以这样做:

IAdaptable adaptable = new ArrayList();
List list = (List)adaptable.getAdapter(java.util.List.class);

你可认为它是一种范例动态转化; 我们把adaptable转为List实例。

为什么不直接转化，而要用特另外getAdapter() 呢?这种机制可以使我们将方针类转化为没有实现的接口。譬喻， 我们大概想利用HashMap 作为一个 List, 尽量他们并不兼容。

IAdaptable adaptable = new HashMap();
List list = (List)adaptable.getAdapter(java.util.List.class);

实现IAdaptable

大大都IAdaptable的实现看起来就想是为支持范例结构多个if表达式的叠加。假如要为HashMap实现getAdapter() 可以这样:

public class HashMap implements IAdaptable {
　 public Object getAdapter(Class clazz) {
　　 if (clazz == java.util.List.class) {
　　　 List list = new ArrayList(this.size());
　　　 list.addAll(this.values());
　　　 return list;
　　 }
　　 return null;
　 }
　 // ...
}

返回的是一个对自身的署理，而不是直接转化范例。假如请求的是不支持的范例，可以直接返回null表白失败，这样比抛出异常要好。

#p#副标题#e#

PlatformObject

当你想添加新的要扩展的范例时，只是简朴的修改一下就可以了。在任何环境下，假如已经获得了范例，为什么不修改接口？不修改类（假如利用接口，不容易担保向后兼容）可能改变它的范例（HashMap不是 List，可是可以转化）是有原因的。要办理这个问题，在Eclipse中，利用了一个抽象类 PlatformObject。它为你实现了 IAdaptable接口，你就可以不消再劳神了。

PlatformObject 署理所有的它对getAdapter()的请求到 IAdapterManager. IAdapterManager是平台默认提供的，通过 Platform.getAdapterManager()来会见。你可以将它想象为一个庞大的 Map ，它认真关联类和适当的适配器。PlatformObject的 getAdapter() 要领可以会见到这个Map.

适配已存在的类

这样的长处是可觉得每一个PlatformObject工具动态的关联新的适配器，而不消从头编译。在Eclipse中的许多处所都是这样来支持扩展的。

这里但愿将装有String的List转为XML节点。 XML节点显示为:

<List>
<Entry>First String</Entry>
<Entry>Second String</Entry>
<Entry>Third String</Entry>
</List>

因为List的toString要领大概有此外用途，所以不能利用。 可觉得List添加一个工场，当有转为XML节点的请求时，一个Node工具就会自动返回。

这里需要3个步调:

1. 从List中生成Node

利用IAdapterFactory 来封装转换机制:

import nu.xom.*;
public class NodeListFactory implements IAdapterFactory {
　 /** The supported types that we can adapt to */
　 private static final Class[] types = {
　　 Node.class,
　 };
　 public Class[] getAdapterList() {
　　 return types;
　 }
　 /** The actual conversion to a Node */
　 public Object getAdapter(Object list, Class clazz) {
　　 if (clazz == Node.class && list instanceof List) {
　　　 Element root = new Element("List");
　　　 Iterator it = list.iterator();
　　　 while(it.hasNext()) {
　　　　 Element item = new Element("Entry");
　　　　 item.appendChild(it.next().toString());
　　　　 root.appendChild(item);
　　　 }
　　　 return root;
　　 } else {
　　　 return null;
　　 }
　 }
}

2. 注册工场到Platform的AdapterManager

#p#分页标题#e#

我们需要注册工场到适配器工场，当我们向 List实例请求Node时, 它就会知道是利用我们注册的工场。 Platform为我们打点IAdapterManager ，并且注册进程相当简朴:

Platform.getAdapterManager().registerAdapters(
new NodeListFactory(), List.class
);

上面的代码要求平台打点者关联NodeListFactory和List。但我们要求List实例的适配器，它会挪用这个工场。按照我们对工场的界说，会得到一个Node工具。在Eclispe中,这一步必需在插件启动的时候显式的执行，要隐式执行可以通过 org.eclipse.core.runtime.adapters 扩展点。

#p#副标题#e#

3. 向List要求Node

这里是要求适配器返回一个 Node 工具:

Node getNodeFrom(IAdaptable list) {
　 Object adaptable = list.getAdapter(Node.class);
　 if (adaptable != null) {
　　 Node node = (Node)adaptable;
　　 return node;
　 }
　 return null;
}

总结

假如你要在运行时为已存在的类添加成果，只要界说一个能完成转换成果的工场，然后注册工程到 Platform的 AdapterManager就可以了. 这项成果可以用来为一个非UI组件注册一个指定的UI组件，同时保持两部门的完全疏散。就像在org.rcpapps.rcpnews.ui 和org.rcpapps.rcpnews 插件中的利用。在这些例子中, IPropertySource 在UI插件中，它需要与非UI插件的数据相关联。当UI插件初始化时，它注册IPropertySource 到Platform, 当数据工具在欣赏器中被选中时，属性视图中就会显示相应的属性。

很明明, java.util.List不能扩展PlatformObject, 所以你不能指望例子中的代码可以或许编译通过，你可以从头结构 List的子类来实现目标.担任PlatformObject 也不是必需的:

public class AdaptableList implements IAdaptable, List {
　 public Object getAdapter(Class adapter) {
　　 return Platform.getAdapterManager().getAdapter(this, adapter);
　 }
　 private List delegate = new ArrayList();
　 public int size() {
　　 return delegate.size();
　 }
　 // ...
}

本例中利用了XOM 来生成XML。