【轉】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。

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

2. 實例代碼

新建一個java工程，假設取名爲HibernateHelloWorld。在src下新那一個package，可取名爲com.sun.hibernate.model

2.1 類代碼

新建一個簡單的類，放在com.sun.hibernate.model包下。內容以下：

 1 package com.sun.hibernate.model;
 2  
 3 public class Student {
 4     private int id;
 5     private String name;
 6     private int age;
 7  
 8     public int getId() {
 9         return id;
10     }
11     public void setId(int id) {
12         this.id = id;
13     }
14     public String getName() {
15         return name;
16     }
17     public void setName(String name) {
18         this.name = name;
19     }
20     public int getAge() {
21         return age;
22     }
23     public void setAge(int age) {
24         this.age = age;
25     }
26  
27 }

2.2 配置hibernate配置文件

hibernate\projec\etc中的hiberante.cfg.xml能夠做爲hibernate的配置文檔，或者可以使用hibernate\documentation\manual\en-US\html_single\index.html做爲模板。在src文件夾下新建一個文件，並命名爲hibernate.cfg.xml。（不可命名爲其餘文件名）最基礎的配置文件可參考以下：

 1 <?xml version='1.0' encoding='utf-8'?>
 2 <!DOCTYPE hibernate-configuration PUBLIC
 3         "-//Hibernate/Hibernate Configuration DTD 3.0//EN"
 4         "http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">
 5      
 6 <hibernate-configuration>
 7     <session-factory>
 8      
 9     <!-- Database connection settings -->
10     <property name="connection.driver_class">com.mysql.jdbc.Driver</property>
11     <property name="connection.url">jdbc:mysql://localhost/hibernate</property>
12     <property name="connection.username">root</property>
13     <property name="connection.password">root</property>
14          
15     <!-- JDBC connection pool (use the built-in) -->
16     <!-- <property name="connection.pool_size">1</property> -->
17          
18     <!-- SQL dialect -->
19     <property name="dialect">org.hibernate.dialect.MySQLDialect</property>
20          
21     <!-- Echo all executed SQL to stdout -->
22     <property name="show_sql">true</property>
23          
24     <!-- Enable Hibernate's automatic session context management -->
25     <!--<property name="current_session_context_class">thread</property>-->
26          
27     <!-- Drop and re-create the database schema on startup -->
28     <!-- <property name="hbm2ddl.auto">create</property> -->
29          
30     <!-- Disable the second-level cache -->
31     <property name="cache.provider_class">org.hibernate.cache.NoCacheProvider</property>
32      
33     <mapping resource="com/sun/hibernate/model/Student.hbm.xml"/>
34          
35     </session-factory>
36 </hibernate-configuration>

mapping resource處的值可根據包名和類名作修改。若類名爲Student，則此處的類配置文件必爲：Student.hbm.xml。

2.3 類mapping文件

新建一個文件，命名爲Student.hbm.xml，放在com.sun.hibernate.model包下。內容以下：

 1 <?xml version="1.0" encoding="UTF-8"?>
 2 <!DOCTYPE hibernate-mapping PUBLIC
 3     "-//Hibernate/Hibernate Mapping DTD 3.0//EN"
 4     "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd">
 5  
 6 <hibernate-mapping package="com.sun.hibernate.model">
 7     <class name="Student">
 8         <id name="id"></id>
 9         <property name="name"></property>
10         <property name="age"></property>
11     </class>
12 </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包下代碼以下：

 1 package com.sun.hibernate.model;
 2  
 3 import org.hibernate.Session;
 4 import org.hibernate.SessionFactory;
 5 import org.hibernate.cfg.Configuration;
 6  
 7 public class StudentTest {
 8  
 9     public static void main(String[] args){
10         Student s = new Student();
11         s.setId(1);
12         s.setName("s1");
13         s.setAge(1);
14          
15         Configuration cfg = new Configuration();
16         SessionFactory sf = cfg.configure().buildSessionFactory();
17          
18         Session session = sf.openSession();
19         session.beginTransaction();
20         session.save(s);
21         session.getTransaction().commit();
22         session.close();
23         sf.close();    
24     }
25 }

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。

 1 package com.sun.hibernate.model;
 2  
 3 import javax.persistence.Entity;
 4 import javax.persistence.Id;
 5  
 6 @Entity
 7 public class Teacher {
 8      
 9     @Id
10     public int getId() {
11         return id;
12     }
13     public void setId(int id) {
14         this.id = id;
15     }
16     public String getName() {
17         return name;
18     }
19     public void setName(String name) {
20         this.name = name;
21     }
22     public int getAge() {
23         return age;
24     }
25     public void setAge(int age) {
26         this.age = age;
27     }
28     public int getTitle() {
29         return title;
30     }
31     public void setTitle(String title) {
32         this.title = title;
33     }
34      
35     private int id;
36     private String name;
37     private int age;
38     private String title;
39      
40 }

Teacher.class

3.2 更新hibernate.cfg.xml

在原hibernate.cfg.xml文件的mapping如下加粗內容。

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

4.3 新建TeacherTest.java類

 1 import org.hibernate.SessionFactory;
 2 import org.hibernate.cfg.AnnotationConfiguration;
 3 import org.hibernate.cfg.Configuration;
 4  
 5 public class TeacherTest {
 6  
 7     public static void main(String[] args){
 8         Teacher t = new Teacher();
 9         t.setId(1);
10         t.setName("t1");
11         t.setAge(1);
12         t.setTitle("middel");
13          
14         Configuration cfg = new AnnotationConfiguration();
15         SessionFactory sf = cfg.configure().buildSessionFactory();
16         Session session = sf.openSession();
17         session.beginTransaction();
18         session.save(t);
19         session.getTransaction().commit();
20         session.close();
21         sf.close();
22     }
23  
24 }

TeacherTest.class

3.3 運行

在數據庫中新建teacher數據表：

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

運行TeacherTest.java這個類，雖然提示輸入成功。去數據庫查詢後，可發現數據已存儲到teacher數據表中。