@data注解_芋道 Spring Boot JPA 入门（三）之基于注解查询

最新推荐文章于 2022-04-29 14:33:38 发布

weixin_39845206

最新推荐文章于 2022-04-29 14:33:38 发布

阅读量90

点赞数

文章标签： @data注解 @param注解 @param注解的用法解析 java分页查询 jpa分页查询 jpa多表关联查询

Java 并发源码

摘要: 原创出处 http://www. iocoder.cn/Spring-Boot/ JPA/ 「芋道源码」欢迎转载，保留摘要，谢谢！

1. 概述
2. 快速入门
3. 分页操作
4. 基于方法名查询
5. 基于注解查询
666. 彩蛋

《Java 2019 超神之路》
《Dubbo 实现原理与源码解析 —— 精品合集》
《Spring 实现原理与源码解析 —— 精品合集》
《MyBatis 实现原理与源码解析 —— 精品合集》
《Spring MVC 实现原理与源码解析 —— 精品合集》
《Spring Boot 实现原理与源码解析 —— 精品合集》
《数据库实体设计合集》
《Java 面试题 —— 精品合集》
《Java 学习指南 —— 精品合集》

5. 基于注解查询

虽然 Spring Data JPA 提供了非常强大的功能，可以满足绝大多数业务场景下的 CRUD 操作，但是可能部分情况下，我们可以使用在方法上添加 org.springframework.data.jpa.repository.@Query 注解，实现自定义的 SQL 操作。

如果是更新或删除的 SQL 操作，需要额外在方法上添加 org.springframework.data.jpa.repository.@Modifying 注解。

下面，我们来编写一个简单的示例。

5.1 UserRepository04

在 cn.iocoder.springboot.lab13.mybatis.repository 包路径下，创建 UserRepository04 接口。代码如下：

// UserRepository04.java

public interface UserRepository04 extends PagingAndSortingRepository<UserDO, Integer> {

    @Query("SELECT u FROM UserDO u WHERE u.username = ?1")
    UserDO findByUsername01(String username); // <1>

    @Query("SELECT u FROM UserDO u WHERE u.username = :username")
    UserDO findByUsername02(@Param("username") String username); // <2>

    @Query(value = "SELECT * FROM users u WHERE u.username = :username", nativeQuery = true)
    UserDO findByUsername03(@Param("username") String username); // <3>

    @Query("UPDATE UserDO  u SET u.username = :username WHERE u.id = :id")
    @Modifying
    int updateUsernameById(Integer id, String username); // <4>

}

<1> 处，使用 @Query 自定义了一个 SQL 操作，并且参数使用占位符(`?`) + 参数位置的形式。
<2> 处，和 <1> 类似，差异在于使用占位符(`:`) + 参数名字(需要使用 `@Param` 声明)的形式。
<3> 处，和 <2> 类似，差别在于我们增加了 nativeQuery = true ，表示在 @Query 自定义的是原生 SQL，而非在 <1> 和 <2> 自定义的是 JPQL 。进一步的说：
- `<1>` 和 `<2>` 处，`FROM UserDO` ，使用的是实体名。
- `<3>` 处，使用的是表名。
- 对 JPQL 不是很了解的胖友，可以看看《JPQL 的学习》文章。
<4> 处，定义了更新操作，需要加上 @Modifying 注解。另外，我们发可以现，使用参数名时，可以不用配合 @Param 注解。

5.2 简单测试

创建 UserRepository04Test 测试类，我们来测试一下简单的 UserRepository04 的每个操作。代码如下：

// UserRepository04Test.java

@RunWith(SpringRunner.class)
@SpringBootTest
public class UserRepository04Test {

    @Autowired
    private UserRepository04 userRepository;

    @Test
    public void testFindIdByUsername01() {
        UserDO user = userRepository.findByUsername01("yunai");
        System.out.println(user);
    }

    @Test
    public void testFindIdByUsername02() {
        UserDO user = userRepository.findByUsername02("yunai");
        System.out.println(user);
    }

    @Test
    public void testFindIdByUsername03() {
        UserDO user = userRepository.findByUsername03("yunai");
        System.out.println(user);
    }

    @Test
    // 更新操作，需要在事务中。
    // 在单元测试中，事务默认回滚，所以胖友可能怎么测试，事务都不更新。
    @Transactional
    public void testUpdateUsernameById() {
        userRepository.updateUsernameById(5, "yudaoyuanma");
    }

}

具体的，胖友可以自己跑跑，妥妥的。

对于分页操作，需要在 @Query 编写查询分页列表和记录总数两条 SQL 。示例如下：

public interface UserRepository extends JpaRepository<User, Long> {

  @Query(value = "SELECT * FROM USERS WHERE LASTNAME = ?1", // value 属性，编写查询分页列表的 SQL 。
    countQuery = "SELECT count(*) FROM USERS WHERE LASTNAME = ?1", // countQuery 属性，编写记录总数的 SQL 。
    nativeQuery = true)
  Page<User> findByLastname(String lastname, Pageable pageable);

}

666. 彩蛋

本文仅仅是 Spring Data JPA 的简单入门，还有部分内容，胖友可以自己在去学习下：

《Using JPA Named Queries》，可以使用 XML 自定义 SQL 操作。
《Spring Data JPA 实现逻辑删除》，绝大多数业务场景下，我们不会使用 DELETE 物理删除，而是通过标志位进行逻辑删除。
多表查询
- 方式一：《JPA 多表查询的解决办法》
- 方式二：《JPA 多表关联查询》
《Spring Data JPA 使用 Example 快速实现动态查询》
艿艿，如果在这种情况下，Repository 需要继承 JpaRepository 接口。

如果胖友想找一个完整的，使用 JPA 的项目，可以看看 Apollo 。它是携程开源的配置中心，目前最好用的配置中心，基本没有之一，嘿嘿。