Spring data jpa 的使用与详解（一）：框架整合及基本使用

1 什么是JPA

JPA全称Java Persistence API，能够经过注解或者XML描述【对象-关系表】之间的映射关系，并将实体对象持久化到数据库中。JPA的出现主要是为了简化持久层开发以及整合ORM技术，结束Hibernate、TopLink、JDO等ORM框架各自为营的局面。

JAP为咱们提供了ORM映射元数据,JPA的API,JPQL查询语言等,但JPA仅仅是一种规范，也就是说JPA仅仅定义了一些接口，而接口是须要实现才能工做的。因此底层须要某种实现，而Hibernate就是实现了JPA接口的ORM框架。

2 什么是Hibernate框架

Hibernate是Java中的对象关系映射解决方案。对象关系映射或ORM是将应用程序域模型对象映射到关系数据库表的编程技术。Hibernate是一个基于Java的ORM工具，它提供了一个框架，用于将应用程序域对象映射到关系数据库表。

Hibernate提供了Java Persistence API的参考实现，使其成为具备松散耦合优点的ORM工具的绝佳选择。

3 什么是Spring Data JPA

Spring Data是Spring Framework的一部分。Spring Data存储库抽象的目标是显著减小为各类持久性存储实现数据访问层所需的代码量。

Spring Data JPA不是JPA提供者。它是一个库/框架，它在咱们的JPA提供程序（如Hibernate）的顶部添加了一个额外的抽象层。

4 Hibernate和Spring Data JPA的关系

Hibernate是一个JPA实现，而Spring Data JPA是一个JPA数据访问抽象。Spring Data提供了GenericDao自定义实现的解决方案，它还能够经过方法名称约定表明您生成JPA查询。

Spring Data JPA不是一个实现或JPA提供者，它只是一个抽象，用于显著减小为各类持久性存储实现数据访问层所需的代码量。Spring Data JPA始终须要JPA提供程序，如Hibernate。

5 Spring data jpa概述

JPA Spring Data：致力于减小数据访问层（DAO）的开发量，开发者惟一要作的，就只是声明持久层的接口，其余都交给Spring Data JPA来完成。

框架怎么可能代替开发者实现业务逻辑呢？好比：当有一个 UserDao.findUserById() 这样一个方法声明，大体应该能判断出这是根据给定条件的 ID 查询出知足条件的 User 对象。Spring Data JPA 作的即是规范方法的名字，根据符合规范的名字来肯定方法须要实现什么样的逻辑。

5 Spring data JPA使用

5.1 jar包引入

<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-web</artifactId>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
<dependency>
    <groupId>mysql</groupId>
    <artifactId>mysql-connector-java</artifactId>
    <scope>runtime</scope>
</dependency>
<dependency>
    <groupId>org.projectlombok</groupId>
    <artifactId>lombok</artifactId>
    <optional>true</optional>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-devtools</artifactId>
    <optional>true</optional>
</dependency>
<dependency>
    <groupId>org.springframework.boot</groupId>
    <artifactId>spring-boot-starter-test</artifactId>
    <scope>test</scope>
</dependency>
复制代码

5.2 Spring data jpa配置

@Configuration
// 借助spring data实现自动化的jpa repository，只需编写接口无需编写实现类
// 至关于xml配置的<jpa:repositories base-package="com.example.repository" />
// repositoryImplementationPostfix默认就是Impl
// entityManagerFactoryRef默认就是entityManagerFactory
// transactionManagerRef默认就是transactionManager
@EnableJpaRepositories(basePackages = {"com.wtj.repository"},
        repositoryImplementationPostfix = "Impl",
        entityManagerFactoryRef = "entityManagerFactory",
        transactionManagerRef = "transactionManager")
// 启用事务管理器
@EnableTransactionManagement
//审计功能 用来自动填充@CreateDate等
@EnableJpaAuditing(dateTimeProviderRef = "dateTimeProvider")
public class SpringDataJpaConfig {

    @Bean
    public DateTimeProvider dateTimeProvider(DateTimeService dateTimeService) {
        return dateTimeService::getNow;
    }

    @Bean
    public JpaVendorAdapter jpaVendorAdapter() {
        HibernateJpaVendorAdapter jpaVendorAdapter = new HibernateJpaVendorAdapter();
        // 设置数据库类型（可以使用org.springframework.orm.jpa.vendor包下的Database枚举类）
        jpaVendorAdapter.setDatabase(Database.MYSQL);
        // 设置打印sql语句
        jpaVendorAdapter.setShowSql(true);
        // 设置不生成ddl语句
        jpaVendorAdapter.setGenerateDdl(false);
        // 设置hibernate方言
        jpaVendorAdapter.setDatabasePlatform("org.hibernate.dialect.MySQL5Dialect");
        return jpaVendorAdapter;
    }

    // 配置实体管理器工厂
    @Bean
    public LocalContainerEntityManagerFactoryBean entityManagerFactory(
            DataSource dataSource, JpaVendorAdapter jpaVendorAdapter) {
        LocalContainerEntityManagerFactoryBean emfb = new LocalContainerEntityManagerFactoryBean();
        // 注入数据源
        emfb.setDataSource(dataSource);
        // 注入jpa厂商适配器
        emfb.setJpaVendorAdapter(jpaVendorAdapter);
        // 设置扫描基本包
        emfb.setPackagesToScan("com.wtj.entity");
        return emfb;
    }

    // 配置jpa事务管理器
    @Bean
    public PlatformTransactionManager transactionManager(EntityManagerFactory emf) {
        JpaTransactionManager transactionManager = new JpaTransactionManager();
        // 配置实体管理器工厂
        transactionManager.setEntityManagerFactory(emf);
        return transactionManager;
    }

}

复制代码

启用web支持还须要在Spring MVC配置类上添加@EnableSpringDataWebSupport注解

@Configuration
@ComponentScan(basePackages = {"com.wtj.controller"})
@EnableWebMvc   // 启用spring mvc
@EnableSpringDataWebSupport     // 启用springmvc对spring data的支持
public class WebMvcConfig extends WebMvcConfigurerAdapter {
}
复制代码

配置文件

server:
  port: 20000
  servlet:
    context-path: /
spring:
  datasource:
    url: jdbc:mysql://localhost:3306/mytest1?useUnicode=true&serverTimezone=UTC&characterEncoding=UTF-8&zeroDateTimeBehavior=convertToNull&allowMultiQueries=true&useSSL=false
    username: root
    password: root
  jpa:
    database: MySQL
    database-platform: org.hibernate.dialect.MySQL5InnoDBDialect
    show-sql: true
    hibernate:
      ddl-auto: update
复制代码

ddl-auto 解释：

• create : 每次运行程序时，都会从新建立表，故而数据会丢失。
• create-drop：每次运行程序时会先建立表结构，而后待程序结束时清空表。
• upadte：每次运行程序，没有表时会建立表，若是对象发生改变会更新表结构，原有数据不会清空，只会更新（推荐使用）。
• validate：运行程序会校验数据与数据库的字段类型是否相同，字段不一样会报错。
• none: 禁用DDL处理。

5.3 简单的Spring dat jpa例子

例子简单就不写service层了，直接在controller中调用。
建立实体类

@Data
@Entity
@Table(name = "account")
@ToString
public class Account {

    @Id
    @GenericGenerator(name = "idGenerator", strategy = "uuid")
    @GeneratedValue(generator = "idGenerator")
    private String id;

    @Column(name = "username", unique = true, nullable = false, length = 64)
    private String username;

    @Column(name = "password", nullable = false, length = 64)
    private String password;

    @Column(name = "email", length = 64)
    private String email;

}
复制代码

主键采用UUID策略 @GenericGenerator是Hibernate提供的主键生成策略注解，注意下面的@GeneratedValue（JPA注解）使用generator = "idGenerator"引用了上面的name = "idGenerator"主键生成策略。

JPA自带的几种主键生成策略
TABLE： 使用一个特定的数据库表格来保存主键。
SEQUENCE： 根据底层数据库的序列来生成主键，条件是数据库支持序列。这个值要与generator一块儿使用，generator 指定生成主键使用的生成器（多是orcale中本身编写的序列）。
IDENTITY： 主键由数据库自动生成（主要是支持自动增加的数据库，如mysql）。
AUTO： 主键由程序控制，也是GenerationType的默认值。

dao层

@Repository
public interface AccountRepository extends JpaRepository<Account,String> {
}
复制代码

controller层

@RestController
@RequestMapping(value = "/role")
public class AccountController {

    @Autowired
    private AccountRepository repository;

    @PostMapping()
    public Account save(@RequestBody Account account) {
        return repository.save(account);
    }

    @DeleteMapping("/{id}")
    public void delete(@PathVariable("id") String accountId) {
        repository.deleteById(accountId);
    }

    @PutMapping("/{id}")
    public Account update(@PathVariable("id") String accountId, @RequestBody Account account) {
        account.setId(accountId);
        return repository.saveAndFlush(account);
    }

    @GetMapping("/{id}")
    public Account getAccountInfo(@PathVariable("id") String accountId) {
        Optional<Account> optional = repository.findById(accountId);
        return optional.orElseGet(Account::new);
    }

}
复制代码

最后在数据库中造几条假数据进行crud就能够了。

5.4 Repository接口

Repository 接口概述:

1. Repository 接口是 Spring Data 的一个核心接口，它不提供任何方法，是一个空接口，便是一个标记接口。开发者须要在本身定义的接口中声明须要的方法 。

public interface Repository<T, ID extends Serializable> { } 
复制代码

2. Spring Data可让咱们只定义接口，只要遵循Spring Data的规范，就无需写实现类。
3. 若咱们定义的接口继承了Repository，则该接口会被IOC容器识别为一个Repository Bean，归入到IOC容器中，进而能够在该接口中定义知足必定规范的方法。实际上在IOC容器中放的是该接口的实现类，只不过spring帮咱们实现了，实际上它是一个代理。
4. 与继承 Repository 等价的一种方式，就是在持久层接口上使用 @RepositoryDefinition 注解，并为其指定 domainClass 和 idClass 属性，指定对象和主键类型。

Repository 的子接口:
基础的 Repository提供了最基本的数据访问功能，其几个子接口则扩展了一些功能。它们的继承关系以下：

• Repository：仅仅是一个标识，代表任何继承它的均为仓库接口类.
• CrudRepository：继承Repository，实现了一组CRUD相关的方法.
• PagingAndSortingRepository： 继承 CrudRepository，实现了一组分页排序相关的方法.
• JpaRepository：继承PagingAndSortingRepository，实现一组JPA规范相关的方法.
• 自定义的 XxxxRepository 须要继承 JpaRepository，这样的XxxxRepository接口就具有了通用的数据访问控制层的能力.
• JpaSpecificationExecutor：不属于Repository体系，实现一组JPACriteria 查询相关的方法.

5.5 自定义条件查询语句

按照 Spring Data的规范，查询方法以find | read | get 开头，涉及条件查询时，条件的属性用条件关键字链接，要注意的是：条件属性以首字母大写。 好比说如今要按照account的名称进行查询：  

在AccountRepository接口中新增方法

@Repository
public interface AccountRepository extends JpaRepository<Account,String> {
    Account findAccountByUsername(String username);
}
复制代码

controller中新增方法：

@GetMapping("/name/{username}")
    public Account getAccountByName(@PathVariable("username") String userName){
        Account account = repository.findAccountByUsername(userName);
        return account;
    }
复制代码

这样就能够根据名称进行查询了，固然你也可使用这种方法进行复杂查询，spring data jpa中支持的关键字以下：

5.6 自定义sql语句

有些时候spring data jpa提供的查询条件知足不了业务需求的时候，可使用自定义的sql来进行查询。
想要使用自定义sql须要使用@Query注解，@Query注解使用起来很简单，默认的属性是value，就是当前写的SQL语句，有时会用到nativeQuery属性，这个属性是用来标记当前的SQL是本地SQL，仍是符合JPA语法规范的SQL。这里须要解释一下本地SQL和JPA语法规范的SQL区别。

• 本地SQL，是根据实际使用的数据库类型写的SQL，这种SQL中使用到的一些语法格式不能被JPA解析以及可能不兼容其余数据库，这种SQL称为本地SQL，此时须要将nativeQuery属性设置为true，不然会报错。
• JPA语法规范的SQL，每每这种SQL自己是不适用于任何数据库的，须要JPA将这种SQL转换成真正当前数据库所须要的SQL语法格式。

JPA很好的一个特性就是用JPA语法规范写的SQL，会根据当前系统使用的数据库类型改变生成的SQL语法，兼容数据库类型的切换，如以前使用的是MySQL，如今换成Oracle，因为不一样类型的数据库，SQL语法会有区别，若是使用的是mybatis，就须要手动去改SQL兼容Oracle，而JPA就不用啦，无缝对接。
很大的时候使用JPA感受都是为了兼容后期可能会有数据库切换的问题，因此在使用JPA的时候，不要去使用本地SQL，这就违背了使用JPA的初衷，让nativeQuery属性保持默认值就能够啦！

AccountRepository中新增方法

@Query("select a from Account a where a.username = :username")
Account findAccountByName(@Param("username")String name);

@Query("select a from Account a where a.email = ?1")
Account findAccountByEmail(String email);

@Query(value = "select * from account where username = ?1",nativeQuery = true)
Account getAccount(String username);
复制代码

• 在SQL上使用占位符的两种方式，第一种是使用":"后加变量的名称，第二种是使用"?"后加方法参数的位置。若是使用":"的话，须要使用@Param注解来指定变量名；若是使用"?"就须要注意参数的位置。
• 使用JPA语句中SQL语句中直接用实体类表明表名，由于在实体类中使用了@Table注解，将该实体类和表进行了关联。 controller中新增方法（方法名还有url起的都比较随意。。。。。）

@GetMapping("/sql/{username}")
    public Account findAccountByName(@PathVariable("username") String userName){
        Account account = repository.findAccountByName(userName);
        return account;
    }

    @GetMapping("/email/{email}")
    public Account findAccountByEmail(@PathVariable("email") String email){
        Account account = repository.findAccountByEmail(email);
        return account;
    }

    @GetMapping("/username/{username}")
    public Account getAccount(@PathVariable("username") String username){
        Account account = repository.getAccount(username);
        return account;
    }
复制代码

最后经过请求就能够得到数据而且在控制台能够看到打印出的响应的sql。
当自定义sql涉及到删除，修改，插入的操做的时候须要加上@Modifying注解。注明当前方法是修改操做。