JPA学习(一)

什么是JPA

全英文名叫Java Persistence API，就是java持久化api，是SUN公司推出的一套基于ORM的规范。

持久化想必如雷贯耳，都2202年了，谁还不用个持久化框架啊，举起mybatis。

ORM呢？全英文名为Object-Relational Mapping：对象关系映射，简单来说为了不用JDBC那一套原始方法来操作数据库，ORM框架横空出世（mybatis、hibernate等等）。

然而ORM框架出的太多了，百花齐放，琳琅满目，你一套标准我一套标准，要是想换一套框架实现项目，可能要从头再写。啊这？入土吧。

百度这样介绍SUN的JPA规范：

Sun引入新的JPA ORM规范出于两个原因：

其一，简化现有Java EE和Java SE应用开发工作；

其二，Sun希望整合ORM技术，实现天下归一。

Spring-data-jpa

学jpa哪家强？哪家简单学哪家，spring-data-jpa最简单。介绍如下：

Spring Data JPA是Spring Data家族的一部分，可以轻松实现基于JPA的存储库。此模块处理对基于JPA的数据访问层的增强支持。它使构建使用数据访问技术的Spring驱动应用程序变得更加容易。

总的来说JPA是ORM规范，Hibernate、TopLink等是JPA规范的具体实现，这样的好处是开发者可以面向JPA规范进行持久层的开发，而底层的实现则是可以切换的。Spring Data Jpa则是在JPA之上添加另一层抽象（Repository层的实现），极大地简化持久层开发及ORM框架切换的成本。

也就是如下图所示：

配置环境

使用Maven管理包，使用springboot框架，建个空maven项目就行。

POM文件

  
        org.springframework.boot
        spring-boot-starter-parent
        2.2.4.RELEASE
         
    

    
        
        
            org.springframework.boot
            spring-boot-starter-web
        
        
        
            org.springframework.boot
            spring-boot-starter-data-jpa
        
        
        
            com.alibaba
            druid-spring-boot-starter
            1.1.23
        
        
        
            com.oracle.ojdbc
            ojdbc8
            runtime
        
        
        
            org.projectlombok
            lombok
            true

application.yml

spring:
  datasource:
    type: com.alibaba.druid.pool.DruidDataSource
    url: jdbc:oracle:thin:@localhost:1521:XE
    username: JPADEMO
    password: oracle
    driver-class-name: oracle.jdbc.OracleDriver
  jpa:
    hibernate:
      ddl-auto: update #自动更新
    show-sql: true  #日志中显示sql语句
  application:
    name: spring-data-jpa-demo
server:
  port: 2333 #端口号

文件夹

标准的MVC结构，有助于解耦的实现；
实体类放在 pojo/entity 下
dao（数据访问对象 data access object）在JPA中叫做repository，请遵守这个规范，就像mybaits的dao叫mapper一样。

创建数据库表

-- 创建一张表
create table JPA_USER
(
    id                number not null,
    name              varchar2(100),
    object_version    number not null,
    created_by        varchar2(50),
    created_date      date,
    last_updated_by   varchar2(50),
    last_updated_date date

);
-- 给表加主键 单列主键 主键命名为JPA_USER_PK1 
alter table JPA_USER add constraint JPA_USER_PK1 primary key (id);
-- 给表加注释
COMMENT ON table JPA_USER IS '用户信息表';
-- 给字段加注释
comment on column JPA_USER.id  is 'id';
comment on column JPA_USER.name is '用户名称';
-- 创建序列 命名为JPA_USER_S
create sequence JPA_USER_S
    minvalue 1
    maxvalue 9999999999999999999999999999
    start with 1
    increment by 1
    cache 20;
--创建索引 命名为JPA_USER_INDEX1 
create index JPA_USER_INDEX1 on JPA_USER(name);

代码 1. Spring-boot启动类

SpringContextApplication:

@EnableJpaAuditing
@SpringBootApplication
public class SpringContextApplication {
    public static void main(String[] args) {
        SpringApplication.run(SpringContextApplication.class, args);
    }
}

注意：

除了@SpringBootApplication启动注解外，

还有一个注解@EnableJpaAuditing，它是用来启动Jpa的审计功能，比如说在使用建表中经常会加入版本号、创建时间、修改时间、创建者、修改者这五个字段。因此为了简化开发，我们可以将其交给jpa来自动填充。

2. eneity实体类

package org.example.jpademo.pojo.entity;

import com.fasterxml.jackson.annotation.JsonFormat;
import lombok.Data;
import org.springframework.data.annotation.CreatedBy;
import org.springframework.data.annotation.CreatedDate;
import org.springframework.data.annotation.LastModifiedBy;
import org.springframework.data.annotation.LastModifiedDate;
import org.springframework.data.jpa.domain.support.AuditingEntityListener;

import javax.persistence.*;
import java.util.Date;


@Data
@Entity
@Table(name = "JPA_USER")
@EntityListeners(AuditingEntityListener.class)
public class JpaUser {

    @Id
    @Column(name = "ID")
    @GeneratedValue(strategy = GenerationType.SEQUENCE, generator = "JPA_USER_S")
    @SequenceGenerator(sequenceName = "JPA_USER_S", name = "JPA_USER_S", allocationSize = 1)
    private Long id;

    @Column(name = "NAME")
    private String name;

    @Column(name = "OBJECT_VERSION" )
    @Version
    private Long objectVersion;

    @Column(name = "CREATED_BY")
    @CreatedBy
    private String createdBy;

    @Column(name = "CREATED_DATE")
    @CreatedDate
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private Date createdDate;

    @Column(name = "LAST_UPDATED_BY" )
    @LastModifiedBy
    private String lastUpdatedBy;

    @Column(name = "LAST_UPDATED_DATE" )
    @LastModifiedDate
    @JsonFormat(pattern = "yyyy-MM-dd HH:mm:ss", timezone = "GMT+8")
    private Date lastUpdatedDate;
}

注解	作用	常用属性
@Data	给实体类加get/set/toString/EqualsAndHashCode方法，是lombok的注解
@Entity	指定当前类是实体类
@Table	指定实体类和表之间的对应关系	name：指定数据库表的名称
@EntityListeners	在实体类增删改的时候监听，为创建人/创建时间等基础字段赋值	value：指定监听类
@Id	指定当前字段是主键
@SequenceGenerator	指定数据库序列别名	sequenceName：数据库序列名 name：取的别名
@GeneratedValue	指定主键的生成方式	strategy ：指定主键生成策略 generator：选择主键别名
@Column	指定实体类属性和数据库表之间的对应关系	name：指定数据库表的列名称。 unique：是否唯一 nullable：是否可以为空 inserttable：是否可以插入 updateable：是否可以更新 columnDefinition: 定义建表时创建此列的DDL
@CreatedBy	自动插入创建人
@CreatedDate	自动插入创建时间
@LastModifiedBy	自动修改更新人
@LastModifiedDate	自动修改更新时间
@Version	自动更新版本号
@JsonFormat	插入/修改/读取的时间转换成想要的格式	pattern：展示格式 timezone：国际时间

注意：

有了@EntityListeners(AuditingEntityListener.class)这个注解，@CreatedBy、@CreatedDate 、@LastModifiedBy 、@LastModifiedDate才生效哦，而且创建人和更新人需要另作注入操作，此篇埋个伏笔。

3. repository 数据访问层

此处便是整个spring-data-jpa中最令人虎躯一震的地方！

震惊，一个接口居然可以实现常用的所有操作！

JpaUserRepository代码如下：

package org.example.jpademo.repository;

import org.example.jpademo.pojo.entity.JpaUser;
import org.springframework.data.jpa.repository.JpaRepository;


public interface JpaUserRepository extends JpaRepository {
}

你以为才开始吗？不，已经结束了。

可以看到，这个接口继承了JpaRepository<实体,ID>，spring-data-jpa只需要这个信息，就可以帮你完成常用的操作：增删查改。

//
// Source code recreated from a .class file by IntelliJ IDEA
// (powered by Fernflower decompiler)
//

package org.springframework.data.jpa.repository;

import java.io.Serializable;
import java.util.List;
import org.springframework.data.domain.Example;
import org.springframework.data.domain.Sort;
import org.springframework.data.repository.NoRepositoryBean;
import org.springframework.data.repository.PagingAndSortingRepository;
import org.springframework.data.repository.query.QueryByExampleExecutor;

@NoRepositoryBean
public interface JpaRepository extends PagingAndSortingRepository, QueryByExampleExecutor {
    List findAll();

    List findAll(Sort var1);

    List findAll(Iterable var1);

     List save(Iterable var1);

    void flush();

     S saveAndFlush(S var1);

    void deleteInBatch(Iterable var1);

    void deleteAllInBatch();

    T getOne(ID var1);

     List findAll(Example var1);

     List findAll(Example var1, Sort var2);
}

这一节不具体展开JpaRepository中所包含的所有方法，单纯使用最简单的增删查改来过瘾。
4. Service业务逻辑层
业务逻辑层是程序的逻辑核心，所有的重要的逻辑操作都应该往Service中写，而不是写到Controller控制层里去哦。

而且Service层是需要分层的：接口和实现类，这个不必多说，规范！规范！

我们实现最简单的新增、删除、修改、查询功能

接口如下：

public interface JpaUserService { JpaUser insertUser(JpaUser user); void deleteUser(Long id); JpaUser updateUser(JpaUser user); List findAllUser(); JpaUser findUserById(Long id); }

接口实现：

@Service public class JpaUserServiceImpl implements JpaUserService { @Resource private JpaUserRepository jpaUserRepository; @Override public JpaUser insertUser(JpaUser user) { return jpaUserRepository.save(user); } @Override public void deleteUser(Long id) { jpaUserRepository.deleteById(id); } @Override public JpaUser updateUser(JpaUser user) { return jpaUserRepository.save(user); } @Override public List findAllUser() { return jpaUserRepository.findAll(); } @Override public JpaUser findUserById(Long id) { return jpaUserRepository.findById(id).orElse(null); } }

你没有看错，一个sql语句也没有见着，直接通过jpaUserRepository接口把方法点了出来。

这一点比mybatis做的好，不过你要硬说mybatis-plus牛逼我也没办法。

数据访问层（dao）被确确实实的优化的很简便，这是spring-data-jpa很大的亮点。

细心的同学可能发现了，新增和修改都调用的save()方法，jpa靠什么区分是insert还是update呢？

靠的是主键id有没有赋值判断~id有值为update，id无值为insert。
5.Contoller控制层
控制层是前后台交互的层，我采用的是restful编写格式的接口，对于资源的具体操作类型，由HTTP动词表示。

简单借用晨瑞大佬文章中的解释：

GET（SELECT）：从服务器取出资源（一项或多项）。 POST（CREATE）：在服务器新建一个资源。 PUT（UPDATE）：在服务器更新完整资源（客户端提供改变后的完整资源）。 PATCH（UPDATE）：在服务器更新部分资源（客户端提供改变的属性）。 DELETE（DELETE）：从服务器删除资源。

简化一下：

GET：查询 POST：插入、新建 PUT：完全更新 PATCH：部分更新 DELETE：删除

举个栗子：

GET /zoos：获取所有动物园 POST /zoos：新建一个动物园 GET /zoos/ID：获取此ID的动物园信息 PUT /zoos/ID：更新此ID动物园全部信息（提供该动物园的全部信息） PATCH /zoos/ID：更新此ID动物园部分信息（提供该动物园的部分信息） DELETE /zoos/ID：删除此ID的动物园信息 GET /zoos/ID/animals：获取此ID动物园的所有动物 DELETE /zoos/ID/animals/ID：删除ID(前者)动物园的ID(后者)动物

@RestController @RequestMapping("/user") public class JpaUserController { @Resource private JpaUserService jpaUserService; @PostMapping("") public JpaUser addUser(@RequestBody JpaUser user){ return jpaUserService.insertUser(user); } @DeleteMapping("/{id}") public void deleteUser(@PathVariable("id") Long id){ jpaUserService.deleteUser(id); } @PutMapping("") public JpaUser updateUser(@RequestBody JpaUser user){ return jpaUserService.updateUser(user); } @GetMapping("") public List findAll(){ return jpaUserService.findAllUser(); } @GetMapping("/{id}") public JpaUser findbyId(@PathVariable("id") Long id){ return jpaUserService.findUserById(id); } }
总结
1.@Version注解加上后，更新操作一定要带上注解修饰的字段，且要与数据库中的值一致。

2.@CreatedBy和@CreatedDate会在更新时一并更新，需要主动去维护，或者在@Column注解中加上updatable = false，比如这样@Column(name = “CREATED_DATE”,updatable = false)。

JPA学习(一)

Java相关栏目本月热门文章