Hibernate3 学习(一)

一．基础入门
从一个最基本的对象关系映像自动化程序，了解 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 型态的标准对应型态（因为语言所提供的类型并不一定与数据库的类型对应），
这之后会再说明。
<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 将用于建立 Session
SessionFactory sessionFactory = config.buildSessionFactory();
//将持久化的物件
User user = new User();
user.setName("caterpillar");
user.setAge(new Integer(30));
//开启Session，相当于开启JDBC 的Connection
Session 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();
}
}
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_id
id name/age
1 caterpillar/30
3 bush/5
2 momor/26
Hibernate: select this_.id as id0_, this_.name as name0_0_, this_.age as age0_0_ from user this_
where this_.name=?
id name/age
1 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_id
id name/age
1 caterpillar/30
3 bush/5
2 momor/26
Hibernate: select this_.id as id0_, this_.name as name0_0_, this_.age as age0_0_ from user this_
where this_.name=?
id name/age
1 caterpillar/30
透过Query 接口，您可以先设定查询参数，之后透过setXXX()等方法，将指定的参数值
填入，而不用每次都撰写完整的HQL，Query 的setParameter()方法第一个参数是指定 ?
出现的位置，从 0 开始，第二个参数则是设定查询条件。