pojo+xDoclet生成ibatis映射文件

 XDoclet实现基本原理是，通过在Java代码加入特定的JavaDoc tag，从而为其添加特定的附加语义，之后通过XDoclet工具对代码中JavaDoc Tag进行分析，自动生成与代码对应的配置文件，在Ejb、hibernate、struts中使用得比较广泛了，ibatis比较草根，没有这个棉袄穿，怎么办呢，大过年的，为了让ibatis也有新衣服穿，我只好弄一个了。如果你不了解xDoclet,推荐阅读一下此文：
  http://www-900.ibm.com/developerWorks/cn/java/j-xdoclet/index.shtml?ca=dwcn-newsletter-java
 
        我的思路是力求简单，原先想写一个xdt模板文件，订制一些标签在POJO中使用，我偷个赖，看见hibernate的衣服出自名设计师，很是羡慕，我来个仿版（所谓的A货），借用它的标签，另一个重要原因是，很多IDE已经支持hibernate标签的编辑工作了。

我只借用4个标签，其中2和4要作少量扩展（后面实例说明）：

1 @hibernate.class
2 @hibernate.discriminator 
3 @hibernate.property  - 简单属性，对应数据表字段
4 @hibernate.component - 复杂属性,ibatis中对应另一个select子句

现在请出例子猫豆MM，User.java:

package org.chage.pojo;
import java.util.List;
/**
 * @hibernate.class table="D_USER"
 * @hibernate.discriminator column="USERID" property="id type="long"
 */
public class User {
 private Long id;
 private String username;
 private List roles;
 
 /***
  * @hibernate.property column="USER_ID"
  */
 public Long getId() { return id; }
 /***
  * @hibernate.property column="USER_NAME"
  */
 public Long getUsername() { return username; }
 /***
  * @hibernate.component column="USER_ID" select="selectRoles"
  */
 public List getRoles(){ return roles; }
 //以下省略了setter方法
 ......
}

蓝色标记的两处为新增标签，从字面意思大家就可以理解了吧，前面的那个是为了指明主键字段及对应属性的，(上帝保佑，你采取唯一主键最好业务无关）
后一个是为了标明update时需要参与更新的字段。

下面是build.xml中相关部分：

 <target name="init">
  <path id="xdoclet.path">
   <fileset dir="${xdocletlib}">
    <include name="*.jar" />
   </fileset>
  </path>
  <taskdef classname="xdoclet.DocletTask" classpathref="xdoclet.path" name="doclet" />
 </target>
 <target name="sqlmap" depends="init">
  <doclet destdir="${sqlmap.dir}" excludedtags="@version,@author,@todo" force="true" verbose="true">
   <fileset dir="${src.dir}">
    <include name="**/${pojo.java}.java" />
   </fileset>
   <template destinationFile="{0}.xml" templateFile="${template.dir}/gensqlmap.xdt" subTaskName="Generate SqlMap xml...">
   </template>
  </doclet>
 </target>
 

最后，给出这个xdt模板:

<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE sqlMap PUBLIC "-//iBATIS.com//DTD SQL Map 2.0//EN" "http://www./dtd/sql-map-2.dtd">

<sqlMap namespace="<XDtClass:className/>">

  <typeAlias alias="<XDtClass:className/>" type="<XDtClass:fullClassName/>"/>

  <resultMap id="<XDtClass:className/>Result" class="<XDtClass:className/>">
     <XDtMethod:forAllClassMethods>
       <XDtMethod:ifIsGetter>
         <XDtMethod:ifHasMethodTag tagName="hibernate.property" >
            <result property="<XDtMethod:propertyName/>" column="<XDtMethod:methodTagValue tagName="hibernate.property" paramName="column"/>"/>
         </XDtMethod:ifHasMethodTag>
         <XDtMethod:ifHasMethodTag tagName="hibernate.component">
            <result property="<XDtMethod:propertyName/>" column="<XDtMethod:methodTagValue tagName="hibernate.component" paramName="column"/>" select="<XDtMethod:methodTagValue tagName="hibernate.component" paramName="select"/>"/>          
         </XDtMethod:ifHasMethodTag>
       </XDtMethod:ifIsGetter>
     </XDtMethod:forAllClassMethods> 
  </resultMap>

  <select id="get<XDtClass:className/>" resultMap="<XDtClass:className/>Result" parameterClass="<XDtClass:classTagValue tagName=‘hibernate.discriminator‘ paramName=‘type‘/>">
     select
      <XDtMethod:forAllClassMethods>
        <XDtMethod:ifIsGetter>
          <XDtMethod:ifHasMethodTag tagName="hibernate.property" >
            <XDtMethod:methodTagValue tagName="hibernate.property" paramName="column"/>, 
          </XDtMethod:ifHasMethodTag>
        </XDtMethod:ifIsGetter>
      </XDtMethod:forAllClassMethods>  
     from <XDtClass:classTagValue tagName=‘hibernate.class‘ paramName=‘table‘/>
     where <XDtClass:classTagValue tagName=‘hibernate.discriminator‘ paramName=‘column‘/> = #value#
  </select>