乐趣区

SpringBoot系列教程JPA之update使用姿势

jiezi

原文: 190623-SpringBoot 系列教程 JPA 之 update 使用姿势

上面两篇博文拉开了 jpa 使用姿势的面纱一角，接下来我们继续往下扯，数据插入 db 之后，并不是说就一层不变了，就好比我在银行开了户，当然是准备往里面存钱了，有存就有取（特别是当下银行利率这么低还不如买比特币屯着，截止 19 年 6 月 22 日，btc 已经突破 1.1w$，可惜没钱买????）这就是我们今天的主题，数据更新 –update 的使用姿势

<!– more –>

通过本篇博文，您至少可以选到

  • save() 直接根据 id 来修改记录
  • 利用jpl 实现查询修改的使用姿势
  • 初识事物的神秘面纱

I. 环境准备

在开始之前，当然得先准备好基础环境，如安装测试使用 mysql，创建 SpringBoot 项目工程，设置好配置信息等，关于搭建项目的详情可以参考前一篇文章

  • 190612-SpringBoot 系列教程 JPA 之基础环境搭建
  • 190614-SpringBoot 系列教程 JPA 之新增记录使用姿势

下面简单的看一下演示添加记录的过程中，需要的配置

1. 表准备

沿用前一篇的表，结构如下

CREATE TABLE `money` (`id` int(11) unsigned NOT NULL AUTO_INCREMENT,
  `name` varchar(20) NOT NULL DEFAULT ''COMMENT' 用户名 ',
  `money` int(26) NOT NULL DEFAULT '0' COMMENT '钱',
  `is_deleted` tinyint(1) NOT NULL DEFAULT '0',
  `create_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP COMMENT '创建时间',
  `update_at` timestamp NOT NULL DEFAULT CURRENT_TIMESTAMP ON UPDATE CURRENT_TIMESTAMP COMMENT '更新时间',
  PRIMARY KEY (`id`),
  KEY `name` (`name`)
) ENGINE=InnoDB AUTO_INCREMENT=1 DEFAULT CHARSET=utf8mb4;

2. 项目配置

配置信息，与之前有一点点区别，我们新增了更详细的日志打印；本篇主要目标集中在添加记录的使用姿势，对于配置说明，后面单独进行说明

## DataSource
spring.datasource.url=jdbc:mysql://127.0.0.1:3306/story?useUnicode=true&characterEncoding=UTF-8&useSSL=false
spring.datasource.driver-class-name=com.mysql.jdbc.Driver
spring.datasource.username=root
spring.datasource.password=
## jpa 相关配置
spring.jpa.database=MYSQL
spring.jpa.hibernate.ddl-auto=none
spring.jpa.show-sql=true
spring.jackson.serialization.indent_output=true
spring.jpa.hibernate.naming.physical-strategy=org.hibernate.boot.model.naming.PhysicalNamingStrategyStandardImpl

3. 数据准备

数据修改嘛，所以我们先向表里面插入两条数据，用于后面的操作

INSERT INTO `money` (`id`, `name`, `money`, `is_deleted`, `create_at`, `update_at`)
VALUES
    (21, 'jpa 修改 -> 一灰灰', 1212, 0, '2019-06-22 21:41:13', '2019-06-22 21:41:13'),
    (22, 'jpa 修改 -> 一灰灰', 6666, 0, '2019-06-22 21:41:13', '2019-06-22 21:41:13');

II. Update 使用教程

下面开始进入正题，为方便初看的同学（没空或者没兴趣瞅前面几个博文的同学）会有部分内容和前面的博文相同，看过的请无视

1. 表关联 POJO

前面插入篇已经介绍了 POJO 的逐步创建过程，已经对应的注解含义，下面直接贴出成果

@Data
@DynamicInsert
@Entity
@Table(name = "money")
public class MoneyPO {
    @Id
    @GeneratedValue(strategy = GenerationType.IDENTITY)
    @Column(name = "id")

    private Integer id;

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

    @Column(name = "money")
    private Long money;

    @Column(name = "is_deleted")
    private Byte isDeleted;

    @Column(name = "create_at")
    @CreatedDate
    private Timestamp createAt;

    @Column(name = "update_at")
    @CreatedDate
    private Timestamp updateAt;
}

上面类中的几个注解，说明如下

  • @Data 属于 lombok 注解，与 jpa 无关，自动生成 getter/setter/equals/hashcode/tostring 等方法
  • @Entity, @Table jpa 注解，表示这个类与 db 的表关联，具体匹配的是表 money
  • @Id @GeneratedValue 作用与自增主键
  • @Column表明这个属性与表中的某列对应
  • @CreateDate根据当前时间来生成默认的时间戳

2. Repository API 声明

接下来我们新建一个 api 继承自CurdRepository，然后通过这个 api 来与数据库打交道

public interface MoneyUpdateRepository extends CrudRepository<MoneyPO, Integer> {}

3. 使用姿势

a. save

在前面一篇插入博文中，我们知道当 POJO 的 id 存在时，调用 save 方法可能有两种情况

  • 若 db 中这个 id 对应的字段不存在，则插入
  • 若 db 中这个 id 对应的字段存在，则更新

我们来试一下更新的效果，下面的代码演示了两块，一个是当 po 中的所有成员值有效，更新其中的一个时，会怎样；另外一个演示的是部分更新时会怎样（name 为空，表示我不希望更新 name）

public void simpleUpdateById() {MoneyPO record = moneyUpdateRepository.findById(21).get();
    // 直接修改这个 record 的内容
    record.setMoney(3333L);
    moneyUpdateRepository.save(record);

    record = moneyUpdateRepository.findById(21).get();
    System.out.println("after updateMoney record:" + record);


    record.setName(null);
    record.setMoney(6666L);
    moneyUpdateRepository.save(record);
    
    record = moneyUpdateRepository.findById(21).get();
    System.out.println("after updateMoney record:" + record);
}

输出结果发现，前面执行成功，后面执行失败

上面为第一个执行结果，从拼接的 sql 可以知道，是全量的修改；输出结果也如我们预期

后面将 name 设置为空之后，再次更新，发现抛出异常，如下，这个是因为我们的 db 限制，字段不允许有 null 的存在

从拼接的 sql 上看，我们知道是因为每个成员都作为了 update sql 家族的一员，在 insert 这一篇中我们也遇到了类似的问题，当时是在 POJO 上添加注解@DynamicInsert，根据实际需要选择插入，那么在更新这里是不是也有类似的注解呢

@Data
@DynamicUpdate
@DynamicInsert
@Entity
@Table(name = "money")
public class MoneyPO {}

在 pojo 上添加注解 @DynamicUpdate 之后，再次进行尝试，结果如下

居然还是失败了，从输出的 sql 来看，居然把 name 和money都当成了 sql 的一部分，难道是因为我们调用了 setter 方法的原因么。待着猜测，再来一次

MoneyPO toUpdate = new MoneyPO();
toUpdate.setId(21);
toUpdate.setMoney(6666L);
moneyUpdateRepository.save(toUpdate);
record = moneyUpdateRepository.findById(21).get();
System.out.println("after updateMoney record:" + record);

输出结果如下，看来我们上面的猜测并不对，拼接 sql 应该是根据哪个字段发生了变化，就把哪个做为 sql 的一部分来做的

上面这个使用姿势看完之后，会有一个明显的感觉，这个更新的支持，必须先获取目标对象再进行修改，很难满足我们的日常业务场景；

b. 查询更新

根据某个条件来更新对应的数据，这个就比较常见了，在 jpa 中，没有找到根据方法名来支撑这种场景的方式，但是发现了另外一个有意思的东西 –jql

直接在方法方面，添加注解，注解内部写 sql

/**
 * 根据金钱来修改状态
 *
 * @param money
 * @param state
 */
@Modifying
@Query("update MoneyPO m set m.isDeleted=?2 where  m.money=?1")
void updateStateByMoney(Long money, Byte state);

/**
 * 表达式计算
 *
 * @param id
 * @param money
 */
@Modifying
@Query("update MoneyPO m set m.money=m.money + ?2 where m.id=?1")
void addMoneyById(Integer id, Long money);

上面就是一个查询更新的 case，注意两个注解

  • @Modifying 这个必须有，告诉框架我们执行的是更新 / 删除操作
  • @Query 内部是正常的 sql 语句，但是需要注意的是表名，不是实际的表，而是我们前面定义的 POJO

然后来测试一下使用

public void updateByQuery() {
    // 通过查询修改
    moneyUpdateRepository.updateStateByMoney(6666L, (byte) 0x01);

    MoneyPO record = moneyUpdateRepository.findById(21).get();
    System.out.println("after update record:" + record);


    moneyUpdateRepository.addMoneyById(21, 3333L);
    record = moneyUpdateRepository.findById(21).get();
    System.out.println("after addMoney record:" + record);
}

执行上面的代码，悲催的发现居然报错了 Caused by: javax.persistence.TransactionRequiredException: Executing an update/delete query

从堆栈的描述上来看，更新 / 删除必须要开启事务，那么事务是什么东西呢？下面推荐几篇博文

  • mysql 之锁与事务详解
  • Spring 学习之事务的使用姿势
  • Spring 学习之事务管理与传播属性

关于 jpa 中更多事务相关的，后面再引入，我们先回到本文主题，如何解决问题: 在调用上面的方法上面添加事务注解即可

@Transactional
public void testUpdate() {simpleUpdateById();
    updateByQuery();}

再次执行之后，结果如下

看上面的结果，发现 money+3333 之后的输出结果居然还是 6666；但是我们再看 db 的结果，已经是 9999 了，为什么会这样呢？

上面这个问题比较有意思了，初步猜测与事物已经 jpa 的内部缓存机制有关系，至于具体是不是这样，有必要专门开坑来验证一二

4. 小结

利用 JPA 实现表数据的更新，上面主要介绍了两种方式，save + jql

save

通过 save 更新时，需要指定 id 来实现单条记录的修改

jql

语法与 sql 差不多，配合两个注解 @Modifying, @Query来使用，下面是一个实例，两点需要注意

  • 表名是我们定义的与 db 中表关联的 POJO
  • 参数传递格式为?index，index 为参数位置
@Modifying
@Query("update MoneyPO m set m.isDeleted=?2 where  m.money=?1")
void updateStateByMoney(Long money, Byte state);

数据修改和删除，需要显示声明事务，否则会报错，一个是在调用的方法上添加注解 @Transactional，或者直接在 repository api 的接口上添加注解 @Transactional

II. 其他

0. 源码与相关博文

源码

  • 工程：https://github.com/liuyueyi/spring-boot-demo
  • module: https://github.com/liuyueyi/spring-boot-demo/blob/master/spring-boot/102-jpa

相关博文

  • mysql 之锁与事务详解
  • Spring 学习之事务的使用姿势
  • Spring 学习之事务管理与传播属性
  • 190612-SpringBoot 系列教程 JPA 之基础环境搭建
  • 190614-SpringBoot 系列教程 JPA 之新增记录使用姿势

1. 一灰灰 Blog

尽信书则不如，以上内容，纯属一家之言，因个人能力有限，难免有疏漏和错误之处，如发现 bug 或者有更好的建议，欢迎批评指正，不吝感激

下面一灰灰的个人博客，记录所有学习和工作中的博文，欢迎大家前去逛逛

  • 一灰灰 Blog 个人博客 https://blog.hhui.top
  • 一灰灰 Blog-Spring 专题博客 http://spring.hhui.top

退出移动版