IAdaptable & IAdapterFactory

IAdaptable & IAdapterFactory

在Eclipse中使用IAdaptable接口的方式有两种
1:某个类希望提供新的接口,但又不希望将其暴露在API中,在这种情况下,IAdaptable接口中的方法getAdaptor()方法将由本类实现。(希望支持新的接口,而又不想把已经发布的API造成影响,这种机制很有用)
2:外界要求某个类提供新的服务,这种情况下不需要修改现有类的代码,getAdaptor()由一个工厂提供。(不使用decorator模式的原因是在以后的对比中会出现两个含有相同接口的类)
创建适配器工厂(IAdapterFactory),注册到适配器管理器(IAdapterManager),
代码如下:IadapterFactory factory = new AdapterFactory();
IadapterManager manager = Platform.getAdapterManager();
Manager.registerAdapters(factory,Ifile.class);

适配对象需要实现platformobject
public Object getAdapter(Class adapter)
{
           return InternalPlatform.getDefault().getAdapterManager().getAdapter(this, adapter);
     }
若未实现,则需要下列调用:Platform.getAdapterManager().getAdapter(this,adapter)



(Quote from http://www.blogjava.net/reloadcn/archive/2006/10/09/74153.aspx)

1. 简介和简单的实现

IAdapteable实际上在Eclipse早期版本中不叫这个名字,它原来的名字叫做IExtensible,顾名思义就是可以扩展的意思,后来为了更能突出是由一个类配适到一个接口这么一种机制,所以改名为IAdaptable。
这个接口有什么用呢,其实说白了,就是提供一个类型的转换机制。比如下面这段代码:

Class IAdaptable  
public   interface  IAdaptable  {
 
public  Object getAdapter(Class clazz);
}

Class ListAdapter
public   class  ListAdapter  extends  ArrayList  implements  IAdaptable 

{
 
public  Object getAdapter(Class clazz) {
  
if (clazz  ==  Vector. class ){
   Vector v 
=   new  Vector( this .size());
   v.addAll(
this );
   
return  v;
  }
  
return   null ;
 }
}


ListAdapter 类继承了ArrayList,并且实现了IAdaptable接口,我们想要将它转化成Vector类型对象,于是在getAdapter方法中我们判断 传入参数类型,如果是Vector类那么就新生成一个Vector对象,将ArrayList中的值全部赋给它,并返回。

这样,我们就可以写出以下代码:

ListAdapter list  =   new  ListAdapter();
  Vector v 
=  (Vector) list.getAdapter(Vector. class );


ArrayList会返回Vector对象,这个对象是ArrayList的一个另外一种类型的副本。

2.一个Swing程序

读者会问:这有什么用啊,不就简单转化一下麽。其实说实话,从上面的代码来看确实没什么用,但是如果我们换一个场景试试。

写 这么一个Swing程序:有一个对话框,其中它有一个ComboBox和一个Table,ComboBox中存放的是一个名为Person类型的对象,当 ComboBox的选项发生改变的时候,就在Table上显示它的属性,我们假设这个Swing程序已经在某个项目中开始实施,并且其界面布局不易更改。

看看代码:

Class person
public   class  Person {
 
private  String name  =   " name " ;
 
private  String age  =   " 23 " ;
 
private  String sex  =   " male " ;
 
 
public  Person(String name){
  
this .setName(name);
 }
 
 
public  String getName() {
  
return  name;
 }
 
 
public   void  setName(String name) {
  
this .name  =  name;
 }
 ……
}

UI类的部分代码:

{
       table 
=   new  JTable();
       
this .getContentPane().add(table);
       table.setBounds(
218 2 171 248 );
      }
      {
       ComboBoxModel jComboBox1Model 
=   new  DefaultComboBoxModel(
        
new  Object[] {  new  Person( " rEloaD " ),  new  Person( " b " ) });
       comboBox 
=   new  JComboBox();
       
this .getContentPane().add(comboBox);
       comboBox.setModel(jComboBox1Model); 
       comboBox.addActionListener(
new  ActionListener(){
                 
public   void  actionPerformed(ActionEvent e){
                     JComboBox comboBox 
= (JComboBox)e.getSource();
                     Person p 
=  (Person)comboBox.getSelectedItem();
                     TableModel jTable1Model 
=   new  DefaultTableModel(
                                     
new  String[][] { {  " Name " , p.getName() },
                                                       { 
" Sex " , p.getSex() },
                                                      { 
" Age " , p.getAge() }},
                                     
new  String[] {  " Column 1 " " Column 2 "  });
                     table.setModel(jTable1Model);
                      }
                  });

      }





 运行我们的代码,会发现效果还可以,每当我们选项改变的时候,Table就如同一个属性栏一样,改变着自己的内容:



3.需求变更

OK,问题来了。我写完这段代码后,组长告诉我,现在我们有一个新的需求,就是Combox中不仅仅有Person类型存在,而且还有一些货物(Product)类型,也就是说,我的table显示属性不能光针对Person这个类型了,还需要显示Product的属性。

我心里骂了句:早TMD干嘛了,都快交活儿了才告诉我。

无奈,我新增加了一个Product类型,然后更改了ActionListener中的部分代码:

JComboBox comboBox  = (JComboBox)e.getSource();
 Object obj 
=  comboBox.getSelectedItem();
 TableModel jTable1Model 
=   null ;
  
if (obj  instanceof  Person){
      jTable1Model 
=   new  DefaultTableModel(
                          
new  String[][] { {  " Name " , ((Person)obj).getName() },
                                           { 
" Sex " , ((Person)obj).getSex() },
                                            { 
" Age " , ((Person)obj).getAge() }},
                           
new  String[] {  " Column 1 " " Column 2 "  });
  }
  
if (obj  instanceof  Product){
      jTable1Model 
=   new  DefaultTableModel(
                        
new  String[][] { {  " Name " , ((Product)obj).name },
                                          { 
" price " , ((Product)obj).price },
                                          { 
" quantity " , ((Product)obj).quantity }},
                         
new  String[] {  " Column 1 " " Column 2 "  });

  }
  table.setModel(jTable1Model);




结果还是让人满意的:



后来我感觉ActionListener代码有一些凌乱,又封装了一个Builder类,让它创建TableModel:

public   static  TableModel modelBuilder(Object obj){
TableModel jTable1Model = null;
  
if (obj  instanceof  Person){
          jTable1Model 
=   new  DefaultTableModel(
             
new  String[][] { {  " Name " , ((Person)obj).getName() },
               { 
" Sex " , ((Person)obj).getSex() },
               { 
" Age " , ((Person)obj).getAge() }},
             
new  String[] {  " Column 1 " " Column 2 "  });
                          }
                          
if (obj  instanceof  Product){
                            jTable1Model 
=   new  DefaultTableModel(
               
new  String[][] { {  " Name " , ((Product)obj).name },
                 { 
" price " , ((Product)obj).price },
                 { 
" quantity " , ((Product)obj).quantity }},
               
new  String[] {  " Column 1 " " Column 2 "  });

  }
return  jTable1Model;

}


我对自己的代码还算满意,至少目前能用了。

4.需求又变了

第二天,组长告诉我,需求又变了,这会不但多增加一个“服装”类型,Product类型属性显示有错误,并且需要增加一个Tree,显示当前同种类型直接的层次结构,等等。

我听了领导唠叨半个小时后,打开了我刚写的Builder类,往里面增加着我的代码……

类图大致如下:


 

程序经过修改后,好不容易又符合要求了,情况又发生了变化,组长需要我继续修改。我无奈地看着组长,组长也无奈地看着我那用if-else堆成的代码……

“悲哀,真让我替你感到悲~哀!”组长操着本山的腔调这样对我说。

是啊,多悲哀啊,一个设计上的错误让我的代码无法适应需求的变化。



好了,让我们回到IAdaptable上。

通过上面的例子,我看可以发现这么一个情况:同样一个对象,在程序里面往往有许多不同的显示方式(不仅仅是在UI显示,在其他一些代码里,需要转化成另外类型或者数据结构)。

如果我用IAdapteable的思想来实现刚才的Swing属性显示,会怎么样呢?

重新写一遍ActionListener中的代码:

JComboBox comboBox  = (JComboBox)e.getSource();
Object obj 
=  comboBox.getSelectedItem();
TableModel jTable1Model 
=   null ;
if (obj  instanceof  IAdaptable){
       jTable1Model 
=  (TableModel) ((IAdaptable)obj).getAdapter(TableModel. class );
}
table.setModel(jTable1Model);

然后分别让Person和Product实现IAdaptable接口:

Class Person:
public   class  Person  implements  IAdaptable{
   …..
   
public  Object getAdapter(Class clazz) {
  
if (clazz  ==  TableModel. class ){
    
return   new  DefaultTableModel(
      
new  String[][] { {  " Name " , getName() },
        { 
" Sex " , getSex() },
        { 
" Age " , getAge() }},
      
new  String[] {  " Column 1 " " Column 2 "  });
  }
  
return   null ;
 }
}

Class Product
public   class  Product  implements  IAdaptable{
 ……
    
public  Object getAdapter(Class clazz) {
  
if (clazz  ==  TableModel. class ){
    
return   new  DefaultTableModel(
      
new  String[][] { {  " Name " , getName() },
        { 
" Sex " , getSex() },
        { 
" Age " , getAge() }},
      
new  String[] {  " Column 1 " " Column 2 "  });
  }
  
return   null ;
 }
}

其实我们的代码量并没有任何的改变,前后都是一样的。

但 是我们将Table需要显示的模型(TableModel),现在是作为扩展类接口抽取了出来,而那些需要在Table上显示自己属性的业务模型 (Person,Product)实现了IAdaptable接口,将显示模型(TableModel)作为了自己的扩展接口类型给予实例返回,并且UI 代码中,Table和业务模型之间形成一种契约:凡是实现了IAdaptable的接口才可以获得在该Table上显示的资格,并且Table从 IAdaptable的getAdapter方法获得显示模型:




这样一来,我们的Swing程序不仅功能能够实现,而且UI部分代码和业务模型代码之间的耦合性减小了。

而 且,如果需求发生变化,比如像刚才提到那样“需要增加一个Tree,显示当前同种类型直接的层次结构”,那我们就在getAdaper方法中返回一个 TreeModel的副本,然后在UI中增加一个Tree,让它像Table一样,从IAdaptable接口中取出我们的TreeModel即可—— UI扩展也变得容易起来。

现在我可以对组长说:让需求变化来得更猛烈些吧!


5.模型代码无法修改

有这样一个问题:如果我们的模型已经存在,而且代码已经无法修改了怎么办?

IAdapterFactory就是为这种情况准备的。

先看看IAdapterFactory:

public   interface  IAdaptableFactory {
 
public  Object getAdapter(Object adapter,Class clazz);
}


这里面的方法和IAdaptable差不多,只是多了一个参数,这个参数就是需要我们返回Adapter接口的对象。

在Eclipse中IAdapterFactory并不是单独存在的,而是有一个IAdapterManager对它进行维护的:

public   interface  IAdaptableManager {
 
public  Object getAdapter(Object adapter,Class clazz);
 
public   boolean  registerAdapters (Class clazz,IAdaptableFactory factory);
}


现在让我们这样来修改刚才的Swing程序:

假设Product类型是第三方提供的jar包,我们已经无法修改它的代码了,那我们就需要用到IAdapableFactory的扩展方法。请看下面的代码

Class AdaptableFactoryImpl
public   class  AdaptableFactoryImpl  implements  IAdaptableFactory {
 
public  Object getAdapter(Object adapter, Class clazz) {
  
if (adapter  instanceof  Product){
   
if (clazz  == TableModel. class ){
    
return   new  DefaultTableModel(
      
new  String[][] { {  " Name " ,((Product)adapter).name },
        { 
" price " , ((Product)adapter).price },
        { 
" quantity " , ((Product)adapter).quantity }},
      
new  String[] {  " Column 1 " " Column 2 "  });
   }
  }
  
return   null ;
 }
 
public  Class[] getAdapterList() {
  
return   new  Class[]{TableModel. class };
 }
}

Class AdapterManagerImpl:
public   class  AdapterManagerImpl  implements  IAdaptableManager {
 
private   static  AdapterManagerImpl instance  =   null ;
 
private  Hashtable table  =   new  Hashtable();
 
 
private  AdapterManagerImpl(){}
 
 
public  Object getAdapter(Object adapter, Class clazz) {
  Object factory 
=  table.get(adapter.getClass());
  
if (factory  !=   null ){
   
return  ((IAdaptableFactory)factory).getAdapter(adapter,clazz);
  }
  
return   null ;
 }

 
public   boolean  registerFacotry(Class clazz, IAdaptableFactory factory) {
  
try {
   table.put(clazz,factory);
   
return   true ;
  }
catch (Exception e){
   
return   false ;
  }
 }
 
public   synchronized   static  AdapterManagerImpl getInstance() {
  
if (instance  ==   null ) instance  =   new  AdapterManagerImpl();
  
return  instance;
 }
}


有了这两个实现类后,我们再去修改一下ActionListener中的代码:

         JComboBox comboBox  =  (JComboBox) e.getSource();
         Object obj 
=  comboBox.getSelectedItem();
         TableModel jTable1Model 
=   null ;
         
if  (obj  instanceof  IAdaptable) {
          jTable1Model 
=  (TableModel) ((IAdaptable) obj)
            .getAdapter(TableModel.
class );
         } 
else  {
          jTable1Model 
=  (TableModel) AdapterManagerImpl
            .getInstance().getAdapter(obj,
              TableModel.
class );
         }
         table.setModel(jTable1Model);


好了,只要我们在适当的地方,将IAdaptableFactory注册进IAdaptaerManager,那我们对无法修改代码的业务模型也能进行接口的扩展了。

6.结束语

在Eclipse中,IAdaptable的应用非常广泛,而且如果实现了IAdaptable接口的类被成为Platform Object,可见IAdaptable在Eclipse框架中的分量。本人的知识有限,如果有遗漏或者错误的地方,还请各位读者指出。



你可能感兴趣的:(IAdaptable & IAdapterFactory)