入门 02 - 第一个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观看结果!");
}
}
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)