基于Hibernate3.2 Hibernate tools 的使用

由于新发布的Hibernate Tools是一个比较庞大的工具包 而且已经是作为Eclipse3.2 的插件发布的
然而以前的很有用的工具hbm2java和hbm2ddl都是非常有用的工具

所以我们应该把这些有用的工具找出来继续使用 

环境

jdk-1_5_0_07

ant 1.6.5

Hibernate 3.2 cr2

Hibernate Tools-3.2.0.beta6

mysql-5.0.22

首先下载Hibernate Tools的包

在HIbernate的主页上有连接 下载是在sourceforge.net

地址：http://prdownloads.sourceforge.net/jboss/HibernateTools-3.2.0.beta6a.zip?download

下载完了以后解压缩HibernateTools-3.2.0.beta6a\plugins\org.hibernate.eclipse_3.2.0.beta6a\lib\tools

里找到hibernate-tools.jar 放到你的工程的lib里

目录结构

.
    +src
        +  your package
            *.java
            *.hbm.xml
            ...
        hibernate.config.xml
        ...
    +lib
    ......
    +data

    build.xml
把hibernate的目录里的lib里的jar  还有hibernate3.jar copy到lib里别忘了hibernate-tools.jar

注意hibernate3.jar要用HibernateTools-3.2.0.beta6a\plugins\org.hibernate.eclipse_3.2.0.beta6a\lib\hibernate里的hibernate3.jar

还有mysql-connector-java-5.0.0-beta-bin.jar 这个连接驱动也少不了

另外还要把HibernateTools-3.2.0.beta6a\plugins\org.hibernate.eclipse_3.2.0.beta6a\lib\tools的freemarker.jar也copy到lib里

尽管HIbernate的自动产生代码的方式有很多

比如

1 写java 代码用Xdoclet来产生hbm.xml

2 写hbm.xml来产生java代码

3 写hbm.xml来产生ddl

4 从数据库来产生hbm.xml和ddl

这里先讲解hbm2java 和 hbm2ddl

1 --hbm2java

把写好的代码*.hbm.xml放在你的src的包里

比如这样的Customer.hbm.xml

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

<hibernate-mapping>

    <class name="ergal.Customer" table="CUSTOMERS" lazy="false">
        <id name="id" type="long" column="ID">
            <generator class="increment" />
        </id>
   
        <property name="name" type="string">
            <column name="NAME" length="15" />
        </property>
        <set
            name="orders"
            cascade="save-update"
            inverse="true"
            >
       
            <key column="CUSTOMER_ID" />
            <one-to-many class="ergal.Order" />
        </set>  
    </class>
</hibernate-mapping>
还有Order.xml

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

<hibernate-mapping>

    <class name="ergal.Order" table="ORDERS">
        <id name="id" type="long" column="ID">
            <generator class="increment" />
        </id>
   
        <property name="orderNumber" type="string">
            <column name="ORDERNUMBER" length="15" />
        </property>
       
        <many-to-one
            name="customer"
            column="CUSTOMER_ID"
            class="ergal.Customer"
            not-null="true"
            cascade="save-update"
        />
    </class>
</hibernate-mapping>
再然后写Hibernate的配置文件

hibernate.config.xml



<?xml version='1.0' encoding='utf-8'?>
<!DOCTYPE hibernate-configuration PUBLIC
        "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
        "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">

<hibernate-configuration>

    <session-factory>

        <!-- Database connection settings -->
        <property name="connection.driver_class">com.mysql.jdbc.Driver</property>
        <property name="connection.url">jdbc:mysql://localhost:3306/ahtest</property>
        <property name="connection.username">root</property>
        <property name="connection.password">********</property>
       


        <!-- JDBC connection pool (use the built-in)-->
        <property name="hibernate.connection.provider_class">org.hibernate.connection.C3P0ConnectionProvider</property>
    <property name="hibernate.c3p0.max_size">20</property>
   
    <property name="hibernate.c3p0.min_size">5</property>
   
    <property name="hibernate.c3p0.timeout">120</property>
   
    <property name="hibernate.c3p0.max_statements">100</property>
   
    <property name="hibernate.c3p0.idle_test_period">120</property>
   
    <property name="hibernate.c3p0.acquire_increment">2</property>


        <!-- SQL dialect -->
        <property name="dialect">org.hibernate.dialect.MySQLDialect</property>

        <!-- Enable Hibernate's automatic session context management-->
        <property name="current_session_context_class">thread</property>
    
        <!-- Disable the second-level cache -->
        <property name="cache.provider_class">org.hibernate.cache.NoCacheProvider</property>
   
        <!-- Echo all executed SQL to stdout -->
        <property name="show_sql">true</property>

        <!-- Drop and re-create the database schema on startup-->
        <property name="hbm2ddl.auto">create</property>
    
        <mapping resource="ergal/Customer.hbm.xml"/>
        <mapping resource="ergal/Order.hbm.xml"/> 

    </session-factory>

</hibernate-configuration>



最后写build.xml



<?xml version="1.0" encoding="GBK"?>

<project name="hibernate-tutorial" default="compile">

    <property name="sourcedir" value="${basedir}/src"/>
    <property name="targetdir" value="${basedir}/bin"/>
    <property name="librarydir" value="${basedir}/lib"/>
    <property name="schema.dir" value="${basedir}/data"/>
   
    <path id="libraries">
        <fileset dir="${librarydir}">
            <include name="*.jar"/>
        </fileset>
    </path>
    <path id="project.class.path">
    <!-- Include our own classes, of course -->
        <pathelement location="${targetdir}" />
    <!-- Include jars in the project library directory -->
        <fileset dir="${librarydir}">
            <include name="*.jar"/>
        </fileset>
    </path>

    <target name="clean">
        <delete dir="${targetdir}"/>
        <mkdir dir="${targetdir}"/>
    </target>

    <target name="copy-resources">
        <copy todir="${targetdir}">
            <fileset dir="${sourcedir}">
                <exclude name="**/*.java"/>
            </fileset>
        </copy>
    </target>

    <target name="compile" depends="clean, copy-resources">
        <javac srcdir="${sourcedir}"
            destdir="${targetdir}"
            classpathref="libraries"/>
    </target>

    <target name="run" depends="compile">
        <java fork="true" classname="ergal.BusinessService" classpathref="libraries">
            <classpath path="${targetdir}"/>
            <arg value="${action}"/>
        </java>
    </target>
    <!-- create .java form  *.hbm.xml -->
    <target name="hbm2java" depends="compile"
        description="Generate Java source from the O/R mapping files">
        <taskdef name="hbm2java"
            classname="org.hibernate.tool.ant.HibernateToolTask"
            classpathref="project.class.path"/>
            <hbm2java destdir="${targetdir}">
                <configuration configurationfile="${targetdir}/hibernate.cfg.xml" /> 
                <hbm2java  jdk5="true"/>
                <!-- <cfg2hbm/> -->
            </hbm2java> 
   
    </target>
   
    <!-- create ddl form  *.hbm.xml -->
    <target name="hbm2ddl" depends="compile"
            description="Generate DB schema from the O/R mapping files">
        <taskdef name="hbm2ddl"
            classname="org.hibernate.tool.ant.HibernateToolTask"
            classpathref="project.class.path"/>
        <hbm2ddl destdir="${schema.dir}">
            <configuration configurationfile="${targetdir}/hibernate.cfg.xml" />
            <hbm2ddl export="true" console="false" create="true" update="false" drop="false" outputfilename="ahtest.sql"/>
        </hbm2ddl>  
    </target>

</project>


其中的 target name="hbm2java"  就是这次用来产生代码的任务

然后用cmd进入你的build.xml的根目录

运行ant hbm2java

会在你的根目录下多了一个bin文件夹里面就自动产生了一个project的源文件

包含以下代码

Customer.java

package ergal;
// Generated 2006-8-15 2:26:03 by Hibernate Tools 3.2.0.beta6a


import java.util.HashSet;
import java.util.Set;

/**
* Customer generated by hbm2java
*/
public class Customer  implements java.io.Serializable {

    // Fields   

     private long id;
     private String name;
     private Set<Order> orders = new HashSet<Order>(0);

     // Constructors

    /** default constructor */
    public Customer() {
    }

    /** full constructor */
    public Customer(String name, Set<Order> orders) {
       this.name = name;
       this.orders = orders;
    }
   
  
    // Property accessors
    public long getId() {
        return this.id;
    }
   
    public void setId(long id) {
        this.id = id;
    }
    public String getName() {
        return this.name;
    }
   
    public void setName(String name) {
        this.name = name;
    }
    public Set<Order> getOrders() {
        return this.orders;
    }
   
    public void setOrders(Set<Order> orders) {
        this.orders = orders;
    }




}



Order.java



package ergal;
// Generated 2006-8-15 2:26:03 by Hibernate Tools 3.2.0.beta6a



/**
* Order generated by hbm2java
*/
public class Order  implements java.io.Serializable {

    // Fields   

     private long id;
     private String orderNumber;
     private Customer customer;

     // Constructors

    /** default constructor */
    public Order() {
    }

    /** minimal constructor */
    public Order(Customer customer) {
        this.customer = customer;
    }
    /** full constructor */
    public Order(String orderNumber, Customer customer) {
       this.orderNumber = orderNumber;
       this.customer = customer;
    }
   
  
    // Property accessors
    public long getId() {
        return this.id;
    }
   
    public void setId(long id) {
        this.id = id;
    }
    public String getOrderNumber() {
        return this.orderNumber;
    }
   
    public void setOrderNumber(String orderNumber) {
        this.orderNumber = orderNumber;
    }
    public Customer getCustomer() {
        return this.customer;
    }
   
    public void setCustomer(Customer customer) {
        this.customer = customer;
    }




}





2 hbm2ddl

现在用映射文件来产生ddl和数据表

现在数据库里create database ahtest;

然后在根目录下运行

ant hbm2ddl（因为前面的build.xml里已经定义了hbm2ddl --“target name="hbm2ddl" ”）

就会在数据库的ahtest里自动建好了customers和orders两个表

还会在data文件夹下产生

ahtest.sql这个ddl文件



create table CUSTOMERS (
    ID bigint not null,
    NAME varchar(15),
    primary key (ID));
create table ORDERS (
    ID bigint not null,
    ORDERNUMBER varchar(15),
    CUSTOMER_ID bigint not null,
    primary key (ID));
alter table ORDERS
    add index FK8B7256E5479EC1E3 (CUSTOMER_ID),
    add constraint FK8B7256E5479EC1E3 foreign key (CUSTOMER_ID) references CUSTOMERS (ID);



这就是hbm2java和hbm2ddl这两个方便的工具的基本用法