hibernate 注釋

我們已經(jīng)學(xué)會(huì)了 hibernate 如何使用 xml 映射文件來(lái)完成從 pojo 到數(shù)據(jù)庫(kù)表的數(shù)據(jù)轉(zhuǎn)換的，反之亦然。

hibernate 注釋是無(wú)需使用 xml 文件來(lái)定義映射的最新方法。

你可以額外使用注釋或直接代替 xml 映射元數(shù)據(jù)。

hibernate 注釋是一種強(qiáng)大的來(lái)給對(duì)象和關(guān)系映射表提供元數(shù)據(jù)的方法。所有的元數(shù)據(jù)被添加到 pojo java 文件代碼中，這有利于用戶在開發(fā)時(shí)更好的理解表的結(jié)構(gòu)和 pojo。

如果你想讓你的應(yīng)用程序移植到其它 ejb 3 的 orm 應(yīng)用程序中,您必須使用注釋來(lái)表示映射信息，但是如果想要得到更大的靈活性,那么你應(yīng)該使用基于 xml 的映射。

hibernate 注釋的環(huán)境設(shè)置

首先你必須確定你使用的是 jdk 5.0，否則你需要升級(jí)你的 jdk 至 jdk 5.0，來(lái)使你的主機(jī)能夠支持注釋。

其次，你需要安裝 hibernate 3.x 注釋包，可以從 sourceforge 行下載：（下載 hibernate 注釋:https://sourceforge.net/projects/hibernate/files/hibernate-annotations/） 并且從 hibernate 注釋發(fā)布中拷貝 hibernate-annotations.jar, lib/hibernate-comons-annotations.jar 和 lib/ejb3-persistence.jar 到你的 classpath。

注釋類示例

正如我上面所提到的，所有的元數(shù)據(jù)被添加到 pojo java 文件代碼中，這有利于用戶在開發(fā)時(shí)更好的理解表的結(jié)構(gòu)和 pojo。

下面我們將使用 employee 表來(lái)存儲(chǔ)對(duì)象:

create table employee (
   id int not null auto_increment,
   first_name varchar(20) default null,
   last_name  varchar(20) default null,
   salary     int  default null,
   primary key (id)
);

以下是用帶有注釋的 employee 類來(lái)映射使用定義好的 employee 表的對(duì)象:

import javax.persistence.*;

@entity
@table(name = "employee")
public class employee {
   @id @generatedvalue
   @column(name = "id")
   private int id;

   @column(name = "first_name")
   private string firstname;

   @column(name = "last_name")
   private string lastname;

   @column(name = "salary")
   private int salary;  

   public employee() {}
   public int getid() {
      return id;
   }
   public void setid( int id ) {
      this.id = id;
   }
   public string getfirstname() {
      return firstname;
   }
   public void setfirstname( string first_name ) {
      this.firstname = first_name;
   }
   public string getlastname() {
      return lastname;
   }
   public void setlastname( string last_name ) {
      this.lastname = last_name;
   }
   public int getsalary() {
      return salary;
   }
   public void setsalary( int salary ) {
      this.salary = salary;
   }
}

hibernate 檢測(cè)到 @id 注釋字段并且認(rèn)定它應(yīng)該在運(yùn)行時(shí)通過(guò)字段直接訪問(wèn)一個(gè)對(duì)象上的屬性。如果你將 @id 注釋放在 getid() 方法中，你可以通過(guò)默認(rèn)的 getter 和 setter 方法來(lái)訪問(wèn)屬性。因此，所有其它注釋也放在字段或是 getter 方法中，決定于選擇的策略。下一節(jié)將解釋上面的類中使用的注釋。

@entity 注釋

ejb 3 標(biāo)準(zhǔn)的注釋包含在 javax.persistence 包，所以我們第一步需要導(dǎo)入這個(gè)包。第二步我們對(duì) employee 類使用 @entity 注釋，標(biāo)志著這個(gè)類為一個(gè)實(shí)體 bean，所以它必須含有一個(gè)沒(méi)有參數(shù)的構(gòu)造函數(shù)并且在可保護(hù)范圍是可見(jiàn)的。

@table 注釋

@table 注釋允許您明確表的詳細(xì)信息保證實(shí)體在數(shù)據(jù)庫(kù)中持續(xù)存在。

@table 注釋提供了四個(gè)屬性，允許您覆蓋的表的名稱，目錄及其模式,在表中可以對(duì)列制定獨(dú)特的約束?，F(xiàn)在我們使用的是表名為 employee。

@id 和 @generatedvalue 注釋

每一個(gè)實(shí)體 bean 都有一個(gè)主鍵，你在類中可以用 @id 來(lái)進(jìn)行注釋。主鍵可以是一個(gè)字段或者是多個(gè)字段的組合，這取決于你的表的結(jié)構(gòu)。

默認(rèn)情況下，@id 注釋將自動(dòng)確定最合適的主鍵生成策略，但是你可以通過(guò)使用 @generatedvalue 注釋來(lái)覆蓋掉它。strategy 和 generator 這兩個(gè)參數(shù)我不打算在這里討論，所以我們只使用默認(rèn)鍵生成策略。讓 hibernate 確定使用哪些生成器類型來(lái)使代碼移植于不同的數(shù)據(jù)庫(kù)之間。

@column annotation

@column 注釋用于指定某一列與某一個(gè)字段或是屬性映射的細(xì)節(jié)信息。您可以使用下列注釋的最常用的屬性:

• name 屬性允許顯式地指定列的名稱。
• length 屬性為用于映射一個(gè)值，特別為一個(gè)字符串值的列的大小。
• nullable 屬性允許當(dāng)生成模式時(shí)，一個(gè)列可以被標(biāo)記為非空。
• unique 屬性允許列中只能含有唯一的內(nèi)容

創(chuàng)建應(yīng)用類

最后,我們將創(chuàng)建應(yīng)用程序類，并使用 main() 方法來(lái)運(yùn)行應(yīng)用程序。我們將使用此應(yīng)用程序來(lái)保存一些員工的記錄,然后我們對(duì)這些記錄進(jìn)行 crud 操作。

import java.util.list;
import java.util.date;
import java.util.iterator;

import org.hibernate.hibernateexception;
import org.hibernate.session;
import org.hibernate.transaction;
import org.hibernate.cfg.annotationconfiguration;
import org.hibernate.sessionfactory;
import org.hibernate.cfg.configuration;

public class manageemployee {
   private static sessionfactory factory;
   public static void main(string[] args) {
      try{
         factory = new annotationconfiguration().
                   configure().
                   //addpackage("com.xyz") //add package if used.
                   addannotatedclass(employee.class).
                   buildsessionfactory();
      }catch (throwable ex) {
         system.err.println("failed to create sessionfactory object." + ex);
         throw new exceptionininitializererror(ex);
      }
      manageemployee me = new manageemployee();

      /* add few employee records in database */
      integer empid1 = me.addemployee("zara", "ali", 1000);
      integer empid2 = me.addemployee("daisy", "das", 5000);
      integer empid3 = me.addemployee("john", "paul", 10000);

      /* list down all the employees */
      me.listemployees();

      /* update employee's records */
      me.updateemployee(empid1, 5000);

      /* delete an employee from the database */
      me.deleteemployee(empid2);

      /* list down new list of the employees */
      me.listemployees();
   }
   /* method to create an employee in the database */
   public integer addemployee(string fname, string lname, int salary){
      session session = factory.opensession();
      transaction tx = null;
      integer employeeid = null;
      try{
         tx = session.begintransaction();
         employee employee = new employee();
         employee.setfirstname(fname);
         employee.setlastname(lname);
         employee.setsalary(salary);
         employeeid = (integer) session.save(employee);
         tx.commit();
      }catch (hibernateexception e) {
         if (tx!=null) tx.rollback();
         e.printstacktrace();
      }finally {
         session.close();
      }
      return employeeid;
   }
   /* method to  read all the employees */
   public void listemployees( ){
      session session = factory.opensession();
      transaction tx = null;
      try{
         tx = session.begintransaction();
         list employees = session.createquery("from employee").list();
         for (iterator iterator =
                           employees.iterator(); iterator.hasnext();){
            employee employee = (employee) iterator.next();
            system.out.print("first name: " + employee.getfirstname());
            system.out.print("  last name: " + employee.getlastname());
            system.out.println("  salary: " + employee.getsalary());
         }
         tx.commit();
      }catch (hibernateexception e) {
         if (tx!=null) tx.rollback();
         e.printstacktrace();
      }finally {
         session.close();
      }
   }
   /* method to update salary for an employee */
   public void updateemployee(integer employeeid, int salary ){
      session session = factory.opensession();
      transaction tx = null;
      try{
         tx = session.begintransaction();
         employee employee =
                    (employee)session.get(employee.class, employeeid);
         employee.setsalary( salary );
         session.update(employee);
         tx.commit();
      }catch (hibernateexception e) {
         if (tx!=null) tx.rollback();
         e.printstacktrace();
      }finally {
         session.close();
      }
   }
   /* method to delete an employee from the records */
   public void deleteemployee(integer employeeid){
      session session = factory.opensession();
      transaction tx = null;
      try{
         tx = session.begintransaction();
         employee employee =
                   (employee)session.get(employee.class, employeeid);
         session.delete(employee);
         tx.commit();
      }catch (hibernateexception e) {
         if (tx!=null) tx.rollback();
         e.printstacktrace();
      }finally {
         session.close();
      }
   }
}

數(shù)據(jù)庫(kù)配置

現(xiàn)在，讓我們創(chuàng)建 hibernate.cfg.xml 配置文件來(lái)定義數(shù)據(jù)庫(kù)相關(guān)參數(shù)

<?xml version="1.0" encoding="utf-8"?>
<!doctype hibernate-configuration system
"http://www.hibernate.org/dtd/hibernate-configuration-3.0.dtd">

<hibernate-configuration>
   <session-factory>
   <property name="hibernate.dialect">
      org.hibernate.dialect.mysqldialect
   </property>
   <property name="hibernate.connection.driver_class">
      com.mysql.jdbc.driver
   </property>

   <!-- assume students is the database name -->
   <property name="hibernate.connection.url">
      jdbc:mysql://localhost/test
   </property>
   <property name="hibernate.connection.username">
      root
   </property>
   <property name="hibernate.connection.password">
      cohondob
   </property>

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

編譯和執(zhí)行

這里是編譯并運(yùn)行以上提到的應(yīng)用程序的步驟。再繼續(xù)編譯和運(yùn)行之前需要確保你正確設(shè)置路徑和類路徑。

• 從目錄中刪除 employee.hbm.xml 映射文件。
• 創(chuàng)建上述 employee.java 源文件并編譯。
• 創(chuàng)建上述 manageemployee.java 源文件并編譯。
• 執(zhí)行 manageemployee 二進(jìn)制程序。

你將得到如下結(jié)果，并且會(huì)在 employee 表中記錄。

$java manageemployee
.......various log messages will display here........

first name: zara  last name: ali  salary: 1000
first name: daisy  last name: das  salary: 5000
first name: john  last name: paul  salary: 10000
first name: zara  last name: ali  salary: 5000
first name: john  last name: paul  salary: 10000

如果你查看 employee 表，它將有如下記錄：

mysql> select * from employee;
+----+------------+-----------+--------+
| id | first_name | last_name | salary |
+----+------------+-----------+--------+
| 29 | zara       | ali       |   5000 |
| 31 | john       | paul      |  10000 |
+----+------------+-----------+--------+
2 rows in set (0.00 sec

mysql>