XDoclet實(shí)現(xiàn)基本原理是，通過在Java代碼加入特定的JavaDoc tag，從而為其添加特定的附加語義，之后通過XDoclet工具對(duì)代碼中JavaDoc Tag進(jìn)行分析，自動(dòng)生成與代碼對(duì)應(yīng)的配置文件，在Ejb、hibernate、struts中使用得比較廣泛了，ibatis比較草根，沒有這個(gè)棉襖穿，怎么辦呢，大過年的，為了讓ibatis也有新衣服穿，我只好弄一個(gè)了。如果你不了解xDoclet,推薦閱讀一下此文：
http://www-900.ibm.com/developerWorks/cn/java/j-xdoclet/index.shtml?ca=dwcn-newsletter-java
我的思路是力求簡(jiǎn)單，原先想寫一個(gè)xdt模板文件，訂制一些標(biāo)簽在POJO中使用，我偷個(gè)賴，看見hibernate的衣服出自名設(shè)計(jì)師，很是羨慕，我來個(gè)仿版（所謂的A貨），借用它的標(biāo)簽，另一個(gè)重要原因是，很多IDE已經(jīng)支持hibernate標(biāo)簽的編輯工作了。
我只借用4個(gè)標(biāo)簽，其中2和4要作少量擴(kuò)展（后面實(shí)例說明）：
1 @hibernate.class
2 @hibernate.discriminator
3 @hibernate.property - 簡(jiǎn)單屬性，對(duì)應(yīng)數(shù)據(jù)表字段
4 @hibernate.component - 復(fù)雜屬性,ibatis中對(duì)應(yīng)另一個(gè)select子句
現(xiàn)在請(qǐng)出例子貓豆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方法
......
}
藍(lán)色標(biāo)記的兩處為新增標(biāo)簽，從字面意思大家就可以理解了吧，前面的那個(gè)是為了指明主鍵字段及對(duì)應(yīng)屬性的，(上帝保佑，你采取唯一主鍵最好業(yè)務(wù)無關(guān)）
后一個(gè)是為了標(biāo)明update時(shí)需要參與更新的字段。
下面是build.xml中相關(guān)部分：
<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>
最后，給出這個(gè)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>
|
