JPA基础知识（一）：简介、基本注解

JPA基础知识（一）：简介、基本注解

一、简介

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

sun公司定义了JDBC接口，程序员可以通过接口来访问数据库，统一了java应用程序访问数据库的标准。

JPA统一了java应用程序使用各个ORM框架的方式。

二、JPA和Hibernate的关系

• JPA 是 hibernate 的一个抽象（就像JDBC和JDBC驱动的关系）

  • JPA 是规范：JPA 本质上就是一种 ORM 规范，不是ORM 框架 —— 因为 JPA 并未提供 ORM 实现，它只是制订了一些规范，提供了一些编程的 API 接口，但具体实现则由 ORM 厂商提供实现
  • Hibernate 是实现：Hibernate 除了作为 ORM 框架之外，它也是一种 JPA 实现
    从功能上来说， JPA 是 Hibernate 功能的一个子集

---

• JPA 包括 3方面的技术
  • ORM 映射元数据：主要是使用注解的方式来进行映射。
    JPA 支持 XML 和 JDK 5.0 注解两种元数据的形式，元数据描述对象和表之间的映射关系，框架据此将实体对象持久化到数据库表中。
  • JPA 的 API：用来操作实体对象，执行CRUD操作，框架在后台完成所有的事情，开发者从繁琐的 JDBC和 SQL代码中解脱出来。
  • 查询语言（JPQL）：这是持久化操作中很重要的一个方面，通过面向对象而非面向数据库的查询语言查询数据，避免程序和具体的 SQL 紧密耦合。

三、JPA 基本注解

JPA 基本注解：@Entity， @Table， @Id， @GeneratedValue，@Column， @Basic，@Transient， @Temporal， 用 table 来生成主键详解

1-1、@Entity

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

1-2、@Table

当实体类与其映射的数据库表名不同名时需要使用 @Table 标注说明，该标注与 @Entity 标注并列使用，置于实体类声明语句之前，可写于单独语句行，也可与声明语句同行。
@Table 标注的常用选项是 name，用于指明数据库的表名
@Table 标注还有一个两个选项 catalog 和 schema 用于设置表所属的数据库目录或模式，通常为数据库名。uniqueConstraints 选项用于设置约束条件，通常不须设置。

1-3、@Id

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

1-4、@GeneratedValue

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

• 在 javax.persistence.GenerationType 中定义了以下几种可供选择的策略：
  • IDENTITY：采用数据库 ID自增长的方式来自增主键字段，Oracle 不支持这种方式；
  • AUTO： JPA自动选择合适的策略，是默认选项；
  • SEQUENCE：通过序列产生主键，通过 @SequenceGenerator 注解指定序列名，MySql 不支持这种方式
  • TABLE：通过表产生主键，框架借由表模拟序列产生主键，使用该策略可以使应用更易于数据库移植。

1-5、@Basic

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

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

1-6、@Column

当 实体的属性与其映射的数据库表的列不同名时 需要使用@Column 标注说明，该属性通常置于实体的属性声明语句之前，还可与 @Id 标注一起使用。

• @Column 标注的常用属性是 name，用于设置映射数据库表的列名。此外，该标注还包含其它多个属性，如：unique 、nullable、length等。
• @Column 标注的 columnDefinition 属性: 表示该字段在数据库中的实际类型. 通常 ORM 框架可以根据属性类型自动判断数据库中字段的类型,但是对于Date类型仍无法确定数据库中字段类型究竟是DATE，TIME还是TIMESTAMP。此外，String的默认映射类型为VARCHAR, 如果要将 String 类型映射到特定数据库的 BLOB 或TEXT 字段类型.
• @Column 标注也可置于属性的getter方法之前

1-7、@Transient

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

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

1-8、@Temporal

在核心的 Java API 中并没有定义 Date 类型的精度(temporal precision). 而在数据库中,表示 Date 类型的数据有 DATE，TIME 和 TIMESTAMP 三种精度(即单纯的日期,时间,或者两者 兼备).在进行属性映射时可使用@Temporal注解来调整精度.