Hibernate入门02 - 第一个Hibernate程序

[align=left]　这边以一个简单的单机程序来示范Hibernate的配置与功能，在这个例子中的一些操作，实际上会使用一些自动化工具来完成，而不一定亲自手动操作设定，这边完全手动的原因，在于让您可以知道Hibernate实际上会作那些动作，在进行范例之前，请先确定前一个主题中的相关jar档案都已经设定在 CLASSPATH中。
　我们先作数据库的准备工作，在MySQL中新增一个HibernateTest数据库，并建立USER表格： [/align]
[align=left]CREATE TABLE USER ([/align]
[align=left] user_id CHAR(32) NOT NULL PRIMARY KEY,[/align]
[align=left] name VARCHAR(16) NOT NULL,[/align]
[align=left] sex CHAR(1),[/align]
[align=left] age INT[/align]
[align=left]);[/align]
[align=left]
　我们先撰写一个纯Java对象，它纯綷表示一个数据集合，待会我们会将之映像至数据库的表格上，程序如下： [/align]
[align=left]User.java[/align]
[align=left]package onlyfun.caterpillar;[/align]
[align=left] [/align]
[align=left]public class User {[/align]
[align=left] private String id;[/align]
[align=left] private String name;[/align]
[align=left] private char sex;[/align]
[align=left] private int age;[/align]
[align=left] [/align]
[align=left] public int getAge() {[/align]
[align=left] return age;[/align]
[align=left] }[/align]
[align=left] [/align]
[align=left] public String getId() {[/align]
[align=left] return id;[/align]
[align=left] }[/align]
[align=left] [/align]
[align=left] public String getName() {[/align]
[align=left] return name;[/align]
[align=left] }[/align]
[align=left] [/align]
[align=left] public char getSex() {[/align]
[align=left] return sex;[/align]
[align=left] }[/align]
[align=left] [/align]
[align=left] public void setAge(int i) {[/align]
[align=left] age = i;[/align]
[align=left] }[/align]
[align=left] [/align]
[align=left] public void setId(String string) {[/align]
[align=left] id = string;[/align]
[align=left] }[/align]
[align=left] [/align]
[align=left] public void setName(String string) {[/align]
[align=left] name = string;[/align]
[align=left] }[/align]
[align=left] [/align]
[align=left] public void setSex(char c) {[/align]
[align=left] sex = c;[/align]
[align=left] }[/align]
[align=left]}[/align]
[align=left]
　其中id是个特殊的属性，Hibernate会使用它来作为主键识别，我们可以定义主键产生的方式，这是在XML映像文件中完成，为了告诉Hibernate对象如何映像至数据库表格，我们撰写一个XML映射文件档名是User.hbm.xml，如下所示： [/align]
[align=left]User.hbm.xml[/align]
[align=left]<?xml version="1.0"?>[/align]
[align=left]<!DOCTYPE hibernate-mapping[/align]
[align=left] PUBLIC "-//Hibernate/Hibernate Mapping DTD//EN"[/align]
[align=left] "http://hibernate.sourceforge.net/hibernate-mapping-2.0.dtd">[/align]
[align=left] [/align]
[align=left]<hibernate-mapping>[/align]
[align=left] [/align]
[align=left] <class name="onlyfun.caterpillar.User" table="USER">[/align]
[align=left] [/align]
[align=left] <id name="id" type="string" unsaved-value="null">[/align]
[align=left] <column name="user_id" sql-type="char(32)" />[/align]
[align=left] <generator class="uuid.hex"/>[/align]
[align=left] </id>[/align]
[align=left] [/align]
[align=left] <property name="name" type="string" not-null="true">[/align]
[align=left] <column name="name" length="16" not-null="true"/>[/align]
[align=left] </property>[/align]
[align=left] [/align]
[align=left] <property name="sex" type="char"/>[/align]
[align=left] [/align]
[align=left] <property name="age" type="int"/>[/align]
[align=left] [/align]
[align=left] </class>[/align]
[align=left] [/align]
[align=left]</hibernate-mapping>[/align]
[align=left]
　这个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，如下： [/align]
[align=left]hibernate.cfg.xml[/align]
[align=left]<?xml version='1.0' encoding='big5'?>[/align]
[align=left]<!DOCTYPE hibernate-configuration[/align]
[align=left] PUBLIC "-//Hibernate/Hibernate Configuration DTD//EN"[/align]
[align=left] "http://hibernate.sourceforge.net/hibernate-configuration-2.0.dtd">[/align]
[align=left] [/align]
[align=left]<hibernate-configuration>[/align]
[align=left] [/align]
[align=left] <session-factory>[/align]
[align=left] [/align]
[align=left] <!-- 显示实际操作数据库时的SQL -->[/align]
[align=left] <property name="show_sql">true</property>[/align]
[align=left] <!-- SQL方言，这边设定的是MySQL -->[/align]
[align=left] <property name="dialect">net.sf.hibernate.dialect.MySQLDialect</property>[/align]
[align=left] <!-- JDBC驱动程序 -->[/align]
[align=left] <property name="connection.driver_class">com.mysql.jdbc.Driver</property>[/align]
[align=left] <!-- JDBC URL -->[/align]
[align=left] <property name="connection.url">jdbc:mysql://localhost/HibernateTest</property>[/align]
[align=left] <!-- 数据库使用者 -->[/align]
[align=left] <property name="connection.username">caterpillar</property>[/align]
[align=left] <!-- 数据库密码 -->[/align]
[align=left] <property name="connection.password">123456</property>[/align]
[align=left] [/align]
[align=left] <!-- 对象与数据库表格映像文件 -->[/align]
[align=left] <mapping resource="User.hbm.xml"/>[/align]
[align=left] [/align]
[align=left] </session-factory>[/align]
[align=left] [/align]
[align=left]</hibernate-configuration>[/align]
[align=left]
　接下来我们撰写一个测试的程序，这个程序将直接以Java程序设计人员熟悉的语法方式来操作对象，而实际上也直接完成对数据库的操作，程序将会将一笔数据存入表格之中： [/align]
[align=left]HibernateTest.java[/align]
[align=left]import onlyfun.caterpillar.*;[/align]
[align=left]import net.sf.hibernate.*;[/align]
[align=left]import net.sf.hibernate.cfg.*;[/align]
[align=left] [/align]
[align=left]public class HibernateTest {[/align]
[align=left] public static void main(String[] args) throws HibernateException {[/align]
[align=left] SessionFactory sessionFactory = new Configuration().configure().buildSessionFactory();[/align]
[align=left] [/align]
[align=left] User user = new User();[/align]
[align=left] user.setName("caterpillar");[/align]
[align=left] user.setSex('M');[/align]
[align=left] user.setAge(28);[/align]
[align=left] [/align]
[align=left] Session session = sessionFactory.openSession();[/align]
[align=left] Transaction tx= session.beginTransaction();[/align]
[align=left] session.save(user);[/align]
[align=left] tx.commit();[/align]
[align=left] session.close();[/align]
[align=left] sessionFactory.close();[/align]
[align=left] [/align]
[align=left] System.out.println("新增资料OK!请先用MySQL观看结果！");[/align]
[align=left] }[/align]
[align=left]}[/align]
[align=left]
　Configuration代表了Java对象至数据库的映像设定，这个设定是从我们上面的XML而来，接下来我们从 Configuration取得SessionFactory对象，并由它来开启一个Session，它代表对象与表格的一次会话操作，而 Transaction则表示一组会话操作，我们只需要直接操作User对象，并进行Session与Transaction的相关操作， Hibernate就会自动完成对数据库的操作。这边对程序先只作简单的介绍，之后再详加说明。
　将所有的.java档案编译，并将两个XML档案放置在与HibernateTest相同的目录中，也就是档案位置如下： [/align]
[align=left]/[/align]
[align=left]|--HibernateTest.class[/align]
[align=left]|--User.hbm.xml[/align]
[align=left]|--hibernate.cfg.xml[/align]
[align=left] /onlyfun[/align]
[align=left] /caterpillar[/align]
[align=left] |--User.class[/align]
[align=left]
　OK!现在您可以执行HibernateTest，程序将会出现以下的讯息： [/align]
[align=left]log4j:WARN No appenders could be found for logger (net.sf.hibernate.cfg.Environment).[/align]
[align=left]log4j:WARN Please initialize the log4j system properly.[/align]
[align=left]Hibernate: insert into USER (name, sex, age, user_id) values (?, ?, ?, ?)[/align]
[align=left]新增资料OK!请先用MySQL观看结果！[/align]
[align=left]
　这边只先进行数据的存入，要观看数据存入的结果的话，请进入MySQL观看，以下是数据库存入的结果： [/align]
[align=left]mysql> SELECT * FROM USER;[/align]
[align=left]+----------------------------------+-------------+------+------+[/align]
[align=left]| user_id | name | sex | age |[/align]
[align=left]+----------------------------------+-------------+------+------+[/align]
[align=left]| 297e3dbdfea6023d00fea60241000001 | caterpillar | M | 28 |[/align]
[align=left]+----------------------------------+-------------+------+------+[/align]
[align=left]1 rows in set (0.00 sec) [/align]