这篇文章主要谈谈Hibernate的入门开发,例子很简单,就是向数据表中添加用户名和密码。我分别使用了三种方法,一种是直接写代码,写Hbm映射文件等;一种是通过Hbm映射文件来生成代码;一种是通过代码来生成Hbm映射文件。使用了一些自动化工具,XMLBuddy是用来编辑XML文件的,JBoss Eclipse IDE是用来编写Doclet标记的。这篇文章还谈到了一些Eclipse的使用技巧,比如建立“用户库”、“生成 Getter 和 Setter”等。
 
   关于一些软件的使用技巧,我以前的文章都有提及,这里不多说了,必要时会提示一下。
   
 
 
1. 所需软件
Ant 1.6.2        http://ant.apache.org
 
 Eclipse 3.0.1 及 语言包
 

XDoclet  1.2.2   http://xdoclet.sourceforge.net/xdoclet/
 
XMLBuddy          http://www.xmlbuddy.com/
    下载             XMLBuddy 2.0.38   
 
   看看说明,需要挑选与使用的eclipse相对应的版本,这里选择JBossIDE-1.4.1-e30.zip,这是它的镜像下载地址:
 
Hibernate         http://www.hibernate.org/
     下载            Hibernate 2.1.8
 
   同时也要把 Hibernate Extensions 2.1.3 下载了,它包含一些工具类。
 
 

●  MySQL 4.1.8

     注意需要mysql-connector-java-3.0.16-ga-bin.jar文件

 
 
 

2. 安装和配置 
 
    这里着重指出一下,需要在环境变量中设置 ANT_HOME ,并将其指向Ant安装目录,还要在Path变量值中添加 “%ANT_HOME%\bin;”。

 java环境变量设置 

由于软件本身升级比较频繁,经常需要重新设置使用的环境变量,而且我常常同时安装同一软件的不同版本(甚至是相同版本)。如eclipse我就分别在F,G,H三个盘上装了不同的版本,一个是中文版,一个是英文的Latest Release,一个是Stream Stable,反正是绿色安装,也不会发生冲突,这样通过对比便于了解和测试最新版本的先进之处。

   但是假如把JDK版本从1.3升级到1.4,即JDK目录名可能要从“j2sdk1.3”改为“j2sdk1.4”,如果是这样的话,那么eclipse可能会无法再启动了(它要从环境变量中寻找JAVA_HOME变量,而JAVA_HOME变量值已经从“j2sdk1.3”改为“j2sdk1.4”了)。
   在谈谈jakarta-tomcat,这个软件升级比较频繁,如果你是结合eclipse来使用Tomcat的,那么每次Tomcat升级,可能都要在eclipse中重新设置一下Tomcat的安装目录,是不是有些麻烦?
 
    对于此类问题,解决的方法很简单,只要把默认的软件安装目录名去掉版本号即可(如果担心忘记版本号,只要在目录中添加一个readme文件加以说明即可)。
   
如上图,我的j2sdk,ant,jakata-tomcat等都没有版本号。
 
   同样,在环境变量设置中也没有出现版本号。
   
 
这样,如果再需要升级软件时,仅仅把新版软件安装在旧版软件目录即可。其它一般都不需要再改动了。
 
另外,在环境变量设置中,可以用%变量%代替变量值,如Path变量值可以这样设置:  %JAVA_HOME%\bin;%JBOSS_HOME%\bin;%ANT_HOME%\bin;

 
 · XMLBuddy 和Jboss-ide 我都是采用links方式安装的,
 
●  建立库文件夹:
 

   在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>

    <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&amp;characterEncoding=GBK" 表示使用GBK进行编码 -->
        <property name="connection.url">
	  jdbc:mysql://localhost:3306/HibernateTest?useUnicode=true&amp;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)

);

    这里,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,理论方面我不想过多纠缠,尽量以实例说话。我想,与其凭空说一个技术多好多好,倒不如给我一个可以上手的实例操作一下。好了,不多说废话了。

这里主要介绍当前最新的eclipse3.0.1版本及其语言包的下载与安装。
 
下载eclipse和其语言包
 
   eclipse需要是3.0.1版本的,不要是3.0版本的,因为它和语言包不匹配。可以从eclipse的官方网站选择一个镜像站点http://www.eclipse.org/downloads/index.php下载,下面我发现下载速度比较快的站点。

eclipse

 

 

 
 
 
 
http://eclipse.openwebeng.com/downloads/            (国内)

语言包
 
 
 

 
二.安装eclipse和其语言包
 
环境要求:Java(TM) 2 SDK,建议使用使用比较新的版本,如1.4.2版本(我的计算机的环境是 Windows XP SP1,Java(TM) 2 SDK v1.4.2_04)。

  首先解压Eclipse3.0.1到一个目录(这里我解压到I:\eclipse),然后把语言包NLpack-eclipse-SDK-3.0.x-win32.zip也解压到I:\eclipse目录。然后双击此目录中的eclipse.exe文件即可打开eclipe。效果如下:

注意:
   最好使用一个从未被启动过的Eclipse3.0.1,这样可以完全中文化。
   如果在安装中文包时Eclipse已经被使用过,则可能会出现有部分内容不能被汉化,比如“搜索”、“运行”等菜单。如果中文化的不完全,把eclipse 目录下的configuration目录删除,重启即可。
   也可以采用links方式安装这个语言包,可以参考  http://blog.csdn.net/javamxj/archive/2004/10/11/132311.aspx 

  装好后默认启动是中文,但也可以选择的,如:

<eclipse_home>/eclipse.exe -nl en_US 是启动英文版

<eclipse_home>/eclipse.exe -nl zh_CN 是启动简体中文版

 
 
   对于e文不好的人或者初学者来说,中文版本的eclipse可以显著提高学习效率,便于接受和使用eclipse。但是,毕竟当前先进的技术是英文一统天下,所以,在对eclipse有了初步的认识之后,还是建议大家多使用英文版的eclipse,这样,对以后的进一步学习和使用有好处。
   在我即将发表的一些有关eclipse的文章,主要还是使用中文版的eclipse,这样便于新手容易接受,但以后我会逐步向英文版的eclipse靠拢。

版权声明:本文为linzhanyu原创文章,遵循 CC 4.0 BY-SA 版权协议,转载请附上原文出处链接和本声明。
本文链接:https://www.cnblogs.com/linzhanyu/articles/136422.html