Hibernate入门之第一个Hibernate程序(2)

这边以一个简单的单机程序来示范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)