Hibernate框架注解

1.使用Hibernate注解的步骤
                1.添加jar包
                            Hibernate-annotations.jar
                            Hibernate-commons-annotations.jar
                            ejb3-persistence.jar
                2.使用注解配置持久化类及对象关联关系
                3.使用AnnotationConfiguration创建会话工厂
                            sessionFactory = new  AnnotationConfiguration().configure().buildSessionFactory();
                4.在Hibernate配置文件（hibernate.cfg.xml）中声明持久化类
                            <mapping class="持久化类完整限定名" />
        2.配置持久化类的经常使用注解
                @Entity     将一个类声明为一个持久化类
                @Id            声明了持久化类的标识属性（至关于数据表的主键）
                @GeneratedValue    定义标识属性值的生成策略
                @Table        为持久化类映射指定表（table）。目录（catalog）和schema的名称。默认值：持久化类名，不带包名
                @UniqueConstraint  定义表的惟一约束
                @Lob        表示属性将被持久化为Blob或者Clob类型
                @Column        将属性映射到列
                @Transient    忽略这些字段和属性，不用持久化到数据库
                
                
                @GeneratedValue    定义标识属性值的生成策略，JPA提供了4种标准用法
                        (1) AUTO：根据不一样的数据库选择不一样的策略
                        (2) TABLE：使用表保存id值
                        (3) INDENTITY：使用数据库自动生成主键
                        (4) SEQUENCE：使用序列建立主键
         

　　　　　　

3.十三种策略（strategy属性的值）以下：

● native

对于orcale采用Sequence方式，对于MySQL和SQL Server采用identity(处境主键生成机制)，native就是将主键的生成工做将由数据库完成，hibernate无论（很经常使用）

例：@GeneratedValue(generator = "paymentableGenerator")

       @GenericGenerator(name = "paymentableGenerator", strategy = "native")

● uuid

采用128位的uuid算法生成主键，uuid被编码为一个32位16进制数字的字符串。占用空间大（字符串类型）。

例：@GeneratedValue(generator = "paymentableGenerator")

       @GenericGenerator(name = "paymentableGenerator", strategy = "uuid")

● hilo

要在数据库中创建一张额外的表，默认表名为hibernate_unque_key，默认字段为integer类型，名称是next_hi（比较少用）。

例：@GeneratedValue(generator = "paymentableGenerator")

       @GenericGenerator(name = "paymentableGenerator", strategy = "hilo")

● assigned

在插入数据的时候主键由程序处理（很经常使用），这是<generator>元素没有指定时的默认生成策略。等同于JPA中的AUTO。

例：@GeneratedValue(generator = "paymentableGenerator")

       @GenericGenerator(name = "paymentableGenerator", strategy = "assigned")

● identity

使用SQL Server和MySQL的自增字段，这个方法不能放到Oracle中，Oracle不支持自增字段，要设定sequence(MySQL和SQL Server中很经常使用)。等同于JPA中的IDENTITY

例：@GeneratedValue(generator = "paymentableGenerator")

       @GenericGenerator(name = "paymentableGenerator", strategy = "identity")

● select

使用触发器生成主键（主要用于早期的数据库主键生成机制，少用）

例：@GeneratedValue(generator = "paymentableGenerator")

       @GenericGenerator(name = "paymentableGenerator", strategy = "select")

● sequence

调用谨慎数据库的序列来生成主键，要设定序列名，否则hibernate没法找到。

例：@GeneratedValue(generator = "paymentableGenerator")

       @GenericGenerator(name = "paymentableGenerator", strategy = "sequence", parameters = { @Parameter(name = "sequence", value = "seq_payablemoney") }) 

● seqhilo

经过hilo算法实现，可是主键历史保存在Sequence中，适用于支持Sequence的数据库，如Orcale(比较少用）。

例：@GeneratedValue(generator = "paymentableGenerator")

       @GenericGenerator(name = "paymentableGenerator", strategy = "seqhilo", parameters = { @Parameter(name = "max_lo", value = "5") }) 

● increnment

插入数据的时候hibernate会给主键添加一个自增的主键，可是一个hibernate实例就维护一个计数器，因此在多个实例运行的时候不能使用这个方法。

例：@GeneratedValue(generator = "paymentableGenerator")

       @GenericGenerator(name = "paymentableGenerator", strategy = "increnment")

● foreign

使用另外一个相关的对象的主键。一般和@OneToOne联合起来使用。

例：@Id

       @GeneratedValue(generator = "idGenerator")

       @GenericGenerator(name = "idGenerator", strategy = "foreign", parameters = { @Parameter(name = "property", value = "info") })

       Integer id;

 

       @OneToOne

       EmployeeInfo info;

● guid

采用数据库底层的guid算法机制，对应MySQL的uuid()函数，SQL Server的newid()函数，ORCALE的rawtohex(sys_guid())函数等。

例：@GeneratedValue(generator = "paymentableGenerator")

       @GenericGenerator(name = "paymentableGenerator", strategy = "guid")

● uuid.hex

参见uuid，建议用uuid替换。

● sequence-identity

sequence策略的扩展，采用当即检索策略来获取sequence值，须要JDBC3.0和JDK4以上（含1.4）版本。

例：@GeneratedValue(generator = "paymentableGenerator")

       @GenericGenerator(name = "paymentableGenerator", strategy = "sequence-identity", parameters = { @Parameter(name = "sequence", value = "seq_payablemoney") })

 8. @Transient

声明了非持久化属性，即数据库中没有相应的映射字段，是一个普通属性。

9. @Temporal

声明了日期类型。

TemporalType.DATE 日期，例：2011-04-12

TemporalType.TIME 时间，例：22:50:30

TemporalType.TIMESTAMP 日期和时间，例：2011-04-12 22:51:30

10. @Version

声明了对乐观锁定的支持

例：@Version

       @Column(name="OPTLOCK")

       public Integer getVersion() { ... }

上面这个例子中，version属性将映射到 OPTLOCK列，entity manager使用该字段来检测更新冲突（防止更新丢失，请参考last-commit-wins策略）。

根据EJB3规范，version列能够是numeric类型（推荐方式）也能够是timestamp类型。Hibernate支持任何自定义类型,只要该类型实现了UserVersionType。

                                                                         eg：                Emp.java                    import javax.persistence.*                                                @Entity                        @Talble(name="Emp")                        public class Emp implements jaca.io.Serializable{                            @Id                            @GeneratedValue(strategy = GenerationType.SEQUENCE,generator = "seq_emp")                            @SequenceGenerator(name = "seq_emp",sequenceName = "seq_emp_id",                                allocationSize = 10,initialValue = 1)                            private Short empNo;                            @Column(name = "ename")                            private String eName;                            @Column(name = "hiredate")                            private Date hiredate;                            @Transient                            private Dept dept;                            @Transient                            private String job;                            @Transient                            private Short mgr;                            @Transient                            private Double salary;                            @Transient                            private Double comm;                            public  Emp(){}                            //省略getter()和setter方法                        }                                Hibernate.cfg.xml                                    <hibernate-configuration>                        <session-factory>                            <mapping class="cn.jbit.hibernatedemo.entity.Emp"/>                        </session-factory>                    </hibernate-configuration>                                    测试类代码：                    SessionFactory sf = new AnnotationConfiguration().configure().buildSessionFactory();                    Session session = sf.openSession();                    Transantion tx = session.beginTranaction();                    Emp emp = new Emp();                    emp.setEmpName("test1");                    emp.setHiredate(new Date());                    session.save();                    tx.commit();                                    //注：                    1.Emp类映射到Emp表，empNo为主键，主键采用序列生成，需在数据库中建立序列Sequence，                            名为seq_emp_id 注解都放置在属性定义的上方                    2.使用@GeneratedValue设置主键生成策略，strantegy = Generatipe.Sequence描述了主键生成策略为Sequence                            generator = "seq_emp"指定了生成器为seq_emp;                    3.使用@SequenceGenerator设置了序列生成器，name="seq_emp"定义了序列生成器的名称为seq_emp;sequenceName                            ="seq_emp_id"指定了序列Sequence的名称为seq_emp_id,数据库中需建立序列Sequence，名称为seq_emp_id                            ;initialValue = 1 设置了主键初始值，默认为0；allocationSize=1表示预分配多少个主键值，如设置为1                            表示不预分配主键值，默认为50                    4.使用@Column把empName属性映射到EMP表中的Ename列                      使用@Column把hiredate属性映射到EMP表中的Hiredate列                      使用@Transient把其余属性忽略，不持久化到数据库中                      在Hibernate.cfg.xml中，使用mapping元素声明持久化类                3.注解配置对象关联关系                @OneToOne            创建持久化类之间的一对一关联关系                @OneToMany            创建持久化类之间的一对多关联关系                @ManyToOne            创建持久化类之间的多对一关联关系                @ManyToMany            创建持久化类之间的多对多关联关系                                        3.1 按主键查询员工，并使用@ManyToMany加载部门                            eg:                    Emp.java                                        import javax.persistence.*                                                @Entity                        @Talble(name="Emp")                        public class Emp implements jaca.io.Serializable{                            @Id                            @GeneratedValue(strategy = GenerationType.SEQUENCE,generator = "seq_emp")                            @SequenceGenerator(name = "seq_emp",sequenceName = "seq_emp_id",                                allocationSize = 10,initialValue = 1)                            private Short empNo;                            @Column(name = "ename")                            private String eName;                            @Column(name = "hiredate")                            private Date hiredate;                            @ManyToOne                   使用@ManyToOne配置了Emp和Dept类之间的多对一关联；使用JoinColumn                                                            (name="deptNo")指定了维系关系的外键字段是EMP表中的DeptNo。Hibernate                                                                Hibernate生成的SQL语句使用了左外链接关键字                            @JoinColumn(name = "deptno")                            private Dept dept;                            public  Emp(){}                            //省略getter()和setter方法                        }                                                    Dept.java                                            @Entity                        @Talble(name="Dept")                        public class Dept implements java.io.Serializable{                            @Id                            private Integer deptNo;                            @Column(name="dname")                            private String deptName;                            //省略getter和setter方法                            public Dept(){}                        }                                                                Hibernate.cfg.xml                                    <hibernate-configuration>                        <session-factory>                            <mapping class="cn.jbit.hibernatedemo.entity.Emp"/>                            <mapping class="cn.jbit.hibernatedemo.entity.Dept"/>                        </session-factory>                    </hibernate-configuration>                                    测试类代码：                                    SessionFactory sf = new AnnotationConfiguration().configure().buildSessionFactory();                    Session session = sf.openSession();                    Transantion tx = session.beginTranaction();                    Emp emp = (Emp)session.load(Emp.class,new Short("3"));                    System.out.print(emp.getEmpName()+","+emp.getDept().getDeptName());                                                3.2 级联的配置，添加部门的同时添加员工                            cascade属性指定级联操做                    1.CascadeType.remove：链接删除                    2.CascadeType.persist：persist()方法级联                    3.CascadeType.merge：级联更新                    4.CascadeType.refresh：级联刷新                    5.CascadeType.all：包含所欲有级联操做                eg:                    Emp.java                                        import javax.persistence.*                                                @Entity                        @Talble(name="Emp")                        public class Emp implements jaca.io.Serializable{                            @Id                            @GeneratedValue(strategy = GenerationType.SEQUENCE,generator = "seq_emp")                            @SequenceGenerator(name = "seq_emp",sequenceName = "seq_emp_id",                                allocationSize = 10,initialValue = 1)                            private Short empNo;                            @Column(name = "ename")                            private String eName;                            @Column(name = "hiredate")                            private Date hiredate;                            @ManyToOne                   使用@ManyToOne配置了Emp和Dept类之间的多对一关联；使用JoinColumn                                                            (name="deptNo")指定了维系关系的外键字段是EMP表中的DeptNo。Hibernate                                                                Hibernate生成的SQL语句使用了左外链接关键字                            @JoinColumn(name = "deptno")                            private Dept dept;                            public  Emp(){}                            //省略getter()和setter方法                        }                                                    Dept.java                                            @Entity                        @Talble(name="Dept")                        public class Dept implements java.io.Serializable{                            @Id                            private Integer deptNo;                            @Column(name="dname")                            private String deptName;                            @Transient                            private String location;                            @OneToMany(mappedBy="dept",cascade = {CascadeType.ALL})                            private Set<Emp> emps = new  HashSet<Emp>();                            //省略getter和setter方法                            public Dept(){}                        }                                                                Hibernate.cfg.xml                                    <hibernate-configuration>                        <session-factory>                            <mapping class="cn.jbit.hibernatedemo.entity.Emp"/>                            <mapping class="cn.jbit.hibernatedemo.entity.Dept"/>                        </session-factory>                    </hibernate-configuration>                                    测试类代码：                                    SessionFactory sf = new AnnotationConfiguration().configure().buildSessionFactory();                    Session session = sf.openSession();                    Transantion tx = session.beginTranaction();                    Dept dept = new Dept(6,"产品部");                    Emp emp = new  Emp();                    emp.setEmpName("villy");                    emp.setHiredate(new Date());                    dept.getEmps().add(emp);                    emp.setDept(dept);                    session.save(dept)'                    tx.commit();                                                4.注解配置命名查询                Emp.java                        @Entity                        @Talble(name="Emp")                        @NamedQuery(name="selectEmp",query="from Emp where empName like :ename")                        public class Emp implements jaca.io.Serializable{                            @Id                            @GeneratedValue(strategy = GenerationType.SEQUENCE,generator = "seq_emp")                            @SequenceGenerator(name = "seq_emp",sequenceName = "seq_emp_id",                                allocationSize = 10,initialValue = 1)                            private Short empNo;                            @Column(name = "ename")                            private String eName;                            @Column(name = "hiredate")                            private Date hiredate;                            @ManyToOne                   使用@ManyToOne配置了Emp和Dept类之间的多对一关联；使用JoinColumn                                                            (name="deptNo")指定了维系关系的外键字段是EMP表中的DeptNo。Hibernate                                                                Hibernate生成的SQL语句使用了左外链接关键字                            @JoinColumn(name = "deptno")                            private Dept dept;                            public  Emp(){}                            //省略getter()和setter方法                        }                                        测试类代码：                                    List<Emp> list = session.getNameQuery("selectEmp").setString("ename","%r%").list();                    for(Emp emp : list){                        System.out.print(emp.getEmpName);                    }