Hibernate 注解使用

摘要：声明添加对乐观锁定的支持一些属性关联关系获取方式即是否采用延时加载及时加载，是在查询数据时，也直接一起获取关联对象的数据。在前面的基础上增加课程类并补充学生类学生类负责关联关系

在Hibernate中通常配置对象关系映射关系有两种，一种是基于xml的方式，另一种是基于Hibernate Annotation库的注解方式。在Hibernate 3.2版本和Java 5 环境下开始支持使用注解配置对象关系映射，使用Hibernate注解之后，可不用定义持久化类所对应的*.hbm.xml文件，直接用注解的方式写入持久化类中实现

两种方法要注意的两个不同处：
（1）：hibernate.hbm.xml 文件中把引用：xxx.hbm.xml改为引用实体类：

即把
改为：

（2）：获取SessionFactory方式发生了变化：

即把SessionFactorysf=newConfiguration().configure().buildSessionFactory()
改为SessionFactory sf=new AnnotationConfiguration().configure().buildSessionFactory()

在属性注解使用上，您既可以保持字段的持久性（注解写在成员变量之上），也可以保持属性（注解写在getter方法之上）的持久性,但建议不要在属性上引入注解，因为属性是private的，如果引入注解会破坏其封装特性，所以建议在getter方法上加入注解

@Entity

将一个Javabean类声明为一个实体的数据库表映射类,最好实现序列化。默认情况下,所有的类属性都为映射到数据表的持久性字段。若在类中有属性不映射到数据库中的,要用下面的@Transient来注解。
*属性:*
`name` - 可选，对应数据库中的一个表。若表名与实体类名相同，则可以省略。

@Table
在@Entity下使用，表示实体对应数据库中的表的信息

属性:
name - 可选，表示表的名称，默认表名和实体名称一致，不一致的情况下需指定表名。
catalog - 可选，表示Catalog名称，默认为 Catalog("")
schema - 可选 , 表示 Schema 名称 , 默认为Schema("")

@Entity()
@Table(name="Student")
public class Student implements Serializable{
}

@Id

必须，定义了映射到数据库表的主键的属性，一个实体只能有一个属性被映射为主键

@GeneratedValue

定义自动增长的主键的生成策略.
属性:
strategy - 表示主键生成策略，取值有以下


GenerationType.AUTO
根据底层数据库自动选择（默认），若数据库支持自动增长>类型，则为自动增长。



GenerationType.INDENTITY
根据数据库的Identity字段生成，支持DB2、MySQL、MS、SQL Server、SyBase与HyperanoicSQL数据库的Identity


GenerationType.SEQUENCE
使用Sequence来决定主键的取值，适合Oracle、DB2等支持Sequence的数据库，一般结合@SequenceGenerator使用。(Oracle没有自动增长类型，只能用Sequence)


GenerationType.TABLE
使用指定表来决定主键取值，结合@TableGenerator使用。

@Id
@GeneratedValue(strategy=GenerationType.IDENTITY) 
private int sid;

GenerationType.TABLE的使用

@Id  
@GeneratedValue(strategy=GenerationType.TABLE,generator="strategyName")   
@TableGenerator(
    name = "strategyName",   // 主键生成策略的名称，它被引用在@GeneratedValue中设置的“generator”值中
    table="",   //表示表生成策略所持久化的表名   
    catalog="",   //表所在的目录名
    schema="",   //数据库名
    pkColumnName="",   //在持久化表中，该主键生成策略所对应键值的名称
    valueColumnName="",   //表示在持久化表中，该主键当前所生成的值，它的值将会随着每次创建累加  
    pkColumnValue="",   //表示在持久化表中，该生成策略所对应的主键  
    allocationSize=1   //表示每次主键值增加的大小，例如设置成1，则表示每次创建新记录后自动加1，默认为50
)  

GenerationType.SEQUENCE的使用

@Id  
@GeneratedValue(strategy = GenerationType.SEQUENCE,generator="strategyName")   
@SequenceGenerator(
    name="strategyName", //name属性表示该表主键生成策略的名称，它被引用在@GeneratedValue中设置的“generator”值中
    sequenceName=""  //表示生成策略用到的数据库序列名称
) 

更多基于注解的Hibernate主键生成策略介绍

@Transient

将忽略这些字段和属性,不用持久化到数据库。

@Column

可将属性映射到列,使用该注解来覆盖默认值
属性:
name- 可选，表示数据库表中该字段的名称，默认情形属性名称一致

length - 可选，表示该字段的大小，仅对 String 类型的字段有效，默认值255.
insertable - 可选，表示在ORM框架执行插入操作时，该字段是否应出现INSETRT 语句中，默认为 true
updateable - 可选，表示在ORM 框架执行更新操作时，该字段是否应该出现在 UPDATE 语句中，默认为 true. 对于一经创建就不可以更改的字段，该属性非常有用，如对于 birthday 字段。
columnDefinition - 可选，表示该字段在数据库中的实际类型。通常ORM 框架可以根 据属性类型自动判断数据库中字段的类型，但是对于Date 类型仍无法确定数据库中字段类型究竟是 DATE,TIME 还是 TIMESTAMP. 此外 ,String 的默认映射类型为 VARCHAR, 如果要将 String 类型映射到特定数据库的 BLOB或 TEXT 字段类型，该属性非常有用。

@Version

声明添加对乐观锁定的支持

一些属性

fetch

关联关系获取方式,即是否采用延时加载
Fetch.EAGER -  及时加载，是在查询数据时，也直接一起获取关联对象的数据。多对一默认是Fetch.EAGER  
Fetch.LAZY -延迟加载，查询数据时，不一起查询关联对象的数据。而是当访问关联对象时才触发相应的查询操作，获取关联对象数据。一对多默认是Fetch.LAZY

cascade

设置级联方式
CascadeType.PERSIST 保存
CascadeType.REMOVE - 删除
CascadeType.MERGE 修改 
CascadeType.REFRESH 刷新 
CascadeType.ALL - 全部

mappedBy

mappedBy指的是多方对一方的依赖的属性，(注意：如果没有指定由谁来维护关联关系，则系统会给我们创建一张中间表)。
如果这个一对多的关系不是通过第三张表来维持，而是多方保存一方的id（多方外键引用一方），则必须要有mappedBy来指明多方中哪个变量来保存一方（外键），值是多方里面保存一方的属性名字
在判断到底是谁维护关联关系时，可以通过查看外键，哪个实体类定义了外键，哪个类就负责维护关联关系
 mappedBy相当于xml配置中的inverse="true"

@OneToMany

描述一个一对多的关联，该属性应该为集合类型 @OneToMany  默认会使用连接表做一对多关联
如果这个一对多的关系不是通过第三张表来维持，而是多方保存一方的id（多方外键引用一方），则必须要有mappedBy来指明多方中哪个变量来保存一方（外键），值是多方里面保存一方的属性名字

@OneToMany(cascade={CascadeType.ALL},mappedBy="grade")
    public Set getStudents() {
        return students;
    }

@ManyToOne

表示一个多对一的映射，该注解标注的属性通常是数据库表的外键。 单向多对一关联在多方：
@ManyToOne(targetEntity=XXXX.class)   //指定关联对象 
@JoinColumn(name="")  //指定产生的外键字段名

双向一对多同双向多对一

在多方 
@ManyToOne 
@JoinColumn(name="自己的数据库外键列名")
在一方
@OneToMany(mappedBy="多端的关联属性名")

/*
 * 学生类负责关联关系
 */
@Entity
@Table(name="Student")
public class Student implements Serializable{
    private int sid;
    private String sex;
    private String name;
    private Grade grade;
    public Student() {
        
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    @Id
    @GenericGenerator(name="generator",strategy="native")
    @GeneratedValue(generator="generator")
    public int getId() {
        return sid;
    }
    public void setId(int id) {
        this.sid = id;
    }
    @Column(name="sex")
    public String getSex() {
        return sex;
    }
    public void setSex(String sex) {
        this.sex = sex;
    }
    @ManyToOne(cascade={CascadeType.ALL})
    @JoinColumn(name="gid")
    public Grade getGrade() {
        return grade;
    }
    public void setGrade(Grade grade) {
        this.grade = grade;
    }
}

/*
 * 班级类
 */
@Entity
@Table(name="Grade")
public class Grade implements Serializable{
    private int gid;
    private String name;
    private Set students=new HashSet();
    public Grade() {
    }
    @Id
    @GenericGenerator(name="generator",strategy="native")
    @GeneratedValue(generator="generator")
    public int getGid() {
        return gid;
    }
    public void setGid(int gid) {
        this.gid = gid;
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    @OneToMany(cascade={CascadeType.ALL},mappedBy="grade")
    public Set getStudents() {
        return students;
    }
    public void setStudents(Set students) {
        this.students = students;
    }
}

在多对多关联中,双方都采用@ManyToMany. 其中被维护方mappedBy表示由另一多方维护
通过中间表由任一多方来维护关联关系
其中主控方,不像一对多注解那样,采用@joinColumn,而是采用@joinTable

 @JoinTable(
     name="student_course",
     joinColumns={@JoinColumn(name="")},
     inverseJoinColumns={@JoinColumn(name="")}
)

因为多对多之间会通过一张中间表来维护两表直接的关系，所以通过JoinTable 这个注解来声明。
 name就是指定了中间表的名字。
JoinColumns是一个@JoinColumn类型的数组，表示的是我这方在对方中的外键名称，就是当前类的主键。
inverseJoinColumns也是一个@JoinColumn类型的数组，表示的是对方在我这方中的外键名称，也可以这样想：上面提到mappedBy,相当于inverse="true".所以,在@joinTable中的inverseJoinColumns中定义的字段为mappedBy所在类的主键。

在前面的基础上增加课程类并补充学生类

/*
 * 学生类负责关联关系
 */
@Entity
@Table(name="Student")
public class Student implements Serializable{
    private int sid;
    private String name;
    private String sex;
    private Grade grade;
    private Set courses=new HashSet();
    public Student() {
        
    }
    public String getName() {
        return name;
    }
    public void setName(String name) {
        this.name = name;
    }
    @Id
    @GenericGenerator(name="generator",strategy="native")
    @GeneratedValue(generator="generator")
    public int getId() {
        return sid;
    }
    public void setId(int id) {
        this.sid = id;
    }
    @Column(name="sex")
    public String getSex() {
        return sex;
    }
    public void setSex(String sex) {
        this.sex = sex;
    }
    @ManyToOne(cascade={CascadeType.ALL})
    @JoinColumn(name="gid")
    public Grade getGrade() {
        return grade;
    }
    public void setGrade(Grade grade) {
        this.grade = grade;
    }
    @ManyToMany(cascade={CascadeType.ALL},fetch=FetchType.EAGER)
    @JoinTable(name="student_course",joinColumns={@JoinColumn(name="sid")},inverseJoinColumns={@JoinColumn(name="cid")})
    public Set getCourses() {
        return courses;
    }
    public void setCourses(Set courses) {
        this.courses = courses;
    }
}

@Entity
@Table(name="Course")
public class Course implements Serializable{

    private int cid;
    private String cName;
    private Set students=new HashSet();
    public Course() {
    }
    @Id
    @GenericGenerator(name="generator",strategy="native")
    @GeneratedValue(generator="generator")
    public int getCid() {
        return cid;
    }
    public void setStudents(Set students) {
        this.students = students;
    }
    public void setCid(int cid) {
        this.cid = cid;
    }
    public String getcName() {
        return cName;
    }
    public void setcName(String cName) {
        this.cName = cName;
    }
    @ManyToMany(cascade={CascadeType.ALL},fetch=FetchType.LAZY ,mappedBy="courses") 
    public Set getStudents() {
        return students;
    }
}