Hibernate基本介绍+一个简单的程序

Hibernate基本介绍+一个简单的程序

 
一、基础入门

从一个最基本的对象关系映像自动化程序，了解Hibernate组成的基本元素，并进一步了解Hibernate的基础语义、配置等概念。

1．O/R映像入门第一个Hibernate程序很简单，将一个对象映像至一个数据表

1．1配置Hibernate
Hibernate是ORM的解决方案，其底层对数据库的操作依赖于JDBC，所以您必须先取得JDBC驱动程序，在这边所使用的是MySQL，所以您必须至MySQL®Connector/J取得MySQL的JDBC驱动程序。

接下来至Hibernate官方网站取得hibernate 3.0。

解开zip档案后，当中的hibernate3.jar是必要的，而在lib目录中还包括了许多jar档案，您可以在Hibernate 3.0官方的参考手册上找到这些jar的相关说明，其中必要的是antlr、dom4j、CGLIB、asm、Commons Collections、Commons Logging、 EHCache，Hibernate底层还需要Java Transaction API，所以您还需要jta.jar，到这边为止，总共需要以下的jar档案：

Hibernate可以运行于单机之上，也可以运行于Web应用程序之中，如果是运行于单机，则将所有用到的jar档案（包括JDBC驱动程序）设定至CLASSPATH中，如果是运行于Web应用程序中，则将jar档案置放于WEB-INF/lib中。

如果您还需要额外的Library，再依需求加入，例如JUnit、Proxool等等，接下来可以将etc目录下的log4j.properties复制至Hibernate项目的Classpath下，并修改一下当中的log4j.logger.org.hibernate为error，也就是只在错误发生时显示必要的讯息。

接着设置基本的Hibernate配置文件，可以使用XML或Properties档案，这边先使用XML，档名预设为hibernate.cfg.xml：

hibernate.cfg.xml

<?xml version="1.0" encoding="utf-8"?><!DOCTYPE hibernate-configuration PUBLIC"-//Hibernate/Hibernate Configuration DTD 3.0//EN""http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"><hibernate-configuration><session-factory><!-- 显示实际操作数据库时的SQL --><property name="show_sql">true</property><!-- SQL 方言，这边设定的是MySQL --><property name="dialect">org.hibernate.dialect.MySQLDialect</property><!-- JDBC 驱动程序 --><property name="connection.driver_class">com.mysql.jdbc.Driver</property><!-- JDBC URL --><property name="connection.url">jdbc:mysql://localhost/demo</property><!-- 数据库使用者 --><property name="connection.username">caterpillar</property><!-- 数据库密码 --><property name="connection.password">123456</property><!-- 以下设置对象与数据库表格映像文件 --></session-factory></hibernate-configuration>



配置文件中已经加上批注为每一个项目作了说明，其中对象与数据库表格映像文件还有待加入。

1．2第一个Hibernate
这边以一个简单的单机程序来示范Hibernate的配置与功能，首先作数据库的准备工作，在MySQL中新增一个demo数据库，并建立user表格：

CreateUser2MySQL.sql

CREATE TABLE user (id INT(11) NOT NULL auto_increment PRIMARY KEY,name VARCHAR(100) NOT NULL default '',age INT);



对于这个表格，您有一个User类别与之对应，表格中的每一个字段将对应至User实例上的Field成员。

User.java

package onlyfun.caterpillar;public class User {private Integer id;private String name;private Integer age;// 必须要有一个预设的建构方法// 以使得Hibernate 可以使用Constructor.newInstance()建立对象public User() {}public Integer getId() {return id;}public void setId(Integer id) {this.id = id;}public String getName() {return name;}public void setName(String name) {this.name = name;}public Integer getAge() {return age;}public void setAge(Integer age) {this.age = age;}}



其中id是个特殊的属性，Hibernate会使用它来作为主键识别，您可以定义主键产生的方式，这是在XML映像文件中完成，为了告诉Hibernate您所定义的User实例如何映像至数据库表格，您撰写一个XML映射文件档名是User.hbm.xml，如下所示：

User.hbm.xml

<?xml version="1.0" encoding="utf-8"?><!DOCTYPE hibernate-mapping PUBLIC "-//Hibernate/Hibernate Mapping DTD 3.0//EN""http://hibernate.sourceforge.net/hibernate-mapping-3.0.dtd"><hibernate-mapping><class name="onlyfun.caterpillar.User" table="user"><id name="id" column="id" type="java.lang.Integer"><generator class="native" /></id><property name="name" column="name" type="java.lang.String" /><property name="age" column="age" type="java.lang.Integer" /></class></hibernate-mapping>



<class>卷标的name属性为所映像的对象，而table为所映像的表格；<id>中column属性指定了表格字段，而type属性指定了User实例的中的id之型态，这边type中所设定的是直接指定Java中的对象型态，Hibernate也定义有自己的映像型态，作为Java对象与SQL型态的标准对应型态（因为语言所提供的类型并不一定与数据库的类型对应），这之后会再说明。

#p#

<id>中主键的产生方式在这边设定为"native"，表示主键的生成方式由Hibernate根据数据库Dialect的定义来决定，之后还会介绍其它主键的生成方式。

同样的，<property>标签中的column与type都各自指明了表格中字段与对象中属性的对应。

接着必须在Hibernate配置文件hibernate.cfg.xml中指明映像文件的位置，如下加入映像文件位置：

hibernate.cfg.xml

<?xml version="1.0" encoding="utf-8"?><!DOCTYPE hibernate-configuration PUBLIC"-//Hibernate/Hibernate Configuration DTD 3.0//EN""http://hibernate.sourceforge.net/hibernate-configuration-3.0.dtd"><hibernate-configuration><session-factor>....<!-- 对象与数据库表格映像文件 --><mapping resource="onlyfun/caterpillar/User.hbm.xml"/></session-factory></hibernate-configuration>



接下来撰写一个测试的程序，这个程序直接以Java 程序设计人员熟悉的语法方式来操作对象，而实际上也直接完成对数据库的操作，程序将会将一笔数据存入表格之中：

FirstHibernate.java

package onlyfun.caterpillar;import org.hibernate.Session;import org.hibernate.SessionFactory;import org.hibernate.Transaction;import org.hibernate.cfg.Configuration;public class FirstHibernate {public static void main(String[] args) {// Configuration 负责管理 Hibernate 配置讯息Configuration config = new Configuration().configure();// 根据 config 建立 SessionFactory// SessionFactory 将用于建立 SessionSessionFactory sessionFactory = config.buildSessionFactory();//将持久化的物件User user = new User();user.setName("caterpillar");user.setAge(new Integer(30));//开启Session，相当于开启JDBC 的ConnectionSession session = sessionFactory.openSession();//Transaction 表示一组对DB 的交易Transaction tx = session.beginTransaction();//将对象映像至数据库表格中储存session.save(user);tx.commit();session.close();sessionFactory.close();System.out.println("新增资料OK!请先用MySQL 观看结果！");}}



如您所看到的，程序中只需要直接操作User 对象，并进行Session 与Transaction 的相关操作，Hibernate 就会自动完成对数据库的操作，您看不到任何一行JDBC 或SQL 的陈述，撰写好以上的各个档案之后，各档案的放置位置如下：

接着可以开始运行程序，结果如下：

FirstHibernate执行结果

Hibernate: insert into user (name, age) values (?, ?)



新增资料OK!请先用MySQL 观看结果！

执行结果中显示了Hibernate 所实际使用的SQL，由于这个程序还没有查询功能，所以要
进入MySQL 中看看新增的数据，如下：

MySQL 中查询结果

mysql> select * from user;+----+-------------+------+| id | name | age |+----+-------------+------+| 1 | caterpillar | 30 |+----+-------------+------+1 row in set (0.03 sec)



Comments

第四段代码的标题应该是hibernate.cfg.xml

1．3 第二个 Hibernate
在 第一个 Hibernate 中介绍如何使用Hibernate 在不使用SQL 的情况下，以Java 中操作对象的习惯来插入数据至数据库中，当然储存数据之后，更重要的是如何将资料读出，Hibernate 中也可以让您不写一句SQL，而以Java 中操作对象的习惯来查询数据。

直接来看个范例：

SecondHibernate.java

package onlyfun.caterpillar;import org.hibernate.Criteria;import org.hibernate.Session;import org.hibernate.SessionFactory;import org.hibernate.cfg.Configuration;import org.hibernate.criterion.Expression;import java.util.Iterator;import java.util.List;public class SecondHibernate {public static void main(String[] args) {Configuration config = new Configuration().configure();SessionFactory sessionFactory = config.buildSessionFactory();Session session = sessionFactory.openSession();Criteria criteria = session.createCriteria(User.class);// 查询user 所有字段List users = criteria.list();Iterator iterator = users.iterator();System.out.println("id \t name/age");while (iterator.hasNext()) {User user = (User) iterator.next();System.out.println(user.getId() + " \t " + user.getName() + "/" +user.getAge());}// 查询user 中符合条件的字段criteria.add(Expression.eq("name", "caterpillar"));users = criteria.list();iterator = users.iterator();System.out.println("id \t name/age");while (iterator.hasNext()) {User user = (User) iterator.next();System.out.println(user.getId() + " \t " + user.getName() + "/" +user.getAge());}session.close();sessionFactory.close();}}



#p#

Criteria 对SQL 进行封装，对于不甚了解SQL 的开发人员来说，使用Criteria 也可以轻易的进行各种数据的检索，您也可以使用 Expression 设定查询条件，并将之加入Criteria中对查询结果作限制，Expression.eq()表示设定符合条件的查询，例如Expression.eq("name", "caterpillar")表示设定查询条件为"name"字段中为"caterpillar"的数据。

先来看一下执行结果：
SecondHibernate 执行结果

Hibernate: select this_.id as id0_, this_.name as name0_0_, this_.age as age0_0_ from user this_idid name/age1 caterpillar/303 bush/52 momor/26Hibernate: select this_.id as id0_, this_.name as name0_0_, this_.age as age0_0_ from user this_where this_.name=?id name/age1 caterpillar/30



Criteria 是对象导向式的查询方式，让不了解SQL 的开发人员也可以轻易进行各项查询，但Criteria 的API 目前还不是很完善，而Hibernate 鼓励的查询方式，是透过HQL（Hibernate Query Language）来进行，直接来看个实例：

SecondHibernateUsingHQ.java

package onlyfun.caterpillar;import org.hibernate.Query;import org.hibernate.Session;import org.hibernate.SessionFactory;import org.hibernate.cfg.Configuration;import java.util.Iterator;import java.util.List;public class SecondHibernateUsingHQ {public static void main(String[] args) {Configuration config = new Configuration().configure();SessionFactory sessionFactory = config.buildSessionFactory();Session session = sessionFactory.openSession();// 使用HQL 建立查询Query query = session.createQuery("from User");List users = query.list();Iterator iterator = users.iterator();System.out.println("id \t name/age");while (iterator.hasNext()) {User user = (User) iterator.next();System.out.println(user.getId() + " \t " + user.getName() + "/" +user.getAge());}System.out.println();// 使用HQL 建立查询query = session.createQuery("from User user where user.name like ?");// 设定查询参数query.setParameter(0, "caterpillar");users = query.list();iterator = users.iterator();System.out.println("id \t name/age");while (iterator.hasNext()) {User user = (User) iterator.next();System.out.println(user.getId() + " \t " + user.getName() + "/" +user.getAge());}session.close();sessionFactory.close();}}



执行结果：

SecondHibernateUsingHQ 执行结果

Hibernate: select this_.id as id0_, this_.name as name0_0_,   this_.age as age0_0_ from user this_idid name/age1 caterpillar/303 bush/52 momor/26Hibernate: select this_.id as id0_, this_.name as name0_0_,    this_.age as age0_0_ from user this_where this_.name=?id name/age1 caterpillar/30



透过Query 接口，您可以先设定查询参数，之后透过setXXX()等方法，将指定的参数值填入，而不用每次都撰写完整的HQL，Query 的setParameter()方法第一个参数是指定?出现的位置，从 0 开始，第二个参数则是设定查询条件。

#p#

二、简单的Hibernate 程序

这边以一个简单的单机程序来示范Hibernate的配置与功能，在这个例子中的一些操作，实际上会使用一些自动化工具来完成，而不一定亲自手动操作设定，这边完全手动的原因，在于让您可以知道Hibernate实际上会作那些动作，在进行范例之前，请先确定前一个主题中的相关jar档案都已经设定在CLASSPATH中。
　
我们先作数据库的准备工作，在MySQL中新增一个HibernateTest数据库，并建立USER表格：

CREATE TABLE USER (    user_id CHAR(32) NOT NULL PRIMARY KEY,    name VARCHAR(16) NOT NULL,    sex CHAR(1),    age INT);



我们先撰写一个纯Java对象，它纯綷表示一个数据集合，待会我们会将之映像至数据库的表格上，程序如下：

User.java

package onlyfun.caterpillar; public class User {    private String id;    private String name;    private char sex;    private int age;    public int getAge() {        return age;    }    public String getId() {        return id;    }    public String getName() {        return name;    }    public char getSex() {        return sex;    }    public void setAge(int i) {        age = i;    }    public void setId(String string) {        id = string;    }    public void setName(String string) {        name = string;    }    public void setSex(char c) {        sex = c;    }}



其中id是个特殊的属性，Hibernate会使用它来作为主键识别，我们可以定义主键产生的方式，这是在XML映像文件中完成，为了告诉Hibernate对象如何映像至数据库表格，我们撰写一个XML映射文件档名是User.hbm.xml，如下所示：

User.hbm.xml

<?xml version="1.0"?><!DOCTYPE hibernate-mapping    PUBLIC "-//Hibernate/Hibernate Mapping DTD//EN"    "http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd"><hibernate-mapping>    <class name="onlyfun.caterpillar.User" table="USER">        <id name="id" type="string" unsaved-value="null">            <column name="user_id" sql-type="char(32)" />            <generator class="uuid.hex"/>        </id>        <property name="name" type="string" not-null="true">            <column name="name" length="16" not-null="true"/>        </property>        <property name="sex" type="char"/>        <property name="age" type="int"/>    </class></hibernate-mapping>



这个XML文件定义了对象属性映像至数据库表格的关系，您可以很简单的了解对映的方法，像是User对象对应至USER表格，其中我们使用 uuid.hex来定义主键的产生算法，UUID算法使用IP地址、JVM的启动时间、系统时间和一个计数值来产生主键。除了使用uuid.hex之外，我们还可以使用其它的方式来产生主键，像是increment等，这可以在Hibernate参考手册中找到相关资料。

<property>卷标用于定义Java对象的属性，而当中的<column/>卷标用于定义与数据库的对应，如果您是手工建立Java对象与数据库表格，则在最简单的情况下，可以只定义<property name="sex"/>这样的方式，而由Hibernate自动判断Java对象属性与数据库表格名称对应关系，在< property/>与<column/>标签上的额外设定（像是not null、sql-type等），则可以用于自动产生Java对象与数据库表格的工具上。

接下来我们定义Hibernate配置文件，主要是进行SessionFactory配置，Hibernate可以使用XML或属性文件来进行配置，我 们这边先介绍如何使用XML配置，这也是Hibernate所建议的配置方式，我们的文件名是hibernate.cfg.xml，如下：

hibernate.cfg.xml

<?xml version='1.0' encoding='big5'?><!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 -->        <property name="connection.url">jdbc:mysql://localhost/HibernateTest</property>        <!-- 数据库使用者 -->        <property name="connection.username">caterpillar</property>        <!-- 数据库密码 -->        <property name="connection.password">123456</property>        <!-- 对象与数据库表格映像文件 -->        <mapping resource="User.hbm.xml"/>    </session-factory></hibernate-configuration>



接下来我们撰写一个测试的程序，这个程序将直接以Java程序设计人员熟悉的语法方式来操作对象，而实际上也直接完成对数据库的操作，程序将会将一笔数据存入表格之中：

HibernateTest.java

import onlyfun.caterpillar.*;import net.sf.hibernate.*;import net.sf.hibernate.cfg.*;public class HibernateTest {    public static void main(String[] args) throws HibernateException {        SessionFactory sessionFactory =           new Configuration().configure().buildSessionFactory();        User user = new User();        user.setName("caterpillar");        user.setSex('M');        user.setAge(28);        Session session = sessionFactory.openSession();        Transaction tx= session.beginTransaction();        session.save(user);        tx.commit();        session.close();        sessionFactory.close();                  System.out.println("新增资料OK!请先用MySQL观看结果！");    }}



#p#

Configuration代表了Java对象至数据库的映像设定，这个设定是从我们上面的XML而来，接下来我们从Configuration取得SessionFactory对象，并由它来开启一个Session，它代表对象与表格的一次会话操作，而 Transaction则表示一组会话操作，我们只需要直接操作User对象，并进行Session与Transaction的相关操作， Hibernate就会自动完成对数据库的操作。这边对程序先只作简单的介绍，之后再详加说明。

将所有的.java档案编译，并将两个XML档案放置在与HibernateTest相同的目录中，也就是档案位置如下：

/|--HibernateTest.class|--User.hbm.xml|--hibernate.cfg.xml    /onlyfun        /caterpillar        |--User.class



OK!现在您可以执行HibernateTest，程序将会出现以下的讯息：

log4j:WARN No appenders could be found for logger (net.sf.hibernate.cfg.Environment).log4j:WARN Please initialize the log4j system properly.Hibernate: insert into USER (name, sex, age, user_id) values (?, ?, ?, ?)



新增资料OK!请先用MySQL观看结果！

这边只先进行数据的存入，要观看数据存入的结果的话，请进入MySQL观看，以下是数据库存入的结果：

mysql> SELECT * FROM USER;+----------------------------------+-------------+------+------+| user_id                          | name        | sex  | age  |+----------------------------------+-------------+------+------+| 297e3dbdfea6023d00fea60241000001 | caterpillar | M    |   28 |+----------------------------------+-------------+------+------+1 rows in set (0.00 sec)