转：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=GenerationTypegenerator="")
可选
strategy:表现主键生成策略有AUTOINDENTITYSEQUENCE和TABLE4种分别表现让ORM框架自动选择
根据数据库的Identity字段生成根据数据库表的Sequence字段生成以有根据一个额外的表生成主键默认为AUTO
generator:表现主键生成器的名称这个属性通常和ORM框架相关例如Hibernate可以指定uuid等主键生成方式.
示例:
@Id
@GeneratedValues(strategy=StrategyType.SEQUENCE)
publicintgetPk(){
returnpk;
}
5、@Basic(fetch=FetchTypeoptional=true)
可选
@Basic表现一个简单的属性到数据库表的字段的映射对于没有任何标注的getXxxx()方法默认即为@Basic
fetch:表现该属性的读取策略有EAGER和LAZY两种分别表现主支抓取和延迟加载默认为EAGER.
optional:表现该属性是否允许为null默认为true
示例:
@Basic(optional=false)
publicStringgetAddress(){
returnaddress;
}
6、@Column
可选
@Column描述了数据库表中该字段的详细定义这对于根据JPA注解生成数据库表结构的工具非常有作用.
name:表现数据库表中该字段的名称默认情形属性名称一致
nullable:表现该字段是否允许为null默认为true
unique:表现该字段是否是唯一标识默认为false
length:表现该字段的大小仅对String类型的字段有效
insertable:表现在ORM框架执行插入操作时该字段是否应出现INSETRT语句中默认为true
updateable:表现在ORM框架执行更新操作时该字段是否应该出现在UPDATE语句中默认为true.对于一经创建就不可以更改的字段该属性非常有用如对于birthday字段.
columnDefinition:表现该字段在数据库中的实际类型.通常ORM框架可以根据属性类型自动判断数据库中字段的类型但是对于Date类型仍无法确定数据库中字段类型究竟是DATETIME还是TIMESTAMP.此外String的默认映射类型为VARCHAR如果要将String类型映射到特定数据库的BLOB或TEXT字段类型该属性非常有用.
示例:
@Column(name="BIRTH"nullable="false"columnDefinition="DATE")
publicStringgetBithday(){
returnbirthday;
}
7、@Transient
可选
@Transient表现该属性并非一个到数据库表的字段的映射ORM框架将忽略该属性.
如果一个属性并非数据库表的字段映射就务必将其标示为@Transient否则ORM框架默认其注解为@Basic
示例:
//根据birth计算出age属性
@Transient
publicintgetAge(){
returngetYear(newDate())-getYear(birth);
}
8、@ManyToOne(fetch=FetchTypecascade=CascadeType)
可选
@ManyToOne表现一个多对一的映射该注解标注的属性通常是数据库表的外键
optional:是否允许该字段为null该属性应该根据数据库表的外键约束来确定默认为true
fetch:表现抓取策略默认为FetchType.EAGER
cascade:表现默认的级联操作策略可以指定为ALLPERSISTMERGEREFRESH和REMOVE中的若干组合默认为无级联操作
targetEntity:表现该属性关联的实体类型.该属性通常不必指定ORM框架根据属性类型自动判断targetEntity.
示例:
//订单Order和用户User是一个ManyToOne的关系
//在Order类中定义
@ManyToOne()
@JoinColumn(name="USER")
publicUsergetUser(){
returnuser;
}
9、@JoinColumn
可选
@JoinColumn和@Column类似介量描述的不是一个简单字段而一一个关联字段例如.描述一个@ManyToOne的字段.
name:该字段的名称.由于@JoinColumn描述的是一个关联字段如ManyToOne则默认的名称由其关联的实体决定.
例如实体Order有一个user属性来关联实体User则Order的user属性为一个外键
其默认的名称为实体User的名称+下划线+实体User的主键名称
示例:
见@ManyToOne
10、@OneToMany(fetch=FetchTypecascade=CascadeType)
可选
@OneToMany描述一个一对多的关联该属性应该为集体类型在数据库中并没有实际字段.
fetch:表现抓取策略默认为FetchType.LAZY因为关联的多个对象通常不必从数据库预先读取到内存
cascade:表现级联操作策略对于OneToMany类型的关联非常重要通常该实体更新或删除时其关联的实体也应当被更新或删除
例如:实体User和Order是OneToMany的关系则实体User被删除时其关联的实体Order也应该被全部删除
示例:
@OneTyMany(cascade=ALL)
publicListgetOrders(){
returnorders;
}
11、@OneToOne(fetch=FetchTypecascade=CascadeType)
可选
@OneToOne描述一个一对一的关联
fetch:表现抓取策略默认为FetchType.LAZY
cascade:表现级联操作策略
示例:
@OneToOne(fetch=FetchType.LAZY)
publicBloggetBlog(){
returnblog;
}
12、@ManyToMany
可选
@ManyToMany描述一个多对多的关联.多对多关联上是两个一对多关联但是在ManyToMany描述中中间表是由ORM框架自动处理
targetEntity:表现多对多关联的另一个实体类的全名例如:package.Book.class
mappedBy:表现多对多关联的另一个实体类的对应集合属性名称
示例:
User实体表现用户Book实体表现书籍为了描述用户收藏的书籍可以在User和Book之间构建ManyToMany关联
@Entity
publicclassUser{
privateListbooks;
@ManyToMany(targetEntity=package.Book.class)
publicListgetBooks(){
returnbooks;
}
publicvoidsetBooks(Listbooks){
this.books=books;
}
}
@Entity
publicclassBook{
privateListusers;
@ManyToMany(targetEntity=package.Users.classmappedBy="books")
publicListgetUsers(){
returnusers;
}
publicvoidsetUsers(Listusers){
this.users=users;
}
}
两个实体间相互关联的属性必须标记为@ManyToMany并相互指定targetEntity属性
需要注重的是有且只有一个实体的@ManyToMany注解需要指定mappedBy属性指向targetEntity的集合属性名称
利用ORM工具自动生成的表除了User和Book表外还自动生成了一个User_Book表用于实现多对多关联
13、@MappedSuperclass
可选
@MappedSuperclass可以将超类的JPA注解传递给子类使子类能够继承超类的JPA注解
示例:
@MappedSuperclass
publicclassEmployee(){
....
}
@Entity
publicclassEngineerextendsEmployee{
.....
}
@Entity
publicclassManagerextendsEmployee{
.....
}
14、@Embedded
可选
@Embedded将几个字段组合成一个类并作为整个Entity的一个属性.
例如User包括idnamecitystreetzip属性.
我们希望citystreetzip属性映射为Address对象.这样User对象将具有idname和address这三个属性.
Address对象必须定义为@Embededable
示例:
@Embeddable
publicclassAddress{citystreetzip}
@Entity
publicclassUser{
@Embedded
publicAddressgetAddress(){
..........
}
}
Hibernate验证注解
注解
适用类型
说明
示例
@Pattern
String
通过正则表达式来验证字符串
@attern(regex=”[a-z]{6}”)
@Length
String
验证字符串的长度
@length(min=3max=20)
String
验证一个Email地址是否有效
@Range
Long
验证一个整型是否在有效的范畴内
@Range(min=0max=100)
@Min
Long
验证一个整型必须不小于指定值
@Min(value=10)
@Max
Long
验证一个整型必须不大于指定值
@Max(value=20)
@Size
集合或数组
集合或数组的大小是否在指定范畴内
@Size(min=1max=255)
以上每个注解都可能性有一个message属性，用于在验证失败后向用户返回的消息，还可以三个属性上使用多个注解
本文载自：http://haofanwen.info/group_thread/view/id-25415