Hibernate Annotation案例分析
Hibernate有很多值得學(xué)習(xí)的地方，這里我們以JPA——Hibernate Annotation一個案例來具體說明。
目前，JPA（Java Persistence API）的使用范圍越來越廣，作為Java EE 5.0平臺標(biāo)準(zhǔn)的ORM規(guī)范，得到了諸如：Hibernate、TopLink、OpenJpa等ORM框架的支持，同時(shí)還是EJB 3.0的重要組成部分。JPA的宗旨是為POJO提供持久化標(biāo)準(zhǔn)規(guī)范。它能夠脫離容器獨(dú)立運(yùn)行，方便開發(fā)和測試。本文將通過一個小實(shí)例來說明如何在Hibernate Annotation中使用JPA，來達(dá)到簡化編程的目的。
開發(fā)環(huán)境 Eclipse 3.3.1 MyEclipse 6.0.1GA Tomcat 6.10 SQL Server 2000 hibernate-3.2.5.GA hibernate-annotations-3.3.0.GA ejb3-persistence hibernate-commons-annotations-3.0.0.GA
本文是為后續(xù)的多種Ajax技術(shù)框架應(yīng)用系列作一個前期準(zhǔn)備，讓大家先了解一下相比與以前的Hibernate ORM映射的不同之處，以及采用JPA所帶來的好處。
為了保證程序能順序運(yùn)行，避免不同的Eclipse版本之間產(chǎn)生錯誤，大象強(qiáng)烈建議，下載源碼后，按源碼中的工程名，自己單獨(dú)新建同一個工程，再將src和WEB-INF/lib目錄下的所有文件COPY至對應(yīng)的目錄下。
1、創(chuàng)建Web Projec
點(diǎn)擊"File"->"New"，選擇"Web Project"，在"Project Name"中輸入ajax，點(diǎn)擊"Finish"。下載本文后面需要用到的JAR包，加入到WEB-INF/lib目錄下，在ajax工程中，文本采用的是UTF-8編碼。
2、創(chuàng)建HibernateSessionFactory
傳統(tǒng)的方法就是在工程名上點(diǎn)右鍵，選擇”MyEclipse”->”Add Hibernate Capabilities”，然后就是按照提示一步一步做，不過在MyEclipse 6.0.1中添加Hibernate還是只能支持3.1，除非你選擇” Add Spring Capabilities”，里面才有Hibernate 3.2的類庫，要想完全兼容JPA，必須采用3.2以上版本。
這里大家直接使用源碼中的HibernateSessionFactory，注意請先建包：com.ajax.core,HibernateSessionFactory中有一個地方需要改動，原來的寫法是：
- private static Configuration configuration = new Configuration();
修改后為：
- private static AnnotationConfiguration configuration = new AnnotationConfiguration();
因?yàn)槲覀儾捎玫氖荍PA注釋方式來映射實(shí)體，另外AnnotationConfiguration這個類在hibernate-annotations.jar這個包中。
3、創(chuàng)建BaseDao
在com.ajax.core包下面新建BaseDao抽象類，里面定義的是持久化操作方法，有一點(diǎn)特別要注意，一定要在增加、刪除、修改這幾個方法中加入事務(wù)控制，不管是在BaseDao基類方法中加，還是在業(yè)務(wù)方法中加，一定要加事務(wù)控制，大象覺得在基類中加會比較好一點(diǎn)，這樣做代碼顯得更少更簡潔。如果不加事務(wù)控制，那么增、刪、改這些操作都不會產(chǎn)生效果，因?yàn)槟J(rèn)情況下，它不會進(jìn)行自動提交。在做這個例子的時(shí)候，這個問題曾經(jīng)困擾了我好長時(shí)間。因此，請大家記住不要再犯和大象一樣的錯誤！貼出部分代碼，詳情請看源碼，里面有很全面的注釋。
- /**
- * 抽象Dao類，用于持久化操作
- * @author 菠蘿大象
- * @version 1.0
- */
- public abstract class BaseDao<T> {
- private static Log log = LogFactory.getLog(BaseDao.class);
- /**
- * 獲取Hibernate的Session對象
- */
- public Session getSession(){
- return HibernateSessionFactory.getSession();
- }
- /**
- * 根據(jù)主鍵得到對象
- */
- public T getObject(Class clazz, Serializable id){
- return (T)getSession().get(clazz, id);
- }
- /**
- * 保存對象
- */
- public void saveObject(T t) {
- Session session = getSession();
- Transaction tx = beginTransaction(session);
- try{
- session.saveOrUpdate(t);
- tx.commit();
- }catch(Exception e){
- tx.rollback();
- log.error("保存對象失敗");
- }
- }
- /**
- * 創(chuàng)建事務(wù)
- */
- private Transaction beginTransaction(Session session){
- return session.beginTransaction();
- }
- }
4、創(chuàng)建Employee
在com.ajax.employee.mode包下新建Employee類，這個就是POJO類，下面來詳細(xì)說明里面的含義。
- @Entity
- @Table(name = "EMPLOYEE")
- public class Employee implements java.io.Serializable{
- private Integer employee_id; //人員ID（主鍵）
- private String employee_name; //人員姓名
- private String sex; //性別
- private String birthday; //出生日期
- private String address; //地址
- @Id
- @Column(name = "EMPLOYEE_ID")
- @TableGenerator(
- name="tab-store",
- table="GENERATOR_TABLE",
- pkColumnName = "G_KEY",
- pkColumnValue="EMPLOYEE_PK",
- valueColumnName = "G_VALUE",
- allocationSize=1
- )
- @GeneratedValue(strategy = GenerationType.TABLE,generator="tab-store")
- public Integer getEmployee_id() {
- return employee_id;
- }
- public void setEmployee_id(Integer employee_id) {
- this.employee_id = employee_id;
- }
- }
其它幾個屬性的getter和setter省略，這里我們要用到ejb3-persistence.jar，JPA的注解類就在這個包中，下面詳細(xì)說明上面使用到的注解。
@Entity：通過@Entity注解將一個類聲明為一個實(shí)體bean
@Table：通過 @Table注解可以為實(shí)體bean映射指定表，name屬性表示實(shí)體所對應(yīng)表的名稱，如果沒有定義 @Table，那么系統(tǒng)自動使用默認(rèn)值：實(shí)體的類名（不帶包名）
@Id：用于標(biāo)記屬性的主鍵
@Column：表示持久化屬性所映射表中的字段，如果屬性名與表中的字段名相同，則可以省略@Column注解，另外有兩種方式標(biāo)記，一是放在屬性前，另一種是放在getter方法前，例如：
- @Column(name = "EMPLOYEE_NAME")
- private String employee_name;
或者
- @Column(name = "EMPLOYEE_NAME")
- public String getEmployee_name() {
- return employee_name;
- }
這兩種方式都是正解的，根據(jù)個人喜好來選擇。大象偏向于第二種，并且喜歡將屬性名與字段名設(shè)成一樣的，這樣可以省掉@Column注解，使代碼更簡潔。
@TableGenerator：表生成器，將當(dāng)前主鍵的值單獨(dú)保存到一個數(shù)據(jù)庫表中，主鍵的值每次都是從指定的表中查詢來獲得，這種生成主鍵的方式是很常用的。這種方法生成主鍵的策略可以適用于任何數(shù)據(jù)庫，不必?fù)?dān)心不同數(shù)據(jù)庫不兼容造成的問題。大象推薦這種方式管理主鍵，很方便，集中式管理表的主鍵，而且更換數(shù)據(jù)庫不會造成很大的問題。各屬性含義如下：
◆name：表示該表主鍵生成策略的名稱，這個名字可以自定義，它被引用在@GeneratedValue中設(shè)置的"generator"值中
◆table：表示表生成策略所持久化的表名，說簡單點(diǎn)就是一個管理其它表主鍵的表，本例中，這個表名為GENERATOR_TABLE
◆pkColumnName：表生成器中的列名，用來存放其它表的主鍵鍵名，這個列名是與表中的字段對應(yīng)的
◆pkColumnValue：實(shí)體表所對應(yīng)到生成器表中的主鍵名，這個鍵名是可以自定義滴
◆valueColumnName：表生成器中的列名，實(shí)體表主鍵的下一個值，假設(shè)EMPLOYEE表中的EMPLOYEE_ID最大為2 那么此時(shí)，生成器表中與實(shí)體表主鍵對應(yīng)的鍵名值則為3
◆allocationSize：表示每次主鍵值增加的大小，例如設(shè)置成1，則表示每次創(chuàng)建新記錄后自動加1，默認(rèn)為50
@GeneratedValue：定義主鍵生成策略，這里因?yàn)槭褂玫氖荰ableGenerator，所以，主鍵的生成策略為GenerationType.TABLE，生成主鍵策略的名稱則為前面定義的”tab-store”。
這里大象想說下，網(wǎng)上有很多文章寫的是strategy = GenerationType.AUTO或是strategy = GenerationType.SEQUENCE，采用SEQUENCE序列是因?yàn)镺racle數(shù)據(jù)中不支持identity自動增長，要想使用它，還得在數(shù)據(jù)庫中創(chuàng)建一個序列，如果要更換數(shù)據(jù)庫，那將是一個非常麻煩的事情。SEQUENCE生成方式我們暫且不談，這里說下采用AUTO和IDENTITY的生成方式，本例采用的是SQL Server 2000作為數(shù)據(jù)庫，所以如果想使用AUTO或是IDENTITY生成策略，則一定要對主鍵加上identity標(biāo)識，如identity(1,1)。不過對于AUTO來說，是根據(jù)不同的數(shù)據(jù)庫選擇最合適的自增主鍵生成策略。
如果使用MySQL，則主鍵要定義AUTO_INCREMENT，如果是Oracle，則要創(chuàng)建Sequence來實(shí)現(xiàn)自增。不管采用何種生成策略，增、刪、改這些方法中一定要加入事務(wù)，否則數(shù)據(jù)是不會添加到數(shù)據(jù)庫中滴~~~這是大象反復(fù)測試過的結(jié)果！
5、創(chuàng)建數(shù)據(jù)庫及表
接下來，我們需要為本例創(chuàng)建一個數(shù)據(jù)庫及必要的表。數(shù)據(jù)庫名為ajax，表只有兩個EMPLOYEE和GENERATOR_TABLE，下面是SQL腳本：
- CREATE TABLE EMPLOYEE(
- EMPLOYEE_ID int not null,
- EMPLOYEE_NAME varchar (20) null,
- SEX char (2) null,
- BIRTHDAY varchar(10) null,
- ADDRESS varchar(50) null,
- CONSTRAINT PK_EMPLOYEE PRIMARY KEY (EMPLOYEE_ID)
- )
- CREATE TABLE GENERATOR_TABLE(
- ID int not null,
- G_KEY varchar(20) null,
- G_VALUE int null,
- CONSTRAINT PK_GENERATOR_TABLE PRIMARY KEY (ID)
- )
- INSERT INTO GENERATOR_TABLE VALUES(1,EMPLOYEE_PK,1)
如果你覺得麻煩，不想建庫及表，可以將后面的數(shù)據(jù)庫下載下來，然后還原數(shù)據(jù)庫就可以了。
6、修改hibernate.cfg.xml
本例中，采用的是JTDS連接驅(qū)動，我們要對配置文件作一些設(shè)置，另外還要加入POJO類。
- <property name="dialect">org.hibernate.dialect.SQLServerDialectproperty>
- <property name="connection.driver_class">net.sourceforge.jtds.jdbc.Driverproperty>
- <property name="connection.url">jdbc:jtds:sqlserver://localhost:1433/ajaxproperty>
- <property name="connection.username">saproperty>
- <property name="connection.password">自己密碼(無密碼就空著)property>
- <mapping class="com.ajax.employee.model.Employee"/>
以前沒有使用JPA注解的時(shí)候，我們這里加入的都是hbm.xml文件，現(xiàn)在我們則加入的是類。
7、創(chuàng)建EmployeeManager
在com.ajax.employee.service下新建EmployeeManager類，這里面就是寫業(yè)務(wù)方法，另外在這個類中添加一個main方法用于測試，將log4j的日志級別調(diào)整為DEBUG，這樣我們就可以看到很詳細(xì)的程序運(yùn)行信息，源碼中的注釋很詳細(xì)，這里就不貼出來了。
本例沒有提供MySQL和Oracle數(shù)據(jù)庫的腳本，不過這些應(yīng)該很簡單，按照最基本的方式建一個數(shù)據(jù)庫和兩張表就行了，這里附上兩種數(shù)據(jù)庫的hibernate配置。
MySQL：
- <property name="hibernate.dialect">org.hibernate.dialect.MySQLInnoDBDialectproperty>
- <property name="connection.driver_class">com.mysql.jdbc.Driverproperty>
- <property name="connection.url">jdbc:mysql://localhost:3306/ajaxproperty>
- <property name="connection.username">rootproperty>
- <property name="connection.password">自己的密碼(無密碼就空著)property>
Oracle：
- <property name="hibernate.dialect">org.hibernate.dialect.OracleDialectproperty>
- <property name="connection.driver_class">oracle.jdbc.driver.OracleDriverproperty>
- <property name="connection.url">jdbc:oracle:thin:@127.0.0.1:1521:自己的SIDproperty>
- <property name="connection.username">systemproperty>
- <property name="connection.password">自己的密碼(無密碼就空著)property>
本文主要是從實(shí)用的角度來說明如何在Hibernate Annotation中使用JPA注釋來簡化開發(fā)，以及為后面的多種Ajax技術(shù)框架應(yīng)用系列作一個前期準(zhǔn)備。從這里可以看出，我們不需要再編寫繁瑣的hbm.xml文件。另外，JPA的功能很強(qiáng)大，這里只展示了其中的冰山一角，如果想深入學(xué)習(xí)JPA的話，請單獨(dú)查找資料或購買相關(guān)書籍。
【編輯推薦】
