JPA & Hibernate 注解

类外部的注释

@Entity

每个持久化 PO 类都是一个实体 Bean ，通过在类的定义中使用

可选

例：@Entity(name=“”) name可选

@Table

注解为 Board 指定对应数据库表、目录和 schema 的名字。

例：@Table(name="",catalog="",schema=“”)，均可选

@Cache 注解为 Board 设置缓存策略，

Hibernate 提供以下几种缓存策略。

 CacheConcurrencyStrategy.NONE :不使用缓存。

 CacheConcurrencyStrategy.READ_ONLY :只读模式，在此模式下，如果对数据进行 更新操作，会有异常。

 CacheConcurrencyStrategy.READ_WRITE :读写模式在更新缓存的时候会对缓存里 面的数据加锁，其他事务如果去取相应的缓存数据，发现被锁了，直接就去数据库 查询。

 CacheConcurrencyStrategy.NONSTRICT_READ_WRITE :不严格的读写模式则不会 对缓存数据加锁。

 CacheConcurrencyStrategy.TRANSACTIONAL :事务模式指缓存支持事务，当事务 回滚时，缓存也能回滚，只支持 JTA 环境。

例：@Cache(usage = CacheConcurrencyStrategy.READ_WRITE)

@Inheritance

注解来指定 PO 映射继承关系，

Hibernate 共提供三种方式:每个类一张表( InheritanceType.TABLE_PER_CLASS )、连接的子类 InheritanceType.JOINED ，每个类层次结构一张表( InheritanceType .SINGLE_ TABLE )。

@DiscriminatorColumn 定义了辨别符列。

例：@DiscriminatorColumn(name = "post_type", discriminatorType = DiscriminatorType.STRING)

@DiscriminatorValue 对于继承层次结构中的每个类， 注解指定了用来辨别该类的值。

辨别符列名字默认为 DTYPE ，其默认值为实体名，类型为 DiscriminatorType.STRING 。

类内部的注释

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

@GenerateValue 注解定 义的主键生成策略

可选

strategy：表示主键生成策略，有AUTO，INDENTITY，SEQUENCE 和 TABLE 4种，分别表示让ORM框架自动选择，根据数据库的 Identity 字段生成，根据数据库表的 Sequence 字段生成，以有根据一个额外的表生成主键，默认为 AUTO。

generator:表示主键生成器的名称，这个属性通常和ORM框架相关，例如，Hibernate可以指定uuid等主键生成方式.

例：@GeneratedValue(strategy=GenerationType,generator=””)

@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字段类型，该属性非常有用。

例：@Column(name = "post_title")

@Basic(fetch=FetchType,optional=true)

可选

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

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

optional：表示该属性是否允许为null，默认为true。

@Transient

可选

@Transient表示 该属性并非一个到数据库表的字段的映射，ORM框架将忽略该属性。

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

 @OneToOne(fetch=FetchType,cascade=CascadeType)

可选

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

fetch：表示抓取策略，默认为FetchType.LAZY

cascade：表示级联操作策略

@ManyToOne(fetch=FetchType,cascade=CascadeType)

可选

@ManyToOne表示一个多对一的映射,该注解标注的属性通常是 数据库表的外键

optional：是否允许该字段为null，该属性应该根据数据库表的外键约束来确定，默认为true

fetch：表示抓取策略，默认为FetchType.EAGER

cascade：表示默认的 级联操作策略，可以指定为ALL，PERSIST，MERGE，REFRESH和REMOVE中的若干组合，默认为无级联操作

targetEntity：表示该属性关联的实体类型。该属性通常不必指定，ORM框架根据属性类型自动判断targetEntity。

@OneToMany

描述一个一对多的关联,该属性应该为集体类型,在数据库中并没有实际字段。

可选

fetch：表示抓取策略,默认为FetchType.LAZY,因为关联的多个对象通常不必从数据库预先读取到内存

cascade：表示级联操作策略,对于OneToMany类型的关联非常重要,通常该实体更新或删除时,其关联的实体也应当被更新或删除

例如：实体User和Order是OneToMany的关系，则实体User被删除时，其关联的实体Order也应该被全部删除

@OneToMany(fetch=FetchType,cascade=CascadeType)

@ManyToMany

@ManyToMany

描述一个多对多的关联.多对多关联上是两个一对多关联,但是在ManyToMany描述中,中间表是由ORM框架自动处理

可选

targetEntity:表示多对多关联的另一个实体类的全名,例如:package.Book.class

mappedBy:表示多对多关联的另一个实体类的对应集合属性名称

两个实体间相互关联的属性必须标记为@ManyToMany,并相互指定targetEntity属性,

需要注意的是,有且只有一个实体的@ManyToMany注解需要指定mappedBy属性,指向targetEntity的集合属性名称

利用ORM工具自动生成的表除了User和Book表外,还自动生成了一个User_Book表,用于实现多对多关联

@JoinColumn

可选

@JoinColumn和@Column类似,介量描述的不是一个简单字段,而一一个 关联字段,例如.描述一个@ManyToOne的字段.

name:该字段的名称.由于@JoinColumn描述的是一个关联字段,如ManyToOne,则默认的名称由其关联的实体决定.

例如,实体Order有一个user属性来关联实体User,则Order的user属性为一个外键,

其默认的名称为实体User的名称+下划线+实体User的主键名称

@JoinTable(name = “student_teacher”, inverseJoinColumns = @JoinColumn(name = “tid”), joinColumns = @JoinColumn(name = “sid”))

可选

由第三张表来维护两张表的关系

name：是关系表的名字

joinColumns：自己这一端的主键

inverseJoinColumns：对方的主键

@MappedSuperclass

可选

@MappedSuperclass可以将超类的JPA注解传递给子类,使子类能够继承超类的JPA注解

@Embedded

@Embedded将几个字段组合成一个类,并作为整个Entity的一个属性.

例如User包括id,name,city,street,zip属性.

我们希望city,street,zip属性映射为Address对象.这样,User对象将具有id,name和address这三个属性.

Address对象必须定义为@Embededable

验证注解

@Pattern

String

通过正则表达式来验证字符串

@Pattern(regex=”[a-z]{6}”)

@Length

String

验证字符串的长度

@length(min=3,max=20)

@Email

String

验证一个Email地址是否有效

@email

@Range

Long

验证一个整型是否在有效的范围内

@Range(min=0,max=100)

@Min

Long

验证一个整型必须不小于指定值

@Min(value=10)

@Max

Long

验证一个整型必须不大于指定值

@Max(value=20)

@Size

集合或数组

集合或数组的大小是否在指定范围内

@Size(min=1,max=255)

原文链接：http://www.cnblogs.com/luoxiaolei/p/4272494.html