第一个Hibernate with Annotation程式

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

接下来至 Hibernate 官方网站 取得Hibernate 3.2、Hibernate Annotations 3.2。

您必须安装JDK 5.0才可以使用Hibernate Annotations的功能。

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

解开Hibernate Annotations 3.2的zip档案后，您需要hibernate-annotations.jar、ejb3-persistence.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：

<?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">root</property>
<!-- 数据库密码 -->
<property name="connection.password">123456</property>

<!-- 以下设置对象与数据库表格映像类别 -->
<mapping class="onlyfun.caterpillar.User"/>
</session-factory>
</hibernate-configuration>

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

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

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

package onlyfun.caterpillar;

import javax.persistence.*;

@Entity
@Table(name="user") // 非必要，在表格名称与类别名称不同时使用
public class User {
@Id
@GeneratedValue(strategy=GenerationType.AUTO)
private Integer id;

@Column(name="name") // 非必要，在字段名称与属性名称不同时使用
private String name;

@Column(name="age")
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会使用它来作为主键识别，您可以定义主键产生的方式，这边设定为自动产生主键，可以看到，实体标识，主键生成，以及相关映像，都可以使用Annotation来完成。

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

import org.hibernate.SessionFactory;
import org.hibernate.Session;
import org.hibernate.Transaction;
import org.hibernate.cfg.AnnotationConfiguration;
import org.hibernate.cfg.Configuration;

public class HibernateAnnotationDemo {

public static void main(String[] args) {
// 需要AnnotationConfiguration读取Annotation讯息
Configuration config = new AnnotationConfiguration().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表示一组会话操作
Transaction tx= session.beginTransaction();
// 将对象映像至数据库表格中储存
session.save(user);
tx.commit();
session.close();
sessionFactory.close();

System.out.println("新增资料OK!请先用MySQL观看结果！");
}
}

注意，使用Annotation时，需要的是AnnotationConfiguration类别。

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


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

Hibernate: insert into user (name, age) values (?, ?)
新增资料OK!请先用MySQL观看结果！

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

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