Hibernate入门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)