JPA & Hibernate 注解

1. @Entity(name=“EntityName”)

必须 ,name 为可选 , 对应数据库中一的个表

2. @Table(name="",catalog="",schema="")

可选 , 通常和 @Entity 配合使用 , 只能标注在实体的 class 定义处 , 表示实体对应的数据库表的信息

name: 可选 , 表示表的名称 . 默认地 , 表名和实体名称一致 , 只有在不一致的情况下才需要指定表名

catalog: 可选 , 表示 Catalog 名称 , 默认为 Catalog("").

schema: 可选 , 表示 Schema 名称 , 默认为 Schema("").

3. @id

必须

@id 定义了映射到数据库表的主键的属性 , 一个实体只能有一个属性被映射为主键 . 置于 getXxxx() 前 .

4. @GeneratedValue(strategy=GenerationType,generator="")

可选

strategy: 表示主键生成策略 , 有 AUTO,INDENTITY,SEQUENCE 和 TABLE 4 种 , 分别表示让 ORM 框架自动选择,

根据数据库的 Identity 字段生成 , 根据数据库表的 Sequence 字段生成 , 以有根据一个额外的表生成主键 , 默认为AUTO

generator: 表示主键生成器的名称 , 这个属性通常和 ORM 框架相关 

5. @Basic(fetch=FetchType,optional=true)

可选

@Basic 表示一个简单的属性到数据库表的字段的映射 , 对于没有任何标注的 getXxxx() 方法 , 默认即为 @Basic

fetch: 表示该属性的读取策略 , 有 EAGER 和 LAZY 两种 , 分别表示主支抓取和延迟加载 , 默认为 EAGER.

optional: 表示该属性是否允许为 null, 默认为 true

6. @Column

可选

@Column 描述了数据库表中该字段的详细定义 , 这对于根据 JPA 注解生成数据库表结构的工具非常有作用 .

name: 表示数据库表中该字段的名称 , 默认情形属性名称一致

nullable: 表示该字段是否允许为 null, 默认为 true

unique: 表示该字段是否是唯一标识 , 默认为 false

length: 表示该字段的大小 , 仅对 String 类型的字段有效

insertable: 表示在 ORM 框架执行插入操作时 , 该字段是否应出现 INSETRT 语句中 , 默认为 true

updateable: 表示在 ORM 框架执行更新操作时 , 该字段是否应该出现在 UPDATE 语句中 , 默认为 true. 对于一经创建就不可以更改的字段 , 该属性非常有用 , 如对于 birthday 字段 .

columnDefinition: 表示该字段在数据库中的实际类型 . 通常 ORM 框架可以根据属性类型自动判断数据库中字段的类型 , 但是对于 Date 类型仍无法确定数据库中字段类型究竟是 DATE,TIME 还是 TIMESTAMP. 此外 ,String 的默认映射类型为 VARCHAR, 如果要将 String 类型映射到特定数据库的 BLOB 或 TEXT 字段类型 , 该属性非常有用 .

7. @Transient

可选

@Transient 表示该属性并非一个到数据库表的字段的映射 ,ORM 框架将忽略该属性 .
如果一个属性并非数据库表的字段映射 , 就务必将其标示为 @Transient, 否则 ,ORM 框架默认其注解为 @Basic

8. @OneToOne(fetch=FetchType,cascade=CascadeType)

可选

@OneToOne 描述一个一对一的关联

fetch: 表示抓取策略 , 默认为 FetchType.LAZY

cascade: 表示级联操作策略：
casecade={CasecadeType.REFRESH}的含义是只是查询级联，它还有其他3个类型：
CascadeType.MERGE级联更新
CascadeType.PERSIST级联保存
CascadeType.REMOVE级联删除

optional=false定义关联类不一定要存在

• 一对一单向外键
  @OneToOne（cascade=CascadeType.ALL（指定级联关系））
  @JoinColumn（name=“pid”, unique=“true”)
  demo:

@OneToOne 用来表示类似于以上员工与地址之间的一对一的关系，在员工表中会有一个指向地址表主键的字段address_id，所以主控方（指能够主动改变关联关系的一方）一定是员工，因为，只要改变员工表的address_id就改变了员工与地址之间的关联关系，所以@JoinColumn要写在员工实体类Employee上，自然而然地，地址就是被控方了。
 
Employee.class
@OneToOne(cascade = CascadeType.ALL, fetch = FetchType.LAZY)
@JoinColumn(name = "address_id")
private Address address;
我们也可以不写@JoinColumn，Hibernate会自动在员工表生成关联字段，
字段默认的命名规则：被控方类名_被控方主键，如：address_id。

• 一对一双向外键：

主控方的配置同一对一单向外键

被控方.class:
@OneToOne（mappedBy="card"）（写在被控方的主控方引用上面，值是被控的属性的变量）

9. @ManyToOne/@OneToMany

多对一单向外键：

多方持有一方的引用
@ManyToOne（cascade={CascadeType.ALL}，fetch=FetchType.EAGER）
@JoinColumn（name=“cid（和一对多一样）”，referencedColumnName=“CID”）

@JoinColumn中的name为当前类的属性名，（多对一单向，有多方维护）所以，name为student中的cid，而ReferenceColumnName为引用表的列（多对一单向，所以为一方的引用列）即ClassRoom中的主键列

//员工-部门
@ManyToOne(cascade = CascadeType.ALL, fetch = FetchType.EAGER)
@JoinColumn(name = "department_id")
private Department department;

一对多单向外键：
一方持有多方的集合，一个班级有多个学生（一对多）
在集合上设置
@OneToMany（cascade={CascadeType.ALL}，fetch=FetchType.LAZY）
@JoinColumn（name=“cid”）（一方的主键）

一对多的时候，一的内部是个集合，为了减小数据库的压力，少加载数据所以用LAZZY加载，反之，多对一的时候每个多方只多加载一条数据，所以可以用EAGER加载

//员工-部门
@OneToMany(cascade = CascadeType.ALL, fetch = FetchType.EAGER)
@JoinColumn(name = "department_id")
private List<Employee> employees;

10. @ManyToMany

多对多单向外键
学生和教师构成多对多的关联关系

创建中间表

//学生.class

@ManyToMany
@JoinTable(
   name="teachers_students",
   joinColumns={@JoinColumn(name="sid")},
   inverseJoinColumns={JoinColumn(name="tid")}
)
private List<Teacher> teachers;

多对多双向外键

双方持有对方的集合对象，

//教师类
@ManyToMany(mappedBy="teachers")（将主控方交给学生类）

11. @Temporal

@Temporal(TemporalType.DATE) 得到 yyyy-MM-dd
@Temporal(TemporalType.TIME) 得到 HH:mm:ss
@Temporal(TemporalType.TIMESTAMP)得到 yyyy-MM-dd HH:mm:ss:SSS

12. @CreationTimestamp

使用该注解可以让Hibernate在插入时针对注解的属性对应的日期类型创建默认值。

13. @UpdateTimestamp

使用该注解可以让Hibernate在更新时时针对注解的属性对应的日期类型创建默认值。