学习JPA——Hibernate Annotation使用实例

目前，JPA（Java Persistence API）的使用范围越来越广，作为Java EE 5.0平台标准的ORM规范，得到了诸如：Hibernate、TopLink、OpenJpa等ORM框架的支持，同时还是EJB 3.0的重要组成部分。JPA的宗旨是为POJO提供持久化标准规范。它能够脱离容器独立运行，方便开发和测试。本文将通过一个小实例来说明如何在Hibernate中使用JPA，来达到简化编程的目的。
    开发环境  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
    本文是为后续的多种Ajax技术框架应用系列作一个前期准备，让大家先了解一下相比与以前的Hibernate ORM映射的不同之处，以及采用JPA所带来的好处。
    为了保证程序能顺序运行，避免不同的Eclipse版本之间产生错误，大象强烈建议，下载源码后，按源码中的工程名，自己单独新建同一个工程，再将src和WEB-INF/lib目录下的所有文件COPY至对应的目录下。
    1、创建Web Project
       点击"File"->"New"，选择"Web Project"，在"Project Name"中输入ajax，点击"Finish"。下载本文后面需要用到的JAR包，加入到WEB-INF/lib目录下，在ajax工程中，文本采用的是UTF-8编码。
    2、创建HibernateSessionFactory
       传统的方法就是在工程名上点右键，选择”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();

       因为我们采用的是 JPA 注释方式来映射实体，另外 AnnotationConfiguration 这个类在 hibernate-annotations.jar 这个包中。
    3、创建BaseDao
       在com.ajax.core包下面新建BaseDao抽象类，里面定义的是持久化操作方法，有一点特别要注意，一定要在增加、删除、修改这几个方法中加入事务控制，不管是在BaseDao基类方法中加，还是在业务方法中加，一定要加事务控制，大象觉得在基类中加会比较好一点，这样做代码显得更少更简洁。如果不加事务控制，那么增、删、改这些操作都不会产生效果，因为默认情况下，它不会进行自动提交。在做这个例子的时候，这个问题曾经困扰了我好长时间。因此，请大家记住不要再犯和大象一样的错误！贴出部分代码，详情请看源码，里面有很全面的注释。

/**
 * 抽象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();
    }
    
     /**
     * 根据主键得到对象
     */
     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( "保存对象失败" );
        }
    }
    
     /**
     * 创建事务
     */
     private  Transaction beginTransaction(Session session){
         return  session.beginTransaction();
    }
}

    4、创建Employee
       在com.ajax.employee.mode包下新建Employee类，这个就是POJO类，下面来详细说明里面的含义。

@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的注解类就在这个包中，下面详细说明上面使用到的注解。
      @Entity：通过@Entity注解将一个类声明为一个实体bean
      @Table：通过 @Table注解可以为实体bean映射指定表，name属性表示实体所对应表的名称，如果没有定义 @Table，那么系统自动使用默认值：实体的类名（不带包名）
      @Id：用于标记属性的主键
      @Column：表示持久化属性所映射表中的字段，如果属性名与表中的字段名相同，则可以省略@Column注解，另外有两种方式标记，一是放在属性前，另一种是放在getter方法前，例如：

    @Column(name  =   " EMPLOYEE_NAME " )
     private  String employee_name;

       或者

    @Column(name  =   " EMPLOYEE_NAME " )
     public  String getEmployee_name() {
         return  employee_name;
    }

       这两种方式都是正解的，根据个人喜好来选择。大象偏向于第二种，并且喜欢将属性名与字段名设成一样的，这样可以省掉@Column注解，使代码更简洁。
      @TableGenerator：表生成器，将当前主键的值单独保存到一个数据库表中，主键的值每次都是从指定的表中查询来获得，这种生成主键的方式是很常用的。这种方法生成主键的策略可以适用于任何数据库，不必担心不同数据库不兼容造成的问题。大象推荐这种方式管理主键，很方便，集中式管理表的主键，而且更换数据库不会造成很大的问题。各属性含义如下：
        name：表示该表主键生成策略的名称，这个名字可以自定义，它被引用在@GeneratedValue中设置的"generator"值中
        table：表示表生成策略所持久化的表名，说简单点就是一个管理其它表主键的表，本例中，这个表名为GENERATOR_TABLE
        pkColumnName：表生成器中的列名，用来存放其它表的主键键名，这个列名是与表中的字段对应的
        pkColumnValue：实体表所对应到生成器表中的主键名，这个键名是可以自定义滴
        valueColumnName：表生成器中的列名，实体表主键的下一个值，假设EMPLOYEE表中的EMPLOYEE_ID最大为2，那么此时，生成器表中与实体表主键对应的键名值则为3
        allocationSize： 表示每次主键值增加的大小，例如设置成 1 ，则表示每次创建新记录后自动加 1 ，默认为 50

      @GeneratedValue： 定义主键生成策略，这里因为使用的是 TableGenerator ，所以，主键的生成策略为 GenerationType.TABLE ， 生成主键策略的名称则为前面定义的 ” tab-store ” 。
        这里大象想说下，网上有很多文章写的是 strategy = GenerationType.AUTO 或是 strategy = GenerationType. SEQUENCE ，采用 SEQUENCE 序列是因为 Oracle 数据中不支持 identity 自动增长，要想使用它，还得在数据库中创建一个序列，如果要更换数据库，那将是一个非常麻烦的事情。 SEQUENCE 生成方式我们暂且不谈，这里说下采用 AUTO 和 IDENTITY 的生成方式，本例采用的是<sp>