一个Hibernate实例

来源：互联网发布：修改sftp端口编辑：程序博客网时间：2024/04/26 05:28

本人采用hibernate3.2.5和hibernate3.3.1来作为学习的版本。

1.到hibernate官网http://www.hibernate.org上下载您需要的版本。本人下载了hibernate3.2.5和hibernate3.3.1两个版本。
2.将下载目录/hibernate3.jar和/lib下的hibernate运行时必须的包加入classpath中：
antlr.jar,cglib.jar,asm.jar,commons-collections.jar,commons-logging.jar,jta.jar,dom4j.jar。
当然，为了方便也可以直接把/lib目录下的所有jar一次性导入classpath下即可。

3. 将你要连接的具体数据库的驱动类jar包加入到classpath中。

4. 建立实体类：

我的实体类创建如下所示：

Java代码  
package com.reiyen.hibernate.domain;  
  
import java.util.Date;  
public class User {  
      
    private int id;  
    private String name;  
    private Date birthday;  
      
    public int getId() {  
        return id;  
    }  
      
    public void setId(int id) {  
        this.id = id;  
    }  
      
    public String getName() {  
        return name;  
    }  
      
    public void setName(String name) {  
        this.name = name;  
    }  
      
    public Date getBirthday() {  
        return birthday;  
    }  
      
    public void setBirthday(Date birthday) {  
        this.birthday = birthday;  
    }  
}  

5. 建立实体类与数据库表的映射关系（ORMapping）User.hbm.xml,将此配置文件置于与你创建的实体类的同一个包中,而不是直接放在classpath下面：

User.hbm.xml映射文件配置如下：（如果是在Oracle数据库中运行，此配置文件必须修改，改成<class name="User" table="test_user">即可，因为user在oracle数据库中是数据库关键字。如果表名一定是叫user的话，可以进行如下处理：table="`user`",给user加上反引号，告诉数据库将它当作一个普通的字符串来处理，而不是当作关键字来处理(如:定单order,它就是一个数据库关键字,所以必须处理,table="orders")。如果你的实体类中有其他的属性名（如:date）与数据库中的关键字冲突，你都可以修改它在数据库中映射的字段名或加反引号解决。）

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 package="com.reiyen.hibernate.domain">  
＜!--用class元素来定义一个持久化类 --＞  
    <class name="User" >  
        <id name="id" >  
            <generator class="native" />  
        </id>  
        <property name="name" />  
        <property name="birthday" />  
    </class>  
</hibernate-mapping>  

6.将你的配置文件hibernate.cfg.xml和hibernate.properties中的任一一个加入到classpath下（配置文件有xml和properites两种），这两个文件的作用是一样的，提供一个即可（如果两个配置文件都有的情况下，XML配置文件会覆盖掉properites文件中的属性，因为XML文件中的属性信息反馈级高于properties中的属性）。（这里需要注意一点：

一般在实际应用中，你的hibernate.cfg.xml配置文件并没有直接像导入jar包一样导入到classpath下，而只要放到你的Eclipse建立的工程的src目录下即可，hibernate就能自动找到。这是为什么呢？因为src目录确实不在classpath下面，但因为你的项目进行编译时，Eclipse会将你的源文件编译后存在一个叫bin的目录下，同时你的配置文件也相应的复制过去了，而这个bin目录属于classpath的一部分，所以Hibernat就能自动找到你的配置文件了。你可以打开你的工程下的.classpath文件，里面有一行：<classpathentry kind="output" path="bin"/>。你也可以把bin目录下的hibernate.cfg.xml文件删除然后再运行一下原来的程序，它会抛出如下的一个异常：Caused by: org.hibernate.HibernateException: /hibernate.cfg.xml not found。如果你的工程是Web工程，则配置文件会复制到WebRoot/WEB-INF/classes下面去。同时在你的.classpath文件下有一行：<classpathentry kind="output" path="WebRoot/WEB-INF/classes"/>）。同时将你的映射配置文件User.hbm.xml在此配置文件中注册。推荐xml格式的文件。下载目录/etc(版本hibernate3.2.5）或下载目录/project/etc（版本hibernate3.3.1）下是示例配置文件。
    可以在配置文件中指定：
    数据库的URL、用户名、密码、JDBC驱动类、方言等。
    程序启动时，hibernate会在CLASSPATH下寻找这个配置文件。当然这个文件你也可以不放在CLASSPATH下，这在以后再详细说明。

我的配置文件hibernate.cfg.xml（当然名字也可以取成其他名字，这也这以后详解）如下所示：

Xml代码  
<!--表明解析本XML文件的DTD文档位置，DTD是Document Type Definition 的缩写,即文档类型的定义,XML解析器使用DTD文档来检查XML文件的合法性。hibernate.sourceforge.net/hibernate-configuration-3.0dtd可以在 Hibernate3.2.5软件包中的src\org\hibernate目录中找到此文件-->  
<!DOCTYPE hibernate-configuration PUBLIC  
    "-//Hibernate/Hibernate Configuration DTD 3.0//EN"  
    "http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd">  
<!--声明Hibernate配置文件的开始-->  
<hibernate-configuration>  
    <!--表明以下的配置是针对session-factory配置的，SessionFactory是Hibernate中的一个类，这个类主要负责保存HIbernate的配置信息，以及对Session的操作-->  
    <session-factory>  
        <!--配置数据库的驱动程序，Hibernate在连接数据库时，需要用到数据库的驱动程序-->  
        <property name="hibernate.connection.driver_class">  
            com.mysql.jdbc.Driver  
        </property>  
        <!--设置数据库的连接url:jdbc:mysql://localhost:port/test,其中localhost表示mysql服务器名称，此处为本机。port代表mysql服务器的端口号，默认是3306。test是数据库名，这是你要连接的数据库名-->  
        <property name="hibernate.connection.url">  
            jdbc:mysql://localhost:3306/test  
        </property>  
        <!--如果你的mysql服务器都是默认设置的，且装在本机器上，则也可以写成  
            property name="hibernate.connection.url">  
            jdbc:mysql://localhost/test  
            </property>或  
            <property name="hibernate.connection.url">  
            jdbc:mysql:///test  
            </property>  
        -->  
        <!--连接数据库的用户名-->  
        <property name="hibernate.connection.username">root</property>  
        <!--连接数据库的密码-->  
        <property name="hibernate.connection.password"></property>  
        <!--hibernate.dialect 是Hibernate使用的数据库方言,就是要用Hibernate连接哪种类型的数据库服务器。-->  
        <property name="dialect">  
            org.hibernate.dialect.MySQLDialect  
        </property>  
  
<!--hibernate.hbm2ddl  
.auto  
指定由java代码生成数据库脚本,进而生成具体的表结构的具体方式    -->    
<property name="hbm2ddl.auto">update</property>  
        <!--是否在后台显示Hibernate生成的查询数据库的SQL语句，开发时设置为true，便于查询错误，程序运行时可以在Eclipse的控制台显示Hibernate执行的Sql语句。项目部署后可以设置为false，提高运行效率-->  
        <property name="show_sql">true</property>  
    <!--指定映射文件为"com/reiyen/hibernate/domain/User.hbm.xml"-->             
        <mapping resource="com/reiyen/hibernate/domain/User.hbm.xml" />  
    </session-factory>  
</hibernate-configuration>  

7.用JUnit对第一个hibernate实例进行测试（即在eclipse中创建一个junit.test.case，然后导入junit jar包）：

测试代码如下：

Java代码  
public class TestUser {  
  
    @Test  
    public void test1(){  
        Configuration config = new Configuration();  
        config.configure();  
             // 如果hibernate.cfg.xml中没有配置的某些属性，你可以通过config.setProperty(propertyName, value);来配置.  
        //如config.setProperty("hibernate.connection.driver_class", "com.mysql.jdbc.Driver");  
        SessionFactory factory = config.buildSessionFactory();  
      
        Session session = factory.openSession();  
                Transaction tran = session.beginTransaction();  
        User user = new User();  
        user.setBirthday(new Date());  
        user.setName("xxlong1");  
        session.save(user);  
               //session.persist(user);  
        tran.commit();  
        session.close();    }  
}  

测试结果显示是绿条，说明测试成功。然后进入我的mysql的test数据库中发现创建了一个新的user表，且表中有了一条新记录！在测试时一定要记得开启事务，否则，虽然会在你的Eclipse控制台打印出Hibernate: insert into User (name, birthday) values (?, ?), junit测试结果报告也是绿条，但在数据库里面是没有相应的记录的。因为你未开启事务，数据插入数据库里面后，在Session关闭前它一直没有等到commit命令，所以在Session关闭时，记录又被rollback了。这就是你在控制台能看到hibernate打印出insert into语句，但数据库里却没有相应记录的原因。在测试时，保存对象时也可以用persist方法。使用此方法时，如果未开启事务，测试报告也会是绿条，但同样也不会在数据库里面是没有相应的记录的。但和save方法的区别是，你在控制台也看不到hibernate产生的insert into语句，这就说明在未开启事务时，persist方法压根就不会往数据库里面插入数据。

注意：1.一定要记得加入具体数据库的驱动jar包，否则会出现JDBC Driver class not found的异常！

2. 一定要记隹在hibernate配置文件hibernate.cfg.xml中注册你的映射文件

Xml代码  
<!--指定映射文件为"com/reiyen/hibernate/domain/User.hbm.xml"-->             
        <mapping resource="com/reiyen/hibernate/domain/User.hbm.xml" />  

否则会出现异常:org.hibernate.MappingException: Unknown entity: com.reiyen.hibernate.domain.User
3.保证你的mysql中存在名为test的数据库。

4.为了能让hibernate在数据库中自动创建表，配置文件hibernate.cfg.xml中项:hbm2ddl.auto这一项不能少:

Xml代码  
<!--hibernate.hbm2ddl.auto指定由java代码生成数据库脚本,进而生成具体的表结构的具体方式   -->    
<property name="hbm2ddl.auto">update</property>  

"hibernate.hbm2ddl .auto "包含以下四个属性：（http://www.jroller.com/eyallupu/entry/hibernate_s_hbm2ddl_tool有详细的说明）

create-drop : 会根据你的实体类来生成表。但是hibernate每次初始化时都会删除掉上一次的所有表,再重新生成表,即使这两次的表结构没有任何改变，但虚拟机退出时（即Web程序服务器关闭，应用程序运行结束时）又会删除此次所创建的表。
create : 会根据你的实体类来生成表。但是hibernate每次初始化时都会删除掉上一次的所有表,再重新生成表,即使这两次的表结构没有任何改变，但虚拟机退出时（即Web程序服务器关闭，应用程序运行结束时）不会删除此次所创建的表。
update : 最常用的属性，会根据你的实体类来生成表,即使表结构改变了,表中的行仍然存在,不会删除以前的行，只会更新表结构。
validate : 只会和数据库中的表进行比较,不会创建新表,但是会插入新值。