例子

让我们看一个独立应用程序利用 Hibernate 提供 Java 持久性的例子。我们将通过不同的步骤使用 Hibernate 技术创建 Java 应用程序。

创建 POJO 类

创建应用程序的第一步就是建立 Java 的 POJO 类或者其它类，这取决于即将要存放在数据库中的应用程序。我们可以考虑一下让我们的 Employee 类使用 getXXX 和 setXXX 方法从而使它们变成符合 JavaBeans 的类。

POJO (Plain Old Java Object) 是 Java 的一个对象，这种对象不会扩展或者执行一些特殊的类并且它的接口都是分别在 EJB 框架的要求下的。所有正常的 Java 对象都是 POJO。

当你设计一个存放在 Hibernate 中的类时，最重要的是提供支持 JavaBeans 的代码和在 Employee 类中像 id 属性一样可以当做索引的属性。 

  1. public class Employee {
  2.    private int id;
  3.    private String firstName; 
  4.    private String lastName;   
  5.    private int salary;  
  7.    public Employee() {}
  8.    public Employee(String fname, String lname, int salary) {
  9.       this.firstName = fname;
  10.       this.lastName = lname;
  11.       this.salary = salary;
  12.    }
  13.    public int getId() {
  14.       return id;
  15.    }
  16.    public void setId( int id ) {
  17.       this.id = id;
  18.    }
  19.    public String getFirstName() {
  20.       return firstName;
  21.    }
  22.    public void setFirstName( String first_name ) {
  23.       this.firstName = first_name;
  24.    }
  25.    public String getLastName() {
  26.       return lastName;
  27.    }
  28.    public void setLastName( String last_name ) {
  29.       this.lastName = last_name;
  30.    }
  31.    public int getSalary() {
  32.       return salary;
  33.    }
  34.    public void setSalary( int salary ) {
  35.       this.salary = salary;
  36.    }
  37. }

创建数据库表

第二步就是在你的数据库中创建表格。每一个你所愿意提供长期留存的对象都会有一个对应的表。上述的对象需要在下列的 RDBMS 表中存储和被检索到： 

  1. create table EMPLOYEE (
  2.    id INT NOT NULL auto_increment,
  3.    first_name VARCHAR(20) default NULL,
  4.    last_name  VARCHAR(20) default NULL,
  5.    salary     INT  default NULL,
  6.    PRIMARY KEY (id)
  7. );

创建映射配置文件

这一步是创建一个映射文件从而指导 Hibernate 如何对数据库的表映射定义的类。 

  1. <?xml version="1.0" encoding="utf-8"?>
  2. <!DOCTYPE hibernate-mapping PUBLIC 
  3.  "-//Hibernate/Hibernate Mapping DTD//EN"
  4.  "http://www.hibernate.org/dtd/hibernate-mapping-3.0.dtd"> 
  6. <hibernate-mapping>
  7.    <class name="Employee" table="EMPLOYEE">
  8.       <meta attribute="class-description">
  9.          This class contains the employee detail. 
  10.       </meta>
  11.       <id name="id" type="int" column="id">
  12.          <generator class="native"/>
  13.       </id>
  14.       <property name="firstName" column="first_name" type="string"/>
  15.       <property name="lastName" column="last_name" type="string"/>
  16.       <property name="salary" column="salary" type="int"/>
  17.    </class>
  18. </hibernate-mapping>

你需要将映射文档以<classname>.hbm.xml的格式保存在一个文件中。我们将映射文档保存在 Employee.hbm.xml文件中。下面让我们看看映射文档相关的一些小细节：

  • 映射文档是一个 XML 格式的文档，它拥有<hibernate-mapping>作为根元素，这个元素包含了所有的 <class>元素。
  • <class> 元素被用来定义从 Java 类到数据库表的特定的映射。Java 类的名称是特定的，它使用的是类元素的 name 属性，数据库表的名称也是特定的，它使用的是 table 属性。
  • <meta> 元素是一个可选元素，它可以用来创建类的描述。
  • <id> 元素向数据库的主要关键字表映射类中的特定的 ID 属性。id 元素的 name 属性涉及到了类中的属性同时 column 属性涉及到了数据库表中的列。type 属性掌握了 hibernate 的映射类型，这种映射类型将会从 Java 转到 SQL 数据类型。
  • id 元素中的 <generator>元素是用来自动产生主要关键字的值的。将 generator 元素的 class 属性设置成 native 从而使 Hibernate 运用 identity, sequence 或者 hilo 算法依靠基础数据库的性能来创建主要关键字。
  • <property> 元素是用来映射一个 Java 类的属性到数据库的表中的列中。这个元素的 name 属性涉及到类中的属性，column 属性涉及到数据表中的列。type 属性控制 Hibernate 的映射类型，这种映射类型将会从 Java 转到 SQL 数据类型。

映射文档中还有许多其它的属性和元素，在探讨其它的 Hibernate 相关的话题时我将会详细进行讲解。

创建应用程序类

最后，我们将要使用 main() 方法创建应用程序类来运行应用程序。我们将用这个程序来保存一些 Employee 的记录，然后我们将在这些记录上应用 CRUD 操作。 

  1. import java.util.List; 
  2. import java.util.Date;
  3. import java.util.Iterator; 
  5. import org.hibernate.HibernateException; 
  6. import org.hibernate.Session; 
  7. import org.hibernate.Transaction;
  8. import org.hibernate.SessionFactory;
  9. import org.hibernate.cfg.Configuration;
  11. public class ManageEmployee {
  12.    private static SessionFactory factory; 
  13.    public static void main(String[] args) {
  14.       try{
  15.          factory = new Configuration().configure().buildSessionFactory();
  16.       }catch (Throwable ex) { 
  17.          System.err.println("Failed to create sessionFactory object." + ex);
  18.          throw new ExceptionInInitializerError(ex); 
  19.       }
  20.       ManageEmployee ME = new ManageEmployee();
  22.       /* Add few employee records in database */
  23.       Integer empID1 = ME.addEmployee("Zara", "Ali", 1000);
  24.       Integer empID2 = ME.addEmployee("Daisy", "Das", 5000);
  25.       Integer empID3 = ME.addEmployee("John", "Paul", 10000);
  27.       /* List down all the employees */
  28.       ME.listEmployees();
  30.       /* Update employee's records */
  31.       ME.updateEmployee(empID1, 5000);
  33.       /* Delete an employee from the database */
  34.       ME.deleteEmployee(empID2);
  36.       /* List down new list of the employees */
  37.       ME.listEmployees();
  38.    }
  39.    /* Method to CREATE an employee in the database */
  40.    public Integer addEmployee(String fname, String lname, int salary){
  41.       Session session = factory.openSession();
  42.       Transaction tx = null;
  43.       Integer employeeID = null;
  44.       try{
  45.          tx = session.beginTransaction();
  46.          Employee employee = new Employee(fname, lname, salary);
  47.          employeeID = (Integer) session.save(employee); 
  48.          tx.commit();
  49.       }catch (HibernateException e) {
  50.          if (tx!=null) tx.rollback();
  51.          e.printStackTrace(); 
  52.       }finally {
  53.          session.close(); 
  54.       }
  55.       return employeeID;
  56.    }
  57.    /* Method to  READ all the employees */
  58.    public void listEmployees( ){
  59.       Session session = factory.openSession();
  60.       Transaction tx = null;
  61.       try{
  62.          tx = session.beginTransaction();
  63.          List employees = session.createQuery("FROM Employee").list(); 
  64.          for (Iterator iterator = 
  65.                            employees.iterator(); iterator.hasNext();){
  66.             Employee employee = (Employee) iterator.next(); 
  67.             System.out.print("First Name: " + employee.getFirstName()); 
  68.             System.out.print("  Last Name: " + employee.getLastName()); 
  69.             System.out.println("  Salary: " + employee.getSalary()); 
  70.          }
  71.          tx.commit();
  72.       }catch (HibernateException e) {
  73.          if (tx!=null) tx.rollback();
  74.          e.printStackTrace(); 
  75.       }finally {
  76.          session.close(); 
  77.       }
  78.    }
  79.    /* Method to UPDATE salary for an employee */
  80.    public void updateEmployee(Integer EmployeeID, int salary ){
  81.       Session session = factory.openSession();
  82.       Transaction tx = null;
  83.       try{
  84.          tx = session.beginTransaction();
  85.          Employee employee = 
  86.                     (Employee)session.get(Employee.class, EmployeeID); 
  87.          employee.setSalary( salary );
  88.          session.update(employee); 
  89.          tx.commit();
  90.       }catch (HibernateException e) {
  91.          if (tx!=null) tx.rollback();
  92.          e.printStackTrace(); 
  93.       }finally {
  94.          session.close(); 
  95.       }
  96.    }
  97.    /* Method to DELETE an employee from the records */
  98.    public void deleteEmployee(Integer EmployeeID){
  99.       Session session = factory.openSession();
  100.       Transaction tx = null;
  101.       try{
  102.          tx = session.beginTransaction();
  103.          Employee employee = 
  104.                    (Employee)session.get(Employee.class, EmployeeID); 
  105.          session.delete(employee); 
  106.          tx.commit();
  107.       }catch (HibernateException e) {
  108.          if (tx!=null) tx.rollback();
  109.          e.printStackTrace(); 
  110.       }finally {
  111.          session.close(); 
  112.       }
  113.    }
  114. }

编译和执行

下面是编译和运行上述提到的应用程序的步骤。在编译和执行应用程序之前确保你已经设置好了 PATH 和 CLASSPATH。

  • 创建设置章节中所讲的 hibernate.cfg.xml 配置文件。
  • 创建上文所述的 Employee.hbm.xml 映射文件。
  • 创建上文所述的 Employee.java 源文件并且进行编译。
  • 创建上文所述的 ManageEmployee.java 源文件并且进行编译。
  • 执行二进制的 ManageEmployee 来运行程序。

你将会得到如下结果，记录将会在 EMPLOYEE 表中建立。 

  1. $java ManageEmployee
  2. .......VARIOUS LOG MESSAGES WILL DISPLAY HERE........
  4. First Name: Zara  Last Name: Ali  Salary: 1000
  5. First Name: Daisy  Last Name: Das  Salary: 5000
  6. First Name: John  Last Name: Paul  Salary: 10000
  7. First Name: Zara  Last Name: Ali  Salary: 5000
  8. First Name: John  Last Name: Paul  Salary: 10000

如果你检查你的 EMPLOYEE 表，它将会有如下记录： 

  1. mysql> select * from EMPLOYEE;
  2. +----+------------+-----------+--------+
  3. | id | first_name | last_name | salary |
  4. +----+------------+-----------+--------+
  5. | 29 | Zara       | Ali       |   5000 |
  6. | 31 | John       | Paul      |  10000 |
  7. +----+------------+-----------+--------+
  8. 2 rows in set (0.00 sec
  10. mysql>