CSDN博客

img andersonmao

其它技术和Hibernate-XDoclet

发表于2004/2/29 13:23:00  1856人阅读

分类: Hibernate

其它技术和Hibernate-XDoclet

使用Hibernate,对实体类,需要Map 文件,XDoclet在写类时加入类似Javadoc的@hibernate.xxx 指示,然后用XDoclet自动生成Map 文件,使写程序更加方便。

使用XDoclet一般使用Ant,在build.xml中加入XDoclet的部分。XDoclet需要有相应的jar文件支持,不过,因为XDoclet是在Ant运行时使用的,所以XDoclet的jar可以不放在webapps/../WEB-INF/lib下,可另外放一个目录(有时XDoclet的jar会和其它的jar冲突)

从XDoclet网上下 xdoclet.zip 或tar.gz,可放在一个单独的目录,如lib-xdoc下,一般需要:(以1.2版本为例)

  • xdoclet-1.2.jar
  • xdoclet-xdoclet-module-1.2.jar
  • xdoclet-hibernate-module-1.2.jar
  • xjavadoc-1.0.2.jar

其它的通用的jar,Hibernate等也用到,如commons-logging-x.x.x.jar,xerces-x.x.x.jar,可放在lib目录下。

目录结构WEB-INF

  • lib
  • lib-xdoc
  • src
  • classes
  • build.xml
  • web.xml

这样,在Ant 的build.xml中同时加入lib 和 lib-xdoc下的jars,编译时用到 XDoclet,运行时就不用XDoclet了。

build.xml:

<?xml version="1.0" encoding="UTF-8"?>
<project name="Test" default="compile" basedir=".">
   <property name="classes" location="./classes"/>
   <property name="src" value="src" />
   <property name="db" value="db" />
   <property name="lib" value="lib" />
   <property name="lib-xdoc" value="lib-xdoc" />
   <property name="build" value="classes" />
   <path id="myclasspath">
    <fileset dir="${lib}">
     <include name="*.jar"/>
    </fileset>
    <fileset dir="${lib-xdoc}">
     <include name="*.jar"/>
    </fileset>
   <pathelement location="${build}"/>
   </path>
   <target name="init">
   <mkdir dir="${classes}"/>
   </target>
   <target name="compile" depends="init">
   <javac executable="jikes" classpathref="myclasspath"    srcdir="${src}" destdir="${classes}"/>
   </target> 
   <target name="clean">
   <delete dir="${classes}"/>
   </target>
   <target name="xdoc" description="Generates Hibernate class    descriptor files.">
     <taskdef name="hibernatedoclet"
      classname="xdoclet.modules.hibernate.HibernateDocletTask">
      <classpath refid="myclasspath"/>
     </taskdef>
     <hibernatedoclet
      destdir="${classes}"
      excludedtags="@version,@author,@todo"
      force="true"
      verbose="true">
      <fileset dir="${src}">
       <include name="**/*.java"/>
      </fileset>
     <hibernate version="2.0"/>
   </hibernatedoclet> 
   </target>
   <!-- Other target omited -->
</project>
  

使用XDoclet 的例子:

例1.Org.java 表示一个公司的各个组织,组成一个树形结构,就是一个Org 可能有一个父的Org

用many-to-one/one-to-many,用同一个column(parent) 指向本身(bean.Org),有一个用inverse

package  bean;
import java.util.*;
/**
* @hibernate.class table="test_org"
*/
public class Org extends Persistent{ //注:id在Persistent中
private String name;
private Org parent;
private Set children=new TreeSet();
/**
* @hibernate.property length="60"
*/
public String getName(){
return name;
}
public void setName(String value){
name=value;
}
/**
* @hibernate.many-to-one class="bean.Org" column="parent"
*/
public Org getParent(){
return parent;
}
public void setParent(Org value){
parent=value;
}
/**
* @hibernate.set inverse="true" lazy="true" cascade="all"
* @hibernate.collection-key column="parent"
* @hibernate.collection-one-to-many class="bean.Org"
*/
public Set getChildren(){
return children;
}
public void setChildren(Set value){
children=value;
}
}

Persistent.java

package bean;
import net.sf.hibernate.Validatable;
import net.sf.hibernate.ValidationFailure;


/**
  * @hibernate.class table="test_persistent"
  */
public class Persistent implements Validatable{
  protected int id;
  /**
  * @hibernate.id generator-class="increment" type="int" unsaved-value="null"
  */
  public int getId() {
     return id;
  }
  public void setId(int id) {
     this.id = id;
  }
  public void validate() throws ValidationFailure {
} }

自动生成的Map 文件如下:

Org.hbm.xml

<?xml version="1.0"?>
<!DOCTYPE hibernate-mapping PUBLIC
"-//Hibernate/Hibernate Mapping DTD 2.0//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">
<hibernate-mapping>
<class
name="bean.Org"
table="test_org"
dynamic-update="false"
dynamic-insert="false">
<id
name="id"
column="id"
type="int"
unsaved-value="null">
<generator class="increment">
</generator>
</id>
<property
name="name"
type="java.lang.String"
update="true"
insert="true"
column="name"
length="60"/>
<many-to-one
name="parent"
class="bean.Org"
cascade="none"
outer-join="auto"
update="true"
insert="true"
column="parent"/>
<set
name="children"
lazy="true"
inverse="true"
cascade="all"
sort="unsorted">
<key
column="parent"/>
<one-to-many
class="bean.Org"/>
</set>
</class>
</hibernate-mapping>

例2.用户(User)和职位(Position),一个用户可有多个职位,可用many-to-may 关系

用的表是同一个(test_user_position),在Position中用"inverse",实现双向关联(Bidirectional Associations)

Users.java:

package  bean;
import java.util.*;
/**
* @hibernate.class table="test_user"
*/
public class User extends Persistent{ //......
private Set positions=new TreeSet();
/**
* @hibernate.set table="test_user_position" lazy="true"
* @hibernate.collection-key column="user_id"
* @hibernate.collection-many-to-many class="bean.Position" column="position_id"
*/
public Set getPositions(){
return positions;
}
public void setPositions(Set value){
positions=value;
}
}

Position.java

package  bean;
import java.util.*;
/**
* @hibernate.class table="test_position"
*/
public class Position extends Persistent{
//......
private Set users=new TreeSet();
/**
* @hibernate.set inverse="true" lazy="true" table="test_user_position"
* @hibernate.collection-key column="position_id"
* @hibernate.collection-many-to-many class="bean.User" column="user_id"
*/
public Set getUsers(){
return users;
}
public void setUsers(Set value){
users=value;
}
}

小结:

使用XDoclet,可方便生成Hibernate 的Map文件,加快开发。

注意事项:使用双向关联(Bidirectional Associations)时相应的column一定要正确,否则XDoclet不会报错,但是生成的数据库表不正确。

参考:

Hibernate 主站:www.hibernate.org

Hibernate Xdoclet:http://www.chinaunix.net/jh/26/92019.html

XDoclet 主站:http://xdoclet.sourceforge.net/

 

0 0

相关博文

我的热门文章

img
取 消
img