这次彻底搞懂 Hibernate 映射

（待更新）
参考自JPA 2.1 http://docs.jboss.org/hibernate/jpa/2.1/api/

类级标注

@Entity(name = "xxx") // 标注实体（可持久化对象）
// name (String) 实体名，默认是类名，这个名字用于查询时引用实体。


@Table(name = "xxx", schema = "xxx") // 标注实体对应的主表（是的还可以有二级表（们））
// name (String) 表名，默认是类名。
// schema (String) 表所属的模式名，默认是用户的默认模式名。
// catalog indexes uniqueConstraints 这仨属性不懂

## 属性标注

@Column(name = "xxx") // 标注列
// name (String) 列名，不写默认是字段名。
// unique (boolean) 是否唯一，默认是false。
// nullable (boolean) 是否可为空，默认是true。
// insertable (boolean) 是否可插入，不可插入就是不能写在insert语句里而是由数据库处理，默认是true。
// updatable (boolean) 是否可更改，不可更改就是不能写在update语句里而是由数据库处理，默认是true。
// columnDefinition table length precision scale 都不懂

## 主键标注

@Id // 标注主键，如果没有@Column标注，则字段名即为主键列名。


@GeneratedValue // 标注主键的生成策略
// strategy (GenerationType) 数据库生成主键的策略类型，默认是AUTO。
//     AUTO 表示由数据库决定
//     IDENTITY 表示数据库是标识列生成主键的（比如MySQL）
//     SEQUENCE 表示数据库是用序列生成主键的（比如Oracle）
//     TABLE 表示数据库是用表生成主键的
// generator (String) 由SequenceGenerator或TableGenerator标注的生成器名，默认是数据库提供的生成器。


@SequenceGenerator(name="xxx", sequenceName="xxx") // 标注序列生成器
// name (String) 生成器名，必须要有且唯一，用于引用生成器。
// sequenceName (String) 数据库中用来生成主键的序列名，默认是数据库中定义好的。
// catalog schema initialValue allocationSize 不懂


@TableGenerator(name="xxx", table="xxx") // 标注表生成器
// name (String) 生成器名，必须要有且唯一，用于引用生成器。
// table (String) 数据库中用来存放主键的表名，默认是数据库中定义好的。
// catalog ... 还有好多属性都不懂

## 关系标注

@OneToOne // 标注一对一关系（定义一种单向的与另一个实体关联的关系，不必在目标实体中标注，可以根据引用的对象类型推测出来；
          // 如果这种关系是双向的，则必须在目标实体中用OneToOne的mappedBy属性声明（owing-side）实体的字段名）
// targetEntity (Class) 目标实体的类，默认是字段的类
// cascade (CascadeType[]) 级联类型组，默认是空
//     ALL
//     DETACH
//     MERGE
//     PERSIST
//     REFRESH
//     REMOVE
// fetch (FetchType) 抓取类型，默认是EAGER
//     EAGER
//     LAZY
// optional (boolean) 是否可选，默认是true。
// mappedBy (String) 拥有这个关系的实体的字段名。
// orphanRemoval 不懂

举例 →

// 1. 用外键关联的一对一关系
// Customer.java
@OneToOne(optional = false)
@JoinColumn(name = "CUSTREC_ID", unique = true, nullable = false, updatable = false)
public CustomerRecord getCustomerRecord() { return customerRecord; }

// CustomerRecord.java
@OneToOne(optional = false, mappedBy="customerRecord")
public Customer getCustomer() { return customer; }


// 2. 主键共享的一对一关系
// Employee.java
@Entity
public class Employee {
    @Id
    Integer id;
    
    @OneToOne
    @MapsId
    EmployeeInfo info;
    ...
}

// EmployeeInfo.java
@Entity
public class EmloyeeInfo {
    @Id
    Integer id;
    ...
}


// 3. 用嵌入类关联的一对一关系（不懂，先略过）

举例结束

@OneToMany // 标注一对多关系（如果集合用范型声明了元素类型，则不需要在目标实体）
// 属性同OneToOne，除了没有optional，fetch的默认是LAZY。

举例 →

// 1. 使用了范型的一对多关系
// Customer.java
@OneToMany(cascade = ALL, mappedBy = "customer")
public Set<Order> getOrders() { return orders; }

// Order.java
@ManyToOne
@JoinColumn(name = "CUST_ID", nullable = false)
public Customer getCustomer() { return customer; }


// 2. 没有使用范型的一对多关系
// Customer.java
@OneToMany(targetEntity = com.duan.Order.class, cascade = ALL, mappedBy = "customer")
public Set getOrders() { return orders; }

// Order.java
@ManyToOne
@JoinColumn(name = "CUST_ID", nullable = false)
public Customer getCustomer() { return customer; }


// 3. 用外键关联的单向一对多关系
// Customer.java
@OneToMany(orphanRemoval = true)
@JoinColumn(name = "CUST_ID") // join column is in table for Order
public Set<Order> getOrders() { return orders; }

举例结束

@ManyToOne // 标注多对一关系（定义一种单向关系；如果是双向，则必须在一方的OneToMany中注明mappedBy属性）
// 属性同OneToOne，除了没有mappedBy和orphanRemoval。

举例 →

// 1. 
@ManyToOne(optional = false)
@JoinColumn(name = "CUST_ID", nullable = false, updatable = false)
public Customer getCustomer() { return customer; }


// 2. 嵌入类，不懂，略过

举例结束

@ManyToMany // 标注多对多关系

@JoinColumn // 声明实体关系中用来连接的列
// name (String)