这篇文章主要谈谈Hibernate的入门开发,例子很简单,就是向数据表中添加用户名和密码。我分别使用了三种方法,一种是直接写代码,写Hbm映射文件等;一种是通过Hbm映射文件来生成代码;一种是通过代码来生成Hbm映射文件。使用了一些自动化工具,XMLBuddy是用来编辑XML文件的,JBoss Eclipse IDE是用来编写Doclet标记的。这篇文章还谈到了一些Eclipse的使用技巧,比如建立“用户库”、“生成 Getter 和 Setter”等。
关于一些软件的使用技巧,我以前的文章都有提及,这里不多说了,必要时会提示一下。
一、下载、安装和配置1. 所需软件
● Ant 1.6.2http://ant.apache.org
下载 http://mirror.apache.or.kr/ant/binaries/apache-ant-1.6.2-bin.zip
●Eclipse 3.0.1及 语言包
参考: http://blog.csdn.net/javamxj/archive/2004/10/11/131952.aspx
● XDoclet 1.2.2 http://xdoclet.sourceforge.net/xdoclet/
下载 http://prdownloads.sourceforge.net/xdoclet/xdoclet-bin-1.2.2.zip?download
● XMLBuddy http://www.xmlbuddy.com/
下载 XMLBuddy 2.0.38 ● JBoss Eclipse IDEhttp://www.jboss.org/products/jbosside
看看说明,需要挑选与使用的eclipse相对应的版本,这里选择JBossIDE-1.4.1-e30.zip,这是它的镜像下载地址:
http://prdownloads.sourceforge.net/jboss/JBossIDE-1.4.1-e30.zip?download● Hibernate http://www.hibernate.org/
下载 Hibernate 2.1.8
http://prdownloads.sourceforge.net/hibernate/hibernate-2.1.8.zip?download 同时也要把 Hibernate Extensions 2.1.3 下载了,它包含一些工具类。
下载 http://prdownloads.sourceforge.net/hibernate/hibernate-extensions-2.1.3.zip?download
● MySQL4.1.8
参考:http://blog.csdn.net/javamxj/archive/2005/01/13/251861.aspx
注意需要mysql-connector-java-3.0.16-ga-bin.jar文件
2. 安装和配置
这里着重指出一下,需要在环境变量中设置 ANT_HOME ,并将其指向Ant安装目录,还要在Path变量值中添加 “%ANT_HOME%\bin;” 可以参考 java环境变量设置 。· XMLBuddy和Jboss-ide 我都是采用links方式安装的, 参考 http://blog.csdn.net/javamxj/archive/2004/10/11/132311.aspx
● 建立库文件夹: 在D盘下新建一个java目录,在此目录下新建一个Hibernate子目录,在此子目录下再新建一个lib子目录。
D:-java
-Hibernate
-lib
· 将下载的hibernate-2.1.8.zip解压,如解压后的目录名为hibernate-2.1,将这个目录下的hibernate2.jar复制到先前建立的lib目录下,即D:\java\Hibernate\lib目录;
· 然后将hibernate-2.1目录下的lib子目录中的以下文件也复制到这个lib目录下:
jta.jar cglib-full-2.0.2.jar commons-collections-2.1.1.jar commons-logging-1.0.4.jar commons-lang-1.0.1.jar dom4j-1.4.jar ehcache-0.9.jar log4j-1.2.8.jar odmg-3.0.jarodmg-3.0.jar
·解压hibernate-extensions-2.1.3.zip,将其子目录tools中的hibernate-tools.jar和子目录lib中的velocity-1.3.1.jar、jdom.jar 也复制到D:\java\Hibernate\lib目录中
·解压xdoclet-bin-1.2.2.zip,将其子目录lib中的xdoclet-1.2.2.jar、xdoclet-hibernate-module-1.2.2.jar、xjavadoc-1.1.jar、xdoclet-xdoclet-module-1.2.2.jar 也复制到D:\java\Hibernate\lib目录中
· 最后将mysql-connector-java-3.0.16-ga-bin.jar文件复制到这个lib目录下。
这样,需要用到的库文件已经准备好了,如果认为这样比较麻烦,也可以将jar文件全部复制到lib目录。下面介绍如何在Eclipse中设置“用户库”。
● 设置“用户库”·窗口 ->首选项 ->Java ->构建路径 ->用户库,
· 然后单击“添加JAR”
这样,一个用户库文件就做好了,如果要更新Eclipse时,可以将其先导出,然后再导入即可。
这样做,对库文件便于管理,而且如果需要替换或者升级的话都比较方便。
● 设置“构建路径”
· 点击菜单“窗口”->首选项,以下都在“首选项”中配置:
Java->构建路径
二、项目实践
这里以一个简单的程序来示范Hibernate的配置与功能,在这个例子中的一些操作,实际上会使用一些自动化工具来完成,而不一定亲自手动操作设定,这边完全手动的原因,在于让你可以知道Hibernate的基本流程。
这是整个项目的结构:
好了,下面就开始创建项目了。
1. 创建项目
· 新建一个Java项目:HibernateBegin_1,注意选中“创建单独的源文件夹和输出文件夹”。点击“下一步”,切换到“库”,点击“添加库”,如下图:
· 选择“用户库”
· 勾选先前设置好的hibernate用户库。
2. 建立可持久化类
· 下面开始创建一个新类:User ;包名:javamxj.hibernate ;
然后添加三个变量(斜体),代码如下:
/*
* 采用常规方法开发一个简单的Hibernate实例
* 创建日期 2005-3-31
* @author javamxj(分享java快乐)
* @link Blog: htpp://javamxj.mblogger.cn
* htpp://blog.csdn.net/javamxj/
*/
package javamxj.hibernate;
public class User {
private int id;
private String username;
private String password;
}
· 点击工具栏上的“源代码(S)”,选择其中的“生成 Getter 和 Setter”(右击,在弹出菜单也可选择),如图:
点击“确定”后,生成如下代码:
/*
* 采用常规方法开发一个简单的Hibernate实例
* 创建日期 2005-3-31
* @author javamxj(分享java快乐)
* @link Blog: htpp://javamxj.mblogger.cn
* htpp://blog.csdn.net/javamxj/
*/
package javamxj.hibernate;
public class User {
private int id;
private String username;
private String password;
public int getId() {
return id;
}
public void setId(int id) {
this.id = id;
}
public String getPassword() {
return password;
}
public void setPassword(String password) {
this.password = password;
}
public String getUsername() {
return username;
}
public void setUsername(String username) {
this.username = username;
}
}
好了,这个类完成了。它是一个普通的Java对象(Plain Old Java Objects,就是POJOs,有时候也称作Plain Ordinary Java Objects),表示一个数据集合。下面建立一个Hbm文件将这个类映射到数据库的表格上。
3. 映射文件
在javamxj.hibernate包下,新建一个名称为“User.hbm.xml”的文件,使用XMLBuddy编辑它(参考:利用XMLBuddy在Eclipse中开发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="UserTable">
<id name="id">
<generator class="assigned" />
</id>
<property name="username" />
<property name="password" />
</class>
</hibernate-mapping>
这个XML文件定义了对象属性映射到数据库表的关系,这里采用了assigned(程序设置)方式生成主键。当然还可以使用其它的方式来产生主键,后面的文章就采用了其它的方式产生主键。<property>标签用于定义Java对象的属性,这里只定义了最简单的方式,由Hibernate自动判断Java对象属性与数据库表名称对应关系。在<property/>标签上的额外设定(像是not null、sql-type等),则可以用于自动产生Java对象与数据库表的工具上。
4. 配置文件
Hibernate可以使用XML或属性文件来进行配置,配置文件名默认为“hibernate.cfg.xml”(或者hibernate.properties)。
在src目录下,新建一个hibernate.cfg.xml文件,内容如下:
<?xml version='1.0' encoding='GBK'?>
<!DOCTYPE hibernate-configuration
PUBLIC "-//Hibernate/Hibernate Configuration DTD//EN"
"http://hibernate.sourceforge.net/hibernate-configuration-2.0.dtd">
<hibernate-configuration>
<ses