【转】Hibernate入门实例

1. 环境配置

1.1 hiberante环境配置

hibernate可实现面向对象的数据存储。hibernate的官网：http://hibernate.org/ 官网上选择hibernate ORM，可以下载最新的hibernate，还有配套的document教程 http://docs.jboss.org/hibernate/orm/4.3/manual/en-US/html_single/ 。下载到的hibernate文件夹中有document文档（hibernate\documentation\manual\en-US\html_single）。发现hibernate4.3.1的文件夹中的文档和网站上提供的答案不太一样，官网的文档更详细一些，还附有toturial的源代码。

打开eclipse->windows->preferences->java->build path->user libraries，点击new，新建一个library，可取名为hibernate。点击Add JARs，选择hibernate->lib->required中的所有jar文件，另外还需要加上数据库的connector文件。因为使用的是mysql，所以我这里用到的mysql-connector-java的jar文件。这个jar文件从哪里得到呢？安装mysql服务器产生的文件夹里面是没有jar文件的。我们需要另下载一个MySQL的JDBC jar包。可以从mysql的官网上下载：http://dev.mysql.com/downloads/connector/j/ 下载后得到一个msi文件，双击及可安装。安装后，默认会产生文件夹C:\Program Files (x86)\MySQL\MySQL Connector J ，这里就有一个mysql-connector-java-x.x.x-bin.jar包了。

1.2 mysql数据库配置

安装mysql服务器，设置root的密码为root。启动mysql服务器，新建数据库hibernate，并新建表student。

 # mysql -uroot -proot
 > create database hiberante;
 > use hibernate;
 > create table student(id int primary key, name varchar(20), age int);
 > quit;

2. 实例代码

新建一个java工程，假设取名为HibernateHelloWorld。在src下新那一个package，可取名为com.sun.hibernate.model

2.1 类代码

新建一个简单的类，放在com.sun.hibernate.model包下。内容如下：

 package com.sun.hibernate.model;

 public class Student {
     private int id;
     private String name;
     private int age;

     public int getId() {
         return id;
     }
     public void setId(int id) {
         this.id = id;
     }
     public String getName() {
         return name;
     }
     public void setName(String name) {
         this.name = name;
     }
     public int getAge() {
         return age;
     }
     public void setAge(int age) {
         this.age = age;
     }

 }

2.2 配置hibernate配置文件

hibernate\projec\etc中的hiberante.cfg.xml可以作为hibernate的配置文档，或者可使用hibernate\documentation\manual\en-US\html_single\index.html作为模板。在src文件夹下新建一个文件，并命名为hibernate.cfg.xml。（不可命名为其他文件名）最基础的配置文件可参考如下：

 <?xml version='1.0' encoding='utf-8'?>
 <!DOCTYPE hibernate-configuration PUBLIC
         "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
         "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">

 <hibernate-configuration>
     <session-factory>

     <!-- Database connection settings -->
     <property name="connection.driver_class">com.mysql.jdbc.Driver</property>
     <property name="connection.url">jdbc:mysql://localhost/hibernate</property>
     <property name="connection.username">root</property>
     <property name="connection.password">root</property>

     <!-- JDBC connection pool (use the built-in) -->
     <!-- <property name="connection.pool_size">1</property> -->

     <!-- SQL dialect -->
     <property name="dialect">org.hibernate.dialect.MySQLDialect</property>

     <!-- Echo all executed SQL to stdout -->
     <property name="show_sql">true</property>

     <!-- Enable Hibernate's automatic session context management -->
     <!--<property name="current_session_context_class">thread</property>-->

     <!-- Drop and re-create the database schema on startup -->
     <!-- <property name="hbm2ddl.auto">create</property> -->

     <!-- Disable the second-level cache -->
     <property name="cache.provider_class">org.hibernate.cache.NoCacheProvider</property>

     <mapping resource="com/sun/hibernate/model/Student.hbm.xml"/>

     </session-factory>
 </hibernate-configuration>

mapping resource处的值可根据包名和类名做修改。若类名为Student，则此处的类配置文件必为：Student.hbm.xml。

2.3 类mapping文件

新建一个文件，命名为Student.hbm.xml，放在com.sun.hibernate.model包下。内容如下：

 <?xml version="1.0" encoding="UTF-8"?>
 <!DOCTYPE hibernate-mapping PUBLIC
     "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
     "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">

 <hibernate-mapping package="com.sun.hibernate.model">
     <class name="Student">
         <id name="id"></id>
         <property name="name"></property>
         <property name="age"></property>
     </class>
 </hibernate-mapping>

Student.hbm.xml

注意文件开始处的配置，此处与hibernate.cfg.xml不一样。如果配置的与hiberante.cfg.xml一样，运行时会提示错误：“文档根元素 "hibernate-mapping" 必须匹配 DOCTYPE 根 "hibernate-configuration"  ”

2.4 StudentTest测试类

新增Student.java的junit测试类StudentTest.java，放在com.sun.hibernate.model包下代码如下：

 package com.sun.hibernate.model;

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

 public class StudentTest {

     public static void main(String[] args){
         Student s = new Student();
         s.setId(1);
         s.setName("s1");
         s.setAge(1);

         Configuration cfg = new Configuration();
         SessionFactory sf = cfg.configure().buildSessionFactory();

         Session session = sf.openSession();
         session.beginTransaction();
         session.save(s);
         session.getTransaction().commit();
         session.close();
         sf.close();
     }
 }

StudentTest.class

2.5. 运行结果

运行StudentTest.java这个类，虽然提示输入成功。去数据库查询后，可发现数据已存储到student数据表中。虽然myeclipse会提示buildSessionFactory()这个函数被deprecated，但实际上程序还是可以运行成功的。

3. 使用annotation

因为使用annotation比较方便，使用annotation就可以不用写XXX.hbm.xml文件了。

3.1 新建类

敲@后应该出现提示的，如果没有出现，在Window->Preferences->Java->Editor->Content Assist,在Auto activation triggers forJava中增加@即可。Teacher.java类与Student类内容基本相同，以@开头的内容为annotation。

 package com.sun.hibernate.model;

 import javax.persistence.Entity;
 import javax.persistence.Id;

 @Entity
 public class Teacher {

     @Id
     public int getId() {
         return id;
     }
     public void setId(int id) {
         this.id = id;
     }
     public String getName() {
         return name;
     }
     public void setName(String name) {
         this.name = name;
     }
     public int getAge() {
         return age;
     }
     public void setAge(int age) {
         this.age = age;
     }
     public int getTitle() {
         return title;
     }
     public void setTitle(String title) {
         this.title = title;
     }

     private int id;
     private String name;
     private int age;
     private String title;

 }

Teacher.class

3.2 更新hibernate.cfg.xml

在原hibernate.cfg.xml文件的mapping以下加粗内容。

 <mapping resource="com/sun/hibernate/model/Student.hbm.xml"/>
 <mapping class="com.sun.hiberante.model.Teacher"/>

4.3 新建TeacherTest.java类

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

 public class TeacherTest {

     public static void main(String[] args){
         Teacher t = new Teacher();
         t.setId(1);
         t.setName("t1");
         t.setAge(1);
         t.setTitle("middel");

         Configuration cfg = new AnnotationConfiguration();
         SessionFactory sf = cfg.configure().buildSessionFactory();
         Session session = sf.openSession();
         session.beginTransaction();
         session.save(t);
         session.getTransaction().commit();
         session.close();
         sf.close();
     }

 }

TeacherTest.class

3.3 运行

在数据库中新建teacher数据表：

 # mysql -uroot -proot
 > use hibernate;
 > create table teacher(id int primary key, name varchar(20), age int, title varchar(20));
 > quit;

运行TeacherTest.java这个类，虽然提示输入成功。去数据库查询后，可发现数据已存储到teacher数据表中。