Eclipse RCP 中的Iadaptable接口

     如果你要在运行时为已存在的类添加功能，只要定义一个能完成转换功能的工厂，然后注册工程到 Platform 的 AdapterManager 就可以了 . 这项功能可以用来为一个非 UI 组件注册一个指定的 UI 组件，同时保持两部分的完全分离。 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 中，使用了一个抽象类 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();

　 }

　 // ...

}