XDoclet配合Ant生成Hibernate文件

    前面学习Hibernate时，说到Hibernate映射，方法有两种：注解和映射文件。各有利弊：就灵活性而言，映射文件的方式肯定更优，且分类管理更容易；而注解的优势在于容易理解，不用专门再写映射文件。

    现在引出问题，一些思维定势：类似注解和映射文件，我们总是习惯将它们分开来看，为什么两条路就要分开走？即既然各有优劣，为什么不合并到一起取长补短？当初学时，确有疑问：注解的方式程序既然能理解，为什么不自动生成映射文件？

Ant

    Ant是构建工具，什么是构建工具？在我看来，就是做一些辅助工作的，例如：编译、打包、测试、执行等。我觉得这个工具最好的优点是：可定制，也就是说你给它一个XML文件（build.xml或另定），指定工作内容和流程，然后它照章执行。

XDoclet

    XDoclet和注解像，但又不一样：同于都是以注释的方式卸载属性前，供程序解析；不同于根据解析的注释，配合Ant，可以生成相对应的文件——这不是上面说的注解和映射文件的合并么！

    注意虽然在此处以Hibernate映射文件为例，它可不是只能生成Hibernate的映射文件，Struts、源码、web样样精通。不过它不是独立的程序，需要依赖于Ant。

示例

    Organization.java

    此处以组织为例，使用XDoclet符号标记，与注解基本一致。

/**
*
* @author Administrator
* @hibernate.class table="T_Orgnization"
*/
public class Organization {

/**
* @hibernate.id
* 		generator-class="native"
*/
private int id;

/**
* @hibernate.property
*/
private String name;

/**
* @hibernate.property
*/
private String sn;

/**
* @hibernate.property
*/
private String description;

/**
* @hibernate.many-to-one
* 		column="pid"
*/
private Orgnization parent;

/**
* @hibernate.set inverse="true" lazy="extra"
* @hibernate.key column="pid"
* @hibernate.one-to-many class="com.tgb.oa.model.Orgnization"
*/
private Set children;

//此处省略getter和setter
}

    build.xml

    给Ant指定执行内容和流程的配置文件。

<?xml version="1.0" encoding="GBK"?>
<project name="系统构建脚本" default="生成映射文件" basedir=".">

<property name="src.dir" value="${basedir}/src"/>
<property name="xdoclet.home" value="D:\Program Files (x86)\xdoclet-plugins-1.0.3"/>

<!-- Build classpath -->
<path id="xdoclet.task.classpath">
<fileset dir="${xdoclet.home}/lib">
<include name="**/*.jar"/>
</fileset>
<fileset dir="${xdoclet.home}/plugins">
<include name="**/*.jar"/>
</fileset>
</path>
<taskdef
name="xdoclet"
classname="org.xdoclet.ant.XDocletTask"
classpathref="xdoclet.task.classpath"
/>
<target name="生成映射文件">
<xdoclet>
<fileset dir="${src.dir}/com/tgb/oa/model">
<include name="**/*.java"/>
</fileset>
<component
classname="org.xdoclet.plugin.hibernate.HibernateMappingPlugin"
version="3.0"
destdir="${src.dir}"
/>
</xdoclet>
</target>

</project>

    来分析一下这个配置文件

指定根目录位置
指定解析XDoclet符号的类
指定带解析类所在位置和命名特性
指定生成映射文件的类
指定映射文件生成位置

  映射文件

    Ant根据build.xml，生成的Hibernate映射文件如下：

<?xml version="1.0" encoding="ISO-8859-1"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN" "http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd">

<hibernate-mapping>
<class table="T_Orgnization" name="com.tgb.oa.model.Orgnization">
<id name="id">
<generator class="native"/>
</id>
<property name="name"/>
<property name="sn"/>
<property name="description"/>
<many-to-one column="pid" name="parent"/>
<set name="children" inverse="true" lazy="extra">
<key column="pid"/>
<one-to-many class="com.tgb.oa.model.Orgnization"/>
</set>

</class>
</hibernate-mapping>

总结

    举一反三

    我觉得学习使用工具不难，难的是能不能找到共性进而升华，例如从SSH的学习开始，解耦合用的一直是xml文件，如果开发中碰到解耦合的问题能不能想到xml？

    与自己有关

    另外，工具的学习，也很重要的是，能不能知其然，再知其所以然：如果没有Ant及类似的工具，你会不会去开发一个类似的工具？不要一直跟随别人，你也可以做个领路人。