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
框架相关
,
例如
,Hibernate
可以指定
uuid
等主键生成方式
.
示例
:
@Id
@GeneratedValues(strategy=StrategyType.SEQUENCE)
public int getPk() {
return pk;
}
5
、
@Basic(fetch=FetchType,optional=true)
可选
@Basic
表示一个简单的属性到数据库表的字段的映射
,
对于没有任何标注的
getXxxx()
方法
,
默认即为
@Basic
fetch:
表示该属性的读取策略
,
有
EAGER
和
LAZY
两种
,
分别表示主支抓取和延迟加载
,
默认为
EAGER.
optional:
表示该属性是否允许为
null,
默认为
true
示例
:
@Basic(optional=false)
public String getAddress()
{
return address;
}
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
字段类型
,
该属性非常有用
.
示例
:
@Column(name="BIRTH",nullable="false",columnDefinition="DATE")
public String getBithday()
{
return birthday;
}
7
、
@Transient
可选
@Transient
表示该属性并非一个到数据库表的字段的映射
,ORM
框架将忽略该属性
.
如果一个属性并非数据库表的字段映射
,
就务必将其标示为
@Transient,
否则
,ORM
框架默认其注解为
@Basic
示例
:
//
根据
birth
计算出
age
属性
@Transient
public int getAge() {
return getYear(new Date()) -
getYear(birth);
}
8
、
@ManyToOne(fetch=FetchType,cascade=CascadeType)
可选
@ManyToOne
表示一个多对一的映射
,
该注解标注的属性通常是数据库表的外键
optional:
是否允许该字段为
null,
该属性应该根据数据库表的外键约束来确定
,
默认为
true
fetch:
表示抓取策略
,
默认为
FetchType.EAGER
cascade:
表示默认的级联操作策略
,
可以指定为
ALL,PERSIST,MERGE,REFRESH
和
REMOVE
中的若干组合
,
默认为无级联操作
targetEntity:
表示该属性关联的实体类型
.
该属性通常不必指定
,ORM
框架根据属性类型自动判断
targetEntity.
示例
:
//
订单
Order
和用户
User
是一个
ManyToOne
的关系
//
在
Order
类中定义
@ManyToOne()
@JoinColumn(name="USER")
public User getUser()
{
return user;
}
9
、
@JoinColumn
可选
@JoinColumn
和
@Column
类似
,
介量描述的不是一个简单字段
,
而一一个关联字段
,
例如
.
描述一个
@ManyToOne
的字段
.
name:
该字段的名称
.
由于
@JoinColumn
描述的是一个关联字段
,
如
ManyToOne,
则默认的名称由其关联的实体决定
.
例如
,
实体
Order
有一个
user
属性来关联实体
User,
则
Order
的
user
属性为一个外键
,
其默认的名称为实体
User
的名称
+
下划线
+
实体
User
的主键名称
示例
:
见
@ManyToOne
10
、
@OneToMany(fetch=FetchType,cascade=CascadeType)
可选
@OneToMany
描述一个一对多的关联
,
该属性应该为集体类型
,
在数据库中并没有实际字段
.
fetch:
表示抓取策略
,
默认为
FetchType.LAZY,
因为关联的多个对象通常不必从数据库预先读取到内存
cascade:
表示级联操作策略
,
对于
OneToMany
类型的关联非常重要
,
通常该实体更新或删除时
,
其关联的实体也应当被更新或删除
例如
:
实体
User
和
Order
是
OneToMany
的关系
,
则实体
User
被删除时
,
其关联的实体
Order
也应该被全部删除
示例
:
@OneTyMany(cascade=ALL)
public List getOrders()
{
return orders;
}
11
、
@OneToOne(fetch=FetchType,cascade=CascadeType)
可选
@OneToOne
描述一个一对一的关联
fetch:
表示抓取策略
,
默认为
FetchType.LAZY
cascade:
表示级联操作策略
示例
:
@OneToOne(fetch=FetchType.LAZY)
public Blog getBlog()
{
return blog;
}
12
、
@ManyToMany
可选
@ManyToMany
描述一个多对多的关联
.
多对多关联上是两个一对多关联
,
但是在
ManyToMany
描述中
,
中间表是由
ORM
框架自动处理
targetEntity:
表示多对多关联的另一个实体类的全名
,
例如
:package.Book.class
mappedBy:
表示多对多关联的另一个实体类的对应集合属性名称
示例
:
User
实体表示用户
,Book
实体表示书籍
,
为了描述用户收藏的书籍
,
可以在
User
和
Book
之间建立
ManyToMany
关联
@Entity
public class User {
private List
books;
@ManyToMany(targetEntity=package.Book.class)
public List getBooks()
{
return books;
}
public void setBooks(List
books) {
this.books=books;
}
}
@Entity
public class Book {
private List
users;
@ManyToMany(targetEntity=package.Users.class, mappedBy="books")
public List getUsers()
{
return users;
}
public void setUsers(List
users) {
this.users=users;
}
}
两个实体间相互关联的属性必须标记为
@ManyToMany,
并相互指定
targetEntity
属性
,
需要注意的是
,
有且只有一个实体的
@ManyToMany
注解需要指定
mappedBy
属性
,
指向
targetEntity
的集合属性名称
利用
ORM
工具自动生成的表除了
User
和
Book
表外
,
还自动生成了一个
User_Book
表
,
用于实现多对多关联
13
、
@MappedSuperclass
可选
@MappedSuperclass
可以将超类的
JPA
注解传递给子类
,
使子类能够继承超类的
JPA
注解
示例
:
@MappedSuperclass
public class Employee()
{
....
}
@Entity
public class Engineer extends
Employee {
.....
}
@Entity
public class Manager extends
Employee {
.....
}
14
、
@Embedded
可选
@Embedded
将几个字段组合成一个类
,
并作为整个
Entity
的一个属性
.
例如
User
包括
id,name,city,street,zip
属性
.
我们希望
city,street,zip
属性映射为
Address
对象
.
这样
,User
对象将具有
id,name
和
address
这三个属性
.
Address
对象必须定义为
@Embededable
示例
:
@Embeddable
public class Address
{city,street,zip}
@Entity
public class User {
@Embedded
public Address getAddress()
{
..........
}
}
Hibernate
验证注解
注解
适用类型
说明
示例
@Pattern
String
通过正则表达式来验证字符串
@attern(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)
以上每个注解都可能性有一个
message
属性,用于在验证失败后向用户返回的消息,还可以三个属性上使用多个注解
分享到:
相关推荐
详细的JPA注解总结大全 ,,,,,,,
java程序使用JPA注解详解.doc
JPA全称Java Persistence API.JPA通过JDK 5.0注解或XML描述对象-关系表的映射关系,并将运行期的实体对象持久化到数据库中。 JPA支持XML和JDK5.0注解两种元数据的形式。 JPA的总体思想和现有Hibernate、TopLink、...
JPA注解.doc JPA注解.doc JPA注解.doc JPA注解.doc JPA注解.doc JPA注解.doc JPA注解.doc JPA注解.doc JPA注解.doc JPA注解.doc JPA注解.doc JPA注解.doc JPA注解.doc JPA注解.doc JPA注解.doc JPA注解.doc JPA注解....
JPA全称Java Persistence API.JPA通过JDK 5.0注解或XML描述对象-关系表的映射关系,并将运行期的实体对象持久化到数据库中。 JPA支持XML和JDK5.0注解两种元数据的形式。 JPA的总体思想和现有Hibernate、TopLink、...
java程序使用JPA注解详解 JPA注解详解 java 程序使用 JPA注解 详解
使用springMVC结合JPA 采用注解开发框架搭建 有简单的登录 以及spring 拦截器的使用 配置代码都有详细注释 方便学习
JPA注解@Access实例 test-jpa
Hibernate+JPA注解教程.docHibernate+JPA注解教程.docHibernate+JPA注解教程.docHibernate+JPA注解教程.doc
java开发的JPA 批注总结参考资料,内容非常详细,非常丰富。
Hibernate之JPA注解
本文档简单描述了注解实现联合主键类的生成
Hibernate开发讲义JPA注解.ppt
(JPA) .著.化了 EJB 持.性并提供了一..象.系映射方法,.方法使您可以采用.明方式定.如何通 .一种.准的可移植方式(在 Java EE 5 .用服.器.部以及 Java .准版 (Java SE) 5 .用程序中的 EJB 容器外部均可使用). Java...
JPA注解创建数据库表 和hibernate.cfg.xml 建表
java程序使用JPA注解详解.zip java程序使用JPA注解详解.zip java程序使用JPA注解详解.zip java程序使用JPA注解详解.zip java程序使用JPA注解详解.zip
Hibernate开发讲义JPA注解学习.ppt
JPA注解帮助文档
JPA注解 详解 1、@Entity(name="EntityName") 必须,name为可选,对应数据库中一的个表 2、@Table(name="",catalog="",schema="") 可选,通常和@Entity配合使用,只能标注在实体的class定义处,表示实体对应的数据库表...
Hibernate5.1.fianl整合JPA注解方式异常:persistence.Table.indexes()[Ljavax/persistence/Index;