Eclipse快速上手Hibernate--1. 入门实例
2024-07-21 02:05:42
供稿：网友
这篇文章主要谈谈hibernate的入门开发，例子很简单，就是向数据表中添加用户名和密码。我分别使用了三种方法，一种是直接写代码，写hbm映射文件等；一种是通过hbm映射文件来生成代码；一种是通过代码来生成hbm映射文件。使用了一些自动化工具，xmlbuddy是用来编辑xml文件的，jboss eclipse ide是用来编写doclet标记的。这篇文章还谈到了一些eclipse的使用技巧，比如建立“用户库”、“生成 getter 和 setter”等。 关于一些软件的使用技巧，我以前的文章都有提及，这里不多说了，必要时会提示一下。 一、下载、安装和配置 1. 所需软件● ant 1.6.2 http://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 ide http://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 ● mysql 4.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.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->构建路径 ● 更新xdoclet-hibernate-module 将xdoclet1.2.2中的xdoclet-hibernate-module-1.2.2.jar复制到jbosside-1.4.1-e30/eclipse/plugins/org.jboss.ide.eclipse.xdoclet.core_1.4.1目录中，并且删除其目录下的xdoclet-hibernate-module-1.2.1.jar文件，然后在eclipse界面中，窗口 ->首选项 ->jboss-ide ->xdoclet ->code assist：点击右侧的“refresh xdoclet data”栏，即可完成更新。如果要替换其它的模块，步骤与此类似。 二、项目实践 这里以一个简单的程序来示范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> <session-factory> <!-- 是否将运行期生成的sql输出到日志以供调试 --> <property name="show_sql">true</property> <!-- sql方言，这里设定的是mysql --> <property name="dialect">net.sf.hibernate.dialect.mysqldialect</property> <!-- jdbc驱动程序 --> <property name="connection.driver_class">com.mysql.jdbc.driver</property> <!-- jdbc url, "?useunicode=true&characterencoding=gbk" 表示使用gbk进行编码 --> <property name="connection.url"> jdbc:mysql://localhost:3306/hibernatetest?useunicode=true&characterencoding=gbk </property> <!-- 数据库用户名 --> <property name="connection.username">root</property> <!-- 数据库密码 --> <property name="connection.password">javamxj</property> <!-- 指定user的映射文件 --> <mapping resource="javamxj/hibernate/user.hbm.xml"/> </session-factory></hibernate-configuration>
注意：这里使用的是“jdbc:mysql://localhost:3306/hibernatetest?useunicod...”中的hibernatetest数据库，你需要在mysql中建立这个数据库。 5. 测试程序 在javamxj.hibernate包下，新建一个test类，内容如下：
/* * 简单测试一下user类 * 创建日期 2005-3-31 * @author javamxj（分享java快乐） */package javamxj.hibernate;import net.sf.hibernate.*;import net.sf.hibernate.cfg.*;public class test {public static void main(string[] args) {try {sessionfactory sf = new configuration().configure().buildsessionfactory();session session = sf.opensession();transaction tx = session.begintransaction();user user = new user();user.setusername("blog");user.setpassword("分享java快乐");session.save(user);tx.commit();session.close();} catch (hibernateexception e) {e.printstacktrace();}}}
这里简单说说一下流程，首先初始化configuration，加载hibernate的配置信息，然后configuration取得sessionfactory对象，并由它来开启一个session，它代表对象与表格的一次会话操作，而 transaction则表示一组会话操作，我们只需要直接操作user对象，并进行session与transaction的相关操作， hibernate就会自动完成对数据库的操作。 6. 配置数据库 在运行测试程序之前，还必须先设置好数据库。 在mysql中建立一个hibernatetest数据库，并建立usertable表，sql语句如下： create table usertable ( id int(6) not null auto_increment, username varchar(24) not null default '', password varchar(24) not null default '', primary key (id)); create table usertable ( id int(6) not null auto_increment, username varchar(24) not null default '', password varchar(24) not null default '', primary key (id)); 这里，hibernatetest与hibernate.cfg.xml配置文件中的hibernatetest相对应，usertable与hbm映射文件中的usertable相对应。 7. 运行程序 右击test.java，点击运行，可以看到控制台输出一系列信息，最后一条输出语句应该是：hibernate: insert into usertable (username, password, id) values (?, ?, ?) 在下篇文章中会介绍如何利用log4j来控制输出信息。 同时，在数据库中可以看到，数据已经添加进表里了： 小结： hibernate原理方面我不想多说，实际上知道也不多，况且这方面的资料很多，比如hibernate本身自带的中文文档、夏昕编写的《hibernate开发指南》、良葛格编写的“hibernate入门”等都是非常不错的，现在关于hibetnate的书籍也多了起来。 我所作的工作就是要使新手能尽快上手hibernate，理论方面我不想过多纠缠，尽量以实例说话。我想，与其凭空说一个技术多好多好，倒不如给我一个可以上手的实例操作一下。好了，不多说废话了。 小结： hibernate原理方面我不想多说，实际上知道也不多，况且这方面的资料很多，比如hibernate本身自带的中文文档、夏昕编写的《hibernate开发指南》、良葛格编写的“hibernate入门”等都是非常不错的，现在关于hibetnate的书籍也多了起来。 我所作的工作就是要使新手能尽快上手hibernate，理论方面我不想过多纠缠，尽量以实例说话。我想，与其凭空说一个技术多好多好，倒不如给我一个可以上手的实例操作一下。好了，不多说废话了。
