Eclipse中的IAdaptable
Eclipse中的IAdaptable
类型转化
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表明失败，这样比抛出异常要好。
PlatformObject
当你想添加新的要扩展的类型时，只是简单的修改一下就可以了。在任何情况下，如果已经得到了类型，为什么不修改接口？不修改类（如果使用接口，不容易保证向后兼容）或者改变它的类型（HashMap不是 List，但是可以转化）是有原因的。要解决这个问题，在Eclipse中，使用了一个抽象类 HashMap
is not a List, but can be conveted into one).
To solve this problem, there's an abstract class that is used by most
parts of Eclipse called --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
我们需要注册工厂到适配器工厂，当我们向 List实例请求Node时, 它就会知道是使用我们注册的工厂。 Platform为我们管理IAdapterManager ，而且注册过程相当简单:
Platform.getAdapterManager().registerAdapters(
new NodeListFactory(), List.class
);
上面的代码要求平台管理者关联NodeListFactory和List。但我们要求List实例的适配器，它会调用这个工厂。根据我们对工厂的定义，会获得一个Node对象。在Eclispe中,这一步必须在插件启动的时候显式的执行，要隐式执行可以通过 org.eclipse.core.runtime.adapters 扩展点。
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。
