JPA基础知识及JPA经常使用注解

JPA

　　全称Java Persistence API，经过JDK 5.0注解或XML描述对象－关系表的映射关系，并将运行期的实体对象持久化到数据库中。

　　一、JPA和Hibernate的关系

　　简而言之

• JPA 是一个规范或者接口

• Hibernate 是 JPA 的一个实现

　　　　JPA与Hibernate的关系相似于JDBC和JDBC驱动的关系，是对生产力的一种解放。咱们不需定制符合供应商提供的API，只需符合规范便可保证它的迁移性。

　　　　JPA 是规范：JPA 本质上就是一种  ORM 规范，不是ORM 框架 —— 由于 JPA 并未提供 ORM 实现，它只是制订了一些规范，提供了一些编程的 API 接口，但具体实现则由 ORM 厂商提供实现

　　　　Hibernate 是实现，是一种ORM产品：Hibernate 除了做为 ORM 框架以外，它也是一种 JPA 实现

　　　　从功能上来讲， JPA 是 Hibernate 功能的一个子集

　　2、JPA 的供应商

    　　JPA 的目标之一是制定一个能够由不少供应商实现的 API，目前Hibernate 3.2+、TopLink 10.1+ 以及 OpenJPA 都提供了 JPA 的实现

　　　　Hibernate：JPA 的始做俑者就是 Hibernate 的做者。Hibernate 从 3.2 开始兼容 JPA

　　　　OpenJPA：OpenJPA  是 Apache 组织提供的开源项目

　　　　TopLink：TopLink 之前须要收费，现在开源了

　　JPA的出现有两个缘由：

　　　　其一，简化现有Java EE和Java SE应用的对象持久化的开发工做；

　　　　其二，Sun但愿整合对ORM技术，实现持久化领域的统一。

     三、JPA提供的技术：

　　　　1）ORM映射元数据：JPA支持XML和JDK 5.0注解两种元数据的形式，元数据描述对象和表之间的映射关系，框架据此将实体对象持久化到数据库表中；

　　　　2）JPA 的API：用来操做实体对象，执行CRUD操做，框架在后台替咱们完成全部的事情，开发者从繁琐的JDBC和SQL代码中解脱出来。

　　　　3）查询语言：经过面向对象而非面向数据库的查询语言查询数据，避免程序的SQL语句紧密耦合。

　　四、JPA基本注解

　　　　JPA 基本注解:@Entity, @Table, @Id, @GeneratedValue, @Column, @Basic，@Transient, @Temporal

　　　　1）@Entity

    　　　　　　@Entity 标注用于实体类声明语句以前，指出该Java 类为实体类，将映射到指定的数据库表。如声明一个实体类 Customer，它将映射到数据库中的 customer 表上。

　　　　2）@Table

　　　　　　当实体类与其映射的数据库表名不一样名时须要使用 @Table 标注说明，该标注与 @Entity 标注并列使用，置于实体类声明语句以前，可写于单独语句行，也可与声明语句同行。

　　　　　@Table 标注的经常使用选项是 name，用于指明数据库的表名

　　　　　　@Table标注还有一个两个选项 catalog 和 schema 用于设置表所属的数据库目录或模式，一般为数据库名。uniqueConstraints 选项用于设置约束条件，一般不须设置。

　　　　3）@Id

　　　　　　@Id 标注用于声明一个实体类的属性映射为数据库的主键列。该属性一般置于属性声明语句以前，可与声明语句同行，也可写在单独行上。

    　　　　@Id标注也可置于属性的getter方法以前。

　　　　4）@GeneratedValue

　　　　　　@GeneratedValue  用于标注主键的生成策略，经过 strategy 属性指定。默认状况下，JPA 自动选择一个最适合底层数据库的主键生成策略：SqlServer 对应 identity，

　　　　　　　　　　　　　　MySQL 对应 auto increment。在 javax.persistence.GenerationType 中定义了如下几种可供选择的策略：

　　　　　　　　IDENTITY：采用数据库 ID自增加的方式来自增主键字段，Oracle 不支持这种方式；

　　　　　　　　AUTO： JPA自动选择合适的策略，是默认选项；

　　　　　　　　SEQUENCE：经过序列产生主键，经过 @SequenceGenerator 注解指定序列名，MySql 不支持这种方式

　　　　　　　　TABLE：经过表产生主键，框架借由表模拟序列产生主键，使用该策略可使应用更易于数据库移植。

　　　　5）@Basic

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

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

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

　　　　6）@Column

　　　　　　当实体的属性与其映射的数据库表的列不一样名时须要使用@Column 标注说明，该属性一般置于实体的属性声明语句以前，还可与 @Id 标注一块儿使用。

　　　　　　@Column 标注的经常使用属性是 name，用于设置映射数据库表的列名。此外，该标注还包含其它多个属性，如：unique 、nullable、length等。

　　　　　　@Column 标注的 columnDefinition 属性: 表示该字段在数据库中的实际类型.一般 ORM 框架能够根据属性类型自动判断数据库中字段的类型,

　　　　　　　　可是对于Date类型仍没法肯定数据库中字段类型到底是DATE,TIME仍是TIMESTAMP.此外,String的默认映射类型为VARCHAR,

　　　　　　　　若是要将 String 类型映射到特定数据库的 BLOB 或TEXT 字段类型.

　　　　　　@Column标注也可置于属性的getter方法以前

　　　　7）@Transient

　　　　　　表示该属性并不是一个到数据库表的字段的映射,ORM框架将忽略该属性.

　　　　　　若是一个属性并不是数据库表的字段映射,就务必将其标示为@Transient,不然,ORM框架默认其注解为@Basic

　　　　8）@Temporal

　　　　　　在核心的 Java API 中并无定义 Date 类型的精度(temporal precision).  而在数据库中,表示 Date 类型的数据有 DATE, TIME, 和 TIMESTAMP 三种精度

　　　　　　(即单纯的日期,时间,或者二者 兼备).在进行属性映射时可以使用@Temporal注解来调整精度.

　　　　9）用 table 来生成主键详解

　　　　　　将当前主键的值单独保存到一个数据库的表中，主键的值每次都是从指定的表中查询来得到

　　　　　　这种方法生成主键的策略能够适用于任何数据库，没必要担忧不一样数据库不兼容形成的问题。

/**
 * 注解@Entity映射的表名和类名同样
 * 注解@Table：当实体类与其映射的数据库表名不一样名时使用。其中name，用于指明数据库的表名 
 */
@Table(name="JPA_CUTOMER")
@Entity
public class Customer {
	private Integer id;
	private String name;
	private String email;
	private int age;
	private Date createTime;
	private Date birth;
 
	public Customer() {}
 
//用 table 来生成主键详解（用的少）:
//将当前主键的值单独保存到一个数据库的表中，主键的值每次都是从指定的表中查询来得到
//这种方法生成主键的策略能够适用于任何数据库，没必要担忧不一样数据库不兼容形成的问题
/*	@TableGenerator(name="ID_GENERATOR", --name 属性表示该主键生成的名称，它被引用在@GeneratedValue中设置的generator 值中(即这两个名字要同样）
			table="jpa_id_generators",   --table 属性表示表生成策略所持久化的表名
			pkColumnName="PK_NAME",      --pkColumnName 属性的值表示在持久化表中，该主键生成策略所对应键值的名称
			pkColumnValue="CUSTOMER_ID", --pkColumnValue 属性的值表示在持久化表中，该生成策略所对应的主键（跟pkColumnName属性能够肯定惟一的一行，该行有不少列）
			valueColumnName="PK_VALUE",  --valueColumnName 属性的值表示在持久化表中，该主键当前所生成的值，它的值将会随着每次建立累加，（再加这个属性能肯定惟一的那个点）
			allocationSize=100)          --allocationSize 表示每次主键值增长的大小, 默认值为 50
	@GeneratedValue(strategy=GenerationType.TABLE,generator="ID_GENERATOR")*/
	@GeneratedValue(strategy=GenerationType.AUTO)
	@Id
	public Integer getId() {
		return id;
	}
	public void setId(Integer id) {
		this.id = id;
	}
 
	/**
	 * 注解@Column 当实体的属性与其映射的数据库表的列不一样名时须要使用
	 * nullable=false不能为空
	 */
	@Column(name="NAME",length=50,nullable=false)
	public String getName() {
		return name;
	}
	public void setName(String name) {
		this.name = name;
	}
 
	//若是 列名跟字段同样如列名是email，则能够不用写，相关加了@Basic，但字段的属性都是默认的
//	@Basic
	public String getEmail() {
		return email;
	}
	public void setEmail(String email) {
		this.email = email;
	}
 
	public int getAge() {
		return age;
	}
	public void setAge(int age) {
		this.age = age;
	}
 
	//---------------------------------------------------------------
	//注解@Temporal 调整时间精度 2018-11-11 10:11:11
	@Temporal(TemporalType.TIMESTAMP)
	public Date getCreateTime() {
		return createTime;
	}
	public void setCreateTime(Date createTime) {
		this.createTime = createTime;
	}
	
	//2018-11-11
	@Temporal(TemporalType.DATE)
	public Date getBirth() {
		return birth;
	}
	public void setBirth(Date birth) {
		this.birth = birth;
	}
 
	//工具方法. 不须要映射为数据表的一列. 若是没有加@Transient，则会出错，由于没有set方法
	@Transient
	public String getInfo(){
		return "name: " + name + ", email: " + email;
	}
 
}