JPA

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

JPA介绍

JPA的主要目标之一就是提供更加简单的编程模型：在JPA框架下创建实体和创建Java 类一样简单，没有任何的约束和限制，只需要使用 javax.persistence.Entity进行注释，JPA的框架和接口也都非常简单，没有太多特别的规则和设计模式的要求，开发者可以很容易地掌握。JPA基于非侵入式原则设计，因此可以很容易地和其它框架或者容器集成。

JPA、hibernate、Spring Data JPA的关系

• JPA是一套ORM规范，而hibernate是JPA的一个子集，也是JPA的实现。
• Spring Data JPA也是JPA的实现，底层使用了hibernate的技术实现。

JPA基本功能

JPA提供了下面功能那个

• ORM数据映射。
• JPA的API
• 查询语句JPQL

Spring Data JPA除了提供便捷的CRUD操作之外，它还提供了根据entity的内容去创建表结构的功能。

JPA和Mybatis优劣

这一段内容是我个人主观的想法，并不意味着是正确的

JPA
JPA是一个非常在意数据结构设置的ORM框架，所以使用起来会发现JPA提供了大量entity的注解，基本覆盖了各种使用场景。

但是和Mybatis相比JPA的复杂查询就显得比较繁琐。基础查询、以及设计时候就存在的多表关系的关联查询以外，
想去根据业务自己实现一些之前设计没有考虑的复杂关系查询时就显得非常麻烦。
所以这也要求在设计数据关系的时候尽可能的考虑更多的场景，以及保留足够的扩展空间。

Mybatis
和JPA相比，Mybatis显得就很简单的。因为所有查询都是基于SQL。并不存在将数据关系通过entity进行维护。
省去了繁琐的entity定义，显得整个数据定义轻松很多。但是这样要保证数据操作正确，查询效率就需要SQL编写者有一定SQL水平。

总结
所以个人的感觉JPA更倾向于在最开始就保证设计的可靠性，需要设计数据结构的开发者有较高的水平。
而Mybatis却比较轻设计，整个系统的可靠性被其中一个一个SQL语句共同来保证。这就要求参与SQL编写的开发者们有一定基础。

引入Spring Data JPA

在Spring Boot中引入Spring Data JPA非常简单，只需要添加其依赖starter-data-jpa即可

maven依赖

    <dependencies>
        <dependency>
            <groupId>mysql</groupId>
            <artifactId>mysql-connector-java</artifactId>
        </dependency>
        <dependency>
            <groupId>org.springframework.boot</groupId>
            <artifactId>spring-boot-starter-data-jpa</artifactId>
        </dependency>
    </dependencies>

基本参数配置

spring:
  application:
    name: jpa
  datasource:
    url: jdbc:mysql://localhost:3306/test?charactorEncoding=utf-8&useSSL=false
    username: root
    password: root
    driver-class-name: com.mysql.jdbc.Driver
  jpa:
    hibernate:
      use-new-id-generator-mappings: true
      ddl-auto: none
      naming:
        physical-strategy: org.springframework.boot.orm.jpa.hibernate.SpringPhysicalNamingStrategy
    properties: 
      hibernate:
        dialect: org.hibernate.dialect.MySQL5InnoDBDialect
        hbm2ddl:
                # create 每次加载hibernate时都会删除上一次的生成的表，
                # 然后根据你的model类再重新来生成新表
                # create-drop 每次加载hibernate时根据model类生成表
                # 但是sessionFactory一关闭,表就自动删除
                # update 第一次加载hibernate时根据model类会自动建立起表的结构
                # 以后加载hibernate时根据model类自动更新表结构
                # validate 每次加载hibernate时，验证创建数据库表结构
                # 只会和数据库中的表进行比较，不会创建新表，但是会插入新值
          auto: update
          # 使用create-drop存在问题，jpa会执行一些外键SQL但是此时表不存在而报错
          # auto: create-drop
    show-sql: true
server:
  port: 8000

连接配置
JPA在和数据库进行连接的时候会根据spring.jpa.properties.hibernate.auto配置执行不同的连接策略。
其包含的策略

使用JPA定义表结构

基础的操作

要想使用过JPA创建一个表只需要配置@entity和@Table注解，
当然单独使用@entity的时候系统也会创建表。但是一般我们习惯用@entity标注其为实体。
@Table来标志其对应表映射内容。

@Data
@Entity
@Table(name = "cascade_user_tag")
public class UserTag {

    @Id
    @GeneratedValue
    private Long id;
    
    private String tagName;
}

上面的内容我们会创建一个cascade_user_tag的表，其中id为主键，存在列tag_name

entity表的配置

JPA提供了对数据表的参数配置，除了普通的表参数定义，JPA使用@Inheritance提供了继承关系的表定义。

@Inheritance
@Inheritance内部参数为InheritanceType类型，其类型主要有下面几种

SINGLE_TABLE

TABLE_PER_CLASS、JOINED这两种有兴趣可以看下我项目中的例子，这里主要讲下SINGLE_TABLE。
使用SINGLE_TABLE的时候可以指定DiscriminatorColumn可以指定一个列用来标识不同实体的类别。
比如下面的例子，使用table_type作为标记不同实体的字段，其中父类使用base标记子类使用son进行标记。

@Data
@Entity
@Table(name = "ext_base_single_bean")
/**继承策略,
 * SINGLE_TABLE表示继承关系的实体保存在一个表；
 * JOINED表示每个实体子类部分保存在各自的表；
 * TABLE_PER_CLASS表示每个实体类保存在各自的表*/
@Inheritance(strategy = InheritanceType.SINGLE_TABLE)
/**标识字段定义*/
@DiscriminatorColumn(name="table_type",
        discriminatorType = DiscriminatorType.STRING)
@DiscriminatorOptions(force=true)
/**该类的标识*/
@DiscriminatorValue("base")
public class BaseSingleBean {
    @Id
    @GeneratedValue(strategy = GenerationType.AUTO)
    private Long id;

    @Basic
    private BigDecimal balance;

}

@Data
@Entity
@DiscriminatorValue("son")
public class SonSingleBean extends BaseSingleBean {

    @Basic
    private String sonValue;
}

entity列的配置

主键列

定义主键使用下面注解

@Id
@GeneratedValue(strategy = GenerationType.AUTO)

其中@GeneratedValue用来标识使用何种主键创建器。主要提供了下面几种

TABLE

IDENTITY和SEQUENCE都是使用自增或者类似自增的方式进行主键创建这个这里不谈，介绍下TABLE

@Data
@Entity
@Table(name = "base_key_table_bean")
public class KeyTableBean {

    /**
     * 使用生产方式。GenerationType
     * GenerationType
     * TABLE：容器指定用底层的数据表确保唯一,主键的值每次都是从指定的表中查询来获得
     * SEQUENCE：使用数据库德SEQUENCE列保证唯一（Oracle数据库通过序列来生成唯一ID）
     * IDENTITY：使用数据库的IDENTITY列保证唯一
     * AUTO：由容器挑选一个合适的方式来保证唯一
     * NONE：容器不负责主键的生成，由程序来完成
     */
    @Id
    @GeneratedValue(strategy = GenerationType.TABLE,generator = "table_key")
    @TableGenerator(name = "table_key",// 主键生成策略的名称
            table = "key_my_gen",// 生成策略所持久化的表名
            pkColumnName = "key_name",// 在持久化表中，该主键生成策略所对应键值的名称
            valueColumnName = "key_value",// 在持久化表中，该主键当前所生成的值
            pkColumnValue = "TABLE_KEY",// 生产策略所对应的主键的值
            initialValue = 10,// 初始值
            allocationSize = 1)// 每次主键值增加的大小
    private Long id;

    private String value;
}

使用GenerationType.TABLE我们需要配合@TableGenerator。
上面的例子中，我们设置了主键生成器名称为table_key,主键表为key_my_gen,
指定了主键名称对应列key_name且名称被指定为TABLE_KEY，指定了主键值对应列key_value。

根据上面配置，我们执行以下测试，系统会在key_my_gen表中生产key_name值为TABLE_KEY，key_value为数据主键的内容。

    @Test
    public void add() {
        KeyTableBean bean = new KeyTableBean();
        bean.setValue("value");
        repository.save(bean);
    }

联合主键

有些时候我们所使用的主键不是一个单一的参数，可能是多个字段组成的一个主键。
面对这样的场景我们可以使用@IdClass这样的注解。它允许我们将一个类设置为主键

@Data
@Entity
@Table(name = "key_test_keys")
@IdClass(value = KeysBean.class)
public class TestKeys implements Serializable {
    @Id
    private long id;
    @Id
    private String keyId;
    
    private String value;
}

主键类。

@Data
public class KeysBean implements Serializable {

    private long id;

    private String keyId;
}

此时数据库中创建的key_test_keys表中就会出现两个字段都是主键

普通列

当然除了主键、JPA对列的更多的配置在@Column中。JPA为@Column提供了众多参数

配置列参数
下面的demo中是对列名称和参数长度进行配置的内容。

    @Column(name = "value",// 映射的列名
            unique = true,// 是否唯一
            nullable = false,// 是否允许为空
            length = 150,// 对于字符型列，length属性指定列的最大字符长度
            insertable = true,// 是否允许插入
            updatable = false)// 是否允许更新
    private String value;

    @Column(name = "null_value",// 映射的列名
            unique = false,// 是否唯一
            nullable = true,// 是否允许为空
            length = 150,// 对于字符型列，length属性指定列的最大字符长度
            insertable = false,// 是否允许插入
            updatable = false)// 是否允许更新
    private String nullValue;

指定属性非数据库列

JPA提供了@Transient基本操作来标识此字段在数据表中不存在。

    /**
     * 用来测试Transient
     */
    @Transient
    private String notInTable;

时间格式化

通过@Temporal我们可以实现Date的格式化设置。

@Temporal内部参数TemporalType提供了三种类型，分别对应三种数据结构

    @Temporal(TemporalType.TIMESTAMP)
    public Date getCreateTime() {
        return createTime;
    }

当然实际上JPA为了让数据设计的时候尽可呢的满足各种使用场景提供了各种注解。下面是目前常用的注解。
这里只介绍了一些基础实体定义的注解，关于多表关联的内容，会在后续找时间继续补充完成。

本篇文章涉及的源码下载地址：https://gitee.com/daifyutils/springboot-samples

jpa常用注解

都在 : javax.persistence.* 包下面

类数据注解

主键

多数据关联

多表映射(实际中并不常用)

其他注解

原文地址：Spring Boot 整合——JPA 数据模型定义(数据实体基础注解使用)