摘要: 原创出处 http://www.iocoder.cn/Spring-Boot/JPA/ 「芋道源码」欢迎转载,保留摘要,谢谢!
虽然 Spring Data JPA 提供了非常强大的功能,可以满足绝大多数业务场景下的 CRUD 操作,但是可能部分情况下,我们可以使用在方法上添加 org.springframework.data.jpa.repository.@Query
注解,实现自定义的 SQL 操作。
如果是更新或删除的 SQL 操作,需要额外在方法上添加 org.springframework.data.jpa.repository.@Modifying
注解。
下面,我们来编写一个简单的示例。
在 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 。进一步的说:<4>
处,定义了更新操作,需要加上 @Modifying
注解。? 另外,我们发可以现,使用参数名时,可以不用配合 @Param
注解。创建 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);
}
? 本文仅仅是 Spring Data JPA 的简单入门,还有部分内容,胖友可以自己在去学习下:
DELETE
物理删除,而是通过标志位进行逻辑删除。如果胖友想找一个完整的,使用 JPA 的项目,可以看看 Apollo 。它是携程开源的配置中心,目前最好用的配置中心,基本没有之一,嘿嘿。
推荐阅读: