幼学琼林--SpringSide推荐的JDK5.0 feature

作者：江南白衣

原文出自SpringSide Wiki，请留意wiki中的更新。

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

1.AutoBoxing 与 For Each 循环

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

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

2. 泛型

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

泛型使用的有两个定式：

2.1 避免强制类型转换

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

public<T>Tget(Class<T>entityClass,Serializableid){
return(T)getHibernateTemplate().get(entityClass,id);
}

其中眼花缭乱的第一个<T>声明这是一个泛型函数，第2个T声明返回值为T，第三个Class<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。

BookManagerextendsHibernateEntityDao<Book>

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

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

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

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

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

比如

publicclassBookManagerextendsManager<Book>{
}

publicclassBookAction{
privateBookManager<Book>manager;
}

2.3 其他应用

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

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

3.Annotation

Annotation 大幅提升了Java的编程模式，SpringSide 目前运用的Annotation 有：

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>，这时候IDE就会爆出很多warning。用SuppressWarning("unchecked")可以让IDE安静一些。

@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,newObject[arg0,arg1])