SpringSide Wiki : JDK5

This page last changed on 2006-12-31 by xiaolan02.

SpringSide中使用的JDK5.0特性

      随着光阴推移，Annotation 慢慢在开源框架中推广，泛型渐渐被程序员们用熟，加上AutoBoxing的小糖，SpringSide终于离不开JDK5.0。

1.AutoBoxing 与 For Each 循环

    本来int的非Object性就很无聊，在JDK5.0终于提供了autoboxing功能。这个语法简化糖，被用在了每一个地方。

    for each 循环也改善了原本总要愣一下的collection遍历。不过对于非JDK基本类型，collection必须用泛型声明，如List<book></book>。

2. 泛型

    泛型大量用于SpringSide Core中的基类，使子类更简洁，基类更强大。当然，基类是难读了，所以才需要社区花上这么长的时间来把<t></t>看到顺眼。

    泛型使用的有两个定式：

2.1 避免强制类型转换

   如果函数输入参数里含Class类型，而返回值又是该Class的实体，应该将该函数设为泛型函数。最典型的例子是HibernateGenericDao的get() 函数

public <t></t> T get(Class<t></t> entityClass, Serializable id) {
   return (T) getHibernateTemplate().get(entityClass, id);
}

  其中眼花缭乱的第一个<t></t>声明这是一个泛型函数，第2个T声明返回值为T，第三个Class<t></t>代表 T.class。基类写的辛苦，但子类用得爽快 

   Book book = (Book)manager.get(Book.class,1) 简化成了 Book book = manager.get(Book.class,1);

2. 2 泛型配合反射API从T获得 T.class。

   最典型的例子HibernateEntityDao，子类只需以下定义，即获得要管理的Entity的Class。

BookManager extends HibernateEntityDao<book></book>

    此时子类只要声明一次T，上面的Book book = (Book)manager(Book.class,1) 就能简化成Book = manager.get(1);

    一举两得地既避免了强制类型转换，又声明了T.class 供框架使用，无须再在Manager的构造函数或getEntityClass()函数定义entityClass，。

    反射的API 详见GenricsUtils ，精简的对上面BookManager的定义反射代码如下:

Type genType = clazz.getGenericSuperclass();
Type [] params = ((ParameterizedType) genType).getActualTypeArguments();
return (Class) params[0];

   泛型反射的关键是获取ParameterizedType，再调用它的getActualTypeArguments()方法获得实际绑定的类型。但注意public class BookManager<book></book>是不能被反射的，因为擦拭法的缘故。只有在Superclass 或者成员变量(Field.getGenericType())等有函数返回ParameterizedType的时候才能成功反射，，

比如 

public class BookManager extends Manager<book></book>{} public class BookAction {    private BookManager<book></book> manager;}

 2.3 其他应用

   1. 在XFire中，List getBooksByCategory()函数返回的结果，需要用aegis.xml 文件声明List中的元素为Book.

   而如果定义函数为 List<book></book> getBooksByCategory()，就不再需要声明，省掉XMl配置文件。

3.Annotation

     Annotation 大幅提升了Java的编程模式，SpringSide 目前运用的Annotation 有以下三个地方，幸运的是前两者同时也提供JDK1.4的JAVADoc式配置，只是麻烦一点点而已

     3.1. Hibernate Annotation

         使用Hibernate Annotation 代替hbm文件，因为annotation高度的默认性，典型的POJO基本上不需要定义什么，代码的简约性和可管理性大幅提高，直追ROR。

         另外，经过测试，annotation 完全能胜任一些比较复杂的Mapping定义，如Product-Book的父子继承关系，Order-OrderItem-Product的经典三角关系。

     2. XFire JSR181 Annotation

         JSR181声明的Web Service，比原本用xml定义的模式节约了XML文件和配置代码的数量。

     3. 声明Entity类型的Annotation

         使用Annotation 声明Entity的类型，比如Udeletable，Auditable 等，比用接口声明的方式有更少的侵入性，详见 侵入，非侵入？Interface vs Annotation。

4. 三种内置Annotation

JDK5.0 有SuppressWarnings，Deprecated和Override 三种内置的annotation：

  @Override

   此标签一方面提醒用户这是个重载函数，另一方面保证了父类函数的参数或者名字改变时，子类如果没有跟着变化，就会编译不过。

   虽然有点占地方，但用处的确很大，不会哪天子类被人卖了都不知道。

  所以我设置了让IDEA6检查所有重载函数必须加上@Override标识。

  @SuppressWarnings("unchecked")

    此标签可以让编译器忽略某种warning信息，比如减少JDK5.0的集合操作引入范型后无处不在的warning。

    因为有些非JDK5.0的开源库如hibernate, 函数返回的一定是List，而不会是List<user></user>，这时候IDE就会爆出很多warning。用SuppressWarning("unchecked")可以让IDE安静一些。

    其他常用warning还包括 @SuppressWarnings("unused") 和 SuppressWarnings("serial")

  @Deprecated

   此标签以前写在JavaDoc里，现在提到annotation，注释已废弃的函数。用户使用该函数的话，编译时会得到"你用了废弃"的提示。

5.可变参数

用于HibernateGenericDao中，简化函数接口。

比如 一个public List find(String hql, Object... values)，就支持了如下四种调用，避免了以前的煞费苦心的定义多种接口，然后把参数转成统一模式的大量重复定义。

dao.find(hql);
dao.find(hql,arg0);
dao.find(hql,arg0,arg1);
dao.find(hql,new Object[arg0,arg1])

Document generated by Confluence on 2007-01-16 11:21