这篇文章是上篇文章《Eclipse快速上手Hibernate--1. 入门实例》的延续,主要说的是如何利用Hbm映射文件产生普通的Java对象及数据表。可以参考Hibernate自带的文档《HIBERNATE - 符合Java习惯的关系数据库持久化》的第15章--《工具箱指南》一节。同样,这篇文章没有过多谈理论,只是给出了一个完整的实例加以说明。相关配置请参考上篇文章。
1. 创建项目
· 新建一个Java项目:HibernateBegin_2,注意选中“创建单独的源文件夹和输出文件夹”,同时添加“用户库”:hibernate。
2. 映射文件User.hbm.xml
· 新建一个包,包名:javamxj.hibernate,然后在此包下新建一个文件,文件名:User.hbm.xml。
User.hbm.xml
<?xml version="1.0" encoding="GBK"?>
<!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD//EN"
"http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">
<hibernate-mapping>
<class name="javamxj.hibernate.User" table="UserTable2">
<meta attribute="class-description">
运行 Hbm2Java 任务, 利用 hbm.xml文件生成Java类文件
@author javamxj(分享java快乐)
@link Blog: htpp://javamxj.mblogger.cn
htpp://blog.csdn.net/javamxj/
</meta>
<id name="id" type="string" unsaved-value="null" length="32" column="ID">
<generator class="uuid.hex"/>
</id>
<property name="username" type="string" not-null="true" length="24">
<meta attribute="field-description">@param 用户名</meta>
</property>
<property name="password" type="string" not-null="true" >
<column name="密码" length="24" not-null="true"></column>
</property>
</class>
</hibernate-mapping>
● 与上篇文章中的User.hbm.xml文件比较,可以发现标签上增加了许多额外的设定。
· 这里<meta>标签中的内容将插入到类的javadoc说明去。
· <id>标签使用 uuid.hex 来定义主键的产生算法,UUID算法使用IP地址、JVM的启动时间、系统时间和一个计数值来产生主键。
· <property>标签中的<column>用于生成数据表中的列。
3. 构建文件Build.xml
· 将上篇文章中的“hibernate.cfg.xml”配置文件复制到src目录下。
· 在项目根目录下建立一个build.xml,这个文件含有四个任务,这里会用到“generate-code”、“schemaexport”两个任务,至于用法可以看注释。要注意环境变量的设置要符合自己的实际配置,比如库文件目录的设置是"D:/java/Hibernate/lib",是沿用上篇文章中的设置。
build.xml
<?xml version="1.0" encoding="GBK"?>
<project name="利用工具开发Hibernate" default="help" basedir=".">
<!-- ****** 环境设置,可以根据自己的实际配置自行更改 ***** -->
<!-- 源文件目录, 可以通过 项目->属性->Java构建路径 更改 -->
<property name="src.dir" value="./src" />
<!-- 输出的class文件目录,可以通过 项目->属性->Java构建路径 更改 -->
<property name="class.dir" value="./bin" />
<!-- 库文件目录 -->
<property name="lib.dir" value="D:/java/Hibernate/lib" />
<!-- 定义类路径 -->
<path id="project.class.path">
<fileset dir="${lib.dir}">
<include name="*.jar"/>
</fileset>
<pathelement location="${class.dir}" />
</path>
<!-- ************************************************************** -->
<!-- 使用说明 -->
<!-- ************************************************************** -->
<target name="help">
<echo message="利用工具开发Hibernate" />
<echo message="-----------------------------------" />
<echo message="" />
<echo message="提供以下任务:" />
<echo message="" />
<echo message="generate-code --> 运行Hbm2Java,利用 hbm.xml 文件生成Java类文件" />
<echo message="generate-hbm --> 运行HibernateDoclet,生成 Hibernate 类的映射文件" />
<echo message="schemaexport --> 运行SchemaExport,利用 hbm.xml 文件生成数据表" />
<echo message="" />
</target>
<!-- ************************************************************** -->
<!-- Hbm2Java 任务 -->
<!-- ************************************************************** -->
<target name="generate-code" >
<echo message="运行 Hbm2Java 任务, 利用 hbm.xml 文件生成Java类文件"/>
<taskdef name="hbm2java"
classname="net.sf.hibernate.tool.hbm2java.Hbm2JavaTask"
classpathref="project.class.path">
</taskdef>
<hbm2java output="${src.dir}">
<fileset dir="${src.dir}">
<include name="**/*.hbm.xml"/>
</fileset>
</hbm2java>
</target>
<!-- ************************************************************** -->
<!-- HibernateDoclet 任务 -->
<!-- ************************************************************** -->
<target name="generate-hbm" >
<echo message="运行HibernateDoclet,生成 Hibernate 类的映射文件"/>
<taskdef name="hibernatedoclet"
classname="xdoclet.modules.hibernate.HibernateDocletTask"
classpathref="project.class.path">
</taskdef>
<hibernatedoclet destdir="${src.dir}"
excludedtags="@version,@author,@todo" force="true" encoding="GBK"
verbose="true">
<fileset dir="${src.dir}">
<include name="**/*.java"/>
</fileset>
<hibernate version="2.0" xmlencoding="GBK" />
</hibernatedoclet>
</target>
<!-- ************************************************************** -->
<!-- SchemaExport 任务 -->
<!-- ************************************************************** -->
<target name="schemaexport">
<echo message="运行SchemaExport,利用 hbm.xml 文件生成数据表"/>
<taskdef name="schemaexport"
classname="net.sf.hibernate.tool.hbm2ddl.SchemaExportTask"
classpathref="project.class.path">
</taskdef>
<schemaexport config="${src.dir}/hibernate.cfg.xml" quiet="no"
text="no" drop="no" output="schema-export.sql">
</schemaexport>
</target>
</project>
· 最后的目录结构如下:
4. 运行任务
· 右击“build.xml” ->“运行” ->这里应该有“Ant 构建”和“Ant 构建...”两个菜单,其中“Ant 构建”直接运行缺省任务,这里是指“help”任务;如果要运行其它的任务,可以通过“Ant 构建...”菜单选择。
· 这里还有一种更好的方法,Eclipse主菜单上点击“窗口” ->“显示视图” ->点击“Ant”,这样就调出了Ant视图,在这个视图窗口的空白处,右击,在弹出菜单中选择“添加构建文件”,然后将HibernateBegin_2项目根目录下的“build.xml”文件载入即可。效果如图:
这样,想运行某个任务,直接双击Ant视图中的任务即可。
● 生成User.java
· 双击“generate-code”任务,在控制台应该可以看到如下输出:
· 如果在src目录下没有看到“User.java”这个文件,那么选中src目录,然后按一下“F5”功能键刷新一下src目录,应该可以在包“javamxj.hibernate”下看到“User.java”。这个文件就是“Hbm2Java”生成器根据hbm文件产生的,如下:
User.java
package javamxj.hibernate;
import java.io.Serializable;
import org.apache.commons.lang.builder.ToStringBuilder;
/**
*
* 运行 Hbm2Java 任务, 利用 hbm.xml文件生成Java类文件
* @author javamxj(分享java快乐)
* @link Blog: htpp://javamxj.mblogger.cn
* htpp://blog.csdn.net/javamxj/
*
*/
public class User implements Serializable {
/** identifier field */
private String id;
/** persistent field */
private String username;
/** persistent field */
private String password;
/** full constructor */
public User(String username, String password) {
this.username = username;
this.password = password;
}
/** default constructor */
public User() {
}
public String getId() {
return this.id;
}
public void setId(String id) {
this.id = id;
}
/**
* @param 用户名
*/
public String getUsername() {
return this.username;
}
public void setUsername(String username) {
this.username = username;
}
public String getPassword() {
return this.password;
}
public void setPassword(String password) {
this.password = password;
}
public String toString() {
return new ToStringBuilder(this)
.append("id", getId())
.toString();
}
}
可以对照“User.hbm.xml”文件,看看都是哪些属性转化成什么代码。
● 生成数据表
· 启动MySql,应该确定含有HibernateTest数据库,不过这次不需要建立数据表了。
· 双击“schemaexport”任务,控制台输出如下,注意自动生成的SQL语句:
· 同时,在项目根目录下,也会产生一个“schema-export.sql”文件(如果没有,按F5键刷新目录),这个文件是在“build.xml”中设定的:
schema-export.sql
drop table if exists UserTable2
create table UserTable2 (
ID varchar(32) not null,
ddd varchar(24) not null,
密码 varchar(24) not null,
primary key (ID)
)
· 切换到数据库中,会发现已经自动产生了数据表usertable2:
5. 测试程序
好了,将上篇文章中的test.java文件复制到包“javamxj.hibernate”下,然后右击运行这个文件,可以看到数据表中生成的数据。
小结
好了,再来看看整个项目的结构,其中“User.java”和“schema-export.sql”两个文件都是自动生成的,要注意的一点是:生成“schema-export.sql”文件需要调用“User.java”文件,所以“generate-code”任务要在“schemaexport”任务前执行。
最好使用XMLBuddy插件来编辑xml文件,可以参考:
关于如何利用Hbm映射文件产生普通的Java对象及数据表,还需要多看看参考文档,也要多加练习,在实践中掌握,在实践中前进。
下篇文章会谈谈利用XDoclet开发Hibernate。