本文已经整理进 JavaGuide 开源的 springboot-guide(SpringBoot 核心知识点总结。 基于 Spring Boot 2.19+),地址:https://github.com/Snailclimb/springboot-guide 。
JPA 这部分内容上手很容易,但是涉及到的东西还是挺多的,网上大部分关于 JPA 的资料都不是特别齐全,大部分用的版本也是比较落后的。另外,我下面讲到了的内容也不可能涵盖所有 JPA 相关内容,我只是把自己觉得比较重要的知识点总结在了下面。很多地方我自己也是参考着官方文档写的,官方文档非常详细了,非常推荐阅读一下。这篇文章可以帮助对 JPA 不了解或者不太熟悉的人来在实际项目中正确使用 JPA。
另外,我发现网上关于连表查询这一块并没有太多比较有参考价值的博客,所以对这部分也做了详细的总结,以供大家学习参考
项目代码基于 Spring Boot 最新的 2.1.9.RELEASE 版本构建(截止到这篇文章写完),另外,新建项目的过程就不多说了。
我们需要下面这些依赖支持我们完成这部分内容的学习:
下面的配置中需要单独说一下 spring.jpa.hibernate.ddl-auto=create
这个配置选项。
这个属性常用的选项有四种:
create
:每次重新启动项目都会重新创新表结构,会导致数据丢失
create-drop
:每次启动项目创建表结构,关闭项目删除表结构
update
:每次启动项目会更新表结构
validate
:验证表结构,不对数据库进行任何更改
但是,一定要不要在生产环境使用 ddl 自动生成表结构,一般推荐手写 SQL 语句配合 Flyway 来做这些事情。
spring.datasource.url=jdbc:mysql://localhost:3306/springboot_jpa?useSSL=false&serverTimezone=CTT
spring.datasource.username=root
spring.datasource.password=123456
# 打印出 sql 语句
spring.jpa.show-sql=true
spring.jpa.hibernate.ddl-auto=create
spring.jpa.open-in-view=false
# 创建的表的 ENGINE 为 InnoDB
spring.jpa.properties.hibernate.dialect=org.hibernate.dialect.MySQL55Dialect
我们为这个类添加了 @Entity
注解代表它是数据库持久化类,还配置了主键 id。
import lombok.Data;
如何检验你是否正确完成了上面 3 步?很简单,运行项目,查看数据如果发现控制台打印出创建表的 sql 语句,并且数据库中表真的被创建出来的话,说明你成功完成前面 3 步。
控制台打印出来的 sql 语句类似下面这样:
drop
@Repository
首先这个接口加了 @Repository
注解,代表它和数据库操作有关。另外,它继承了 JpaRepository
接口,而JpaRepository
长这样:
@NoRepositoryBean
public interface JpaRepository extends PagingAndSortingRepository, QueryByExampleExecutor {
ListfindAll();
ListfindAll(Sort var1);
ListfindAllById(Iterable var1);
List saveAll(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
就具有了 JPA 为我们提供好的增删改查、分页查询以及根据条件查询等方法。
1.保存用户到数据库
new Person(
save()
方法对应 sql 语句就是:insert into person (age, name) values (23,"snailclimb")
2.根据 id 查找用户
Optional personOptional = personRepository.findById(id);
findById()
方法对应 sql 语句就是:select * from person p where p.id = id
3.根据 id 删除用户
personRepository.deleteById(id);
deleteById()
方法对应 sql 语句就是:delete from person where id=id
4.更新用户
更新操作也要通过 save()
方法来实现,比如:
new Person(
在这里 save()
方法相当于 sql 语句:update person set name="UpdatedName" where id=id
下面这些方法是我们根据 JPA 提供的语法自定义的,你需要将下面这些方法写到 PersonRepository
中。
假如我们想要根据 Name 来查找 Person ,你可以这样:
OptionalfindByName(String name);
如果你想要找到年龄大于某个值的人,你可以这样:
ListfindByAgeGreaterThan(int age);
很多时候我们自定义 sql 语句会非常有用。
根据 name 来查找 Person:
@Query(
Person 部分属性查询,避免 select *
操作:
@Query(
根据 id 更新Person name:
@Modifying
@Transactional
@Query("update Person p set p.name = ?1 where p.id = ?2")
void updatePersonNameById(String name, Long id);
如果我们需要创建异步方法的话,也比较方便。
异步方法在调用时立即返回,然后会被提交给TaskExecutor
执行。当然你也可以选择得出结果后才返回给客户端。如果对 Spring Boot 异步编程感兴趣的话可以看这篇文章:《新手也能看懂的 SpringBoot 异步编程指南》 。
@Async
测试类:
@SpringBootTest
@RunWith(SpringRunner.class)
public class PersonRepositoryTest {
@Autowired
private PersonRepository personRepository;
private Long id;
/**
* 保存person到数据库
*/
@Before
public void setUp() {
assertNotNull(personRepository);
Person person = new Person("SnailClimb", 23);
Person savedPerson = personRepository.saveAndFlush(person);// 更新 person 对象的姓名
savedPerson.setName("UpdatedName");
personRepository.save(savedPerson);
id = savedPerson.getId();
}
/**
* 使用 JPA 自带的方法查找 person
*/
@Test
public void should_get_person() {
Optional personOptional = personRepository.findById(id);
assertTrue(personOptional.isPresent());
assertEquals("SnailClimb", personOptional.get().getName());
assertEquals(Integer.valueOf(23), personOptional.get().getAge());
List personList = personRepository.findByAgeGreaterThan(18);
assertEquals(1, personList.size());// 清空数据库
personRepository.deleteAll();
}/**
* 自定义 query sql 查询语句查找 person
*/@Testpublic void should_get_person_use_custom_query() {// 查找所有字段
Optional personOptional = personRepository.findByNameCustomeQuery("SnailClimb");
assertTrue(personOptional.isPresent());
assertEquals(Integer.valueOf(23), personOptional.get().getAge());// 查找部分字段
String personName = personRepository.findPersonNameById(id);
assertEquals("SnailClimb", personName);
System.out.println(id);// 更新
personRepository.updatePersonNameById("UpdatedName", id);
Optional updatedName = personRepository.findByNameCustomeQuery("UpdatedName");
assertTrue(updatedName.isPresent());// 清空数据库
personRepository.deleteAll();
}
}
源代码地址:https://github.com/Snailclimb/springboot-guide/tree/master/source-code/basis/jpa-demo
本文主要介绍了 JPA 的基本用法:
使用 JPA 自带的方法进行增删改查以及条件查询。
自定义 SQL 语句进行查询或者更新数据库。
创建异步的方法。
在下一篇关于 JPA 的文章中我会介绍到非常重要的两个知识点:
基本分页功能实现
多表联合查询以及多表联合查询下的分页功能实现。
对于连表查询,在 JPA 中还是非常常见的,由于 JPA 可以在 respository 层自定义 SQL 语句,所以通过自定义 SQL 语句的方式实现连表还是挺简单。这篇文章是在上一篇入门 JPA的文章的基础上写的,不了解 JPA 的可以先看上一篇文章。
在上一节的基础上我们新建了两个实体类,如下:
Company.java
@Entity
School.java
@Entity
假如我们当前要通过 person 表的 id 来查询 Person 的话,我们知道 Person 的信息一共分布在Company
、School
、Person
这三张表中,所以,我们如果要把 Person 的信息都查询出来的话是需要进行连表查询的。
首先我们需要创建一个包含我们需要的 Person 信息的 DTO 对象,我们简单第将其命名为 UserDTO
,用于保存和传输我们想要的信息。
@Data
下面我们就来写一个方法查询出 Person 的基本信息。
/**
* 连表查询
*/
可以看出上面的 sql 语句和我们平时写的没啥区别,差别比较大的就是里面有一个 new 对象的操作。
假如我们要查询当前所有的人员信息并实现分页的话,你可以按照下面这种方式来做。可以看到,为了实现分页,我们在@Query
注解中还添加了 countQuery 属性。
@Query(value =
实际使用:
//分页选项
下面我只介绍两种比较常用的:
IN 查询
BETWEEN 查询
当然,还有很多用法需要大家自己去实践了。
在 sql 语句中加入我们需要筛选出符合几个条件中的一个的情况下,可以使用 IN 查询,对应到 JPA 中也非常简单。比如下面的方法就实现了,根据名字过滤需要的人员信息。
@Query(value =
实际使用:
List personList=new ArrayList<>(Arrays.asList("person1","person2"));
List userDTOS = personRepository.filterUserInfo(personList);
查询满足某个范围的值。比如下面的方法就实现查询满足某个年龄范围的人员的信息。
@Query(value =
实际使用:
List userDTOS = personRepository.filterUserInfoByAge(19,20);
@SpringBootTest
本节我们主要学习了下面几个知识点:
自定义 SQL 语句实现连表查询;
自定义 SQL 语句连表查询并实现分页操作;
条件查询:IN 查询,BETWEEN查询。
我们这一节是把 SQl 语句连表查询的逻辑放在 Dao 层直接写的,这样写的好处是比较方便,也比较简单明了。但是可能会不太好维护,很多时候我们会选择将这些逻辑放到 Service 层去做,这样也是可以实现的,后面章我就会介绍到如何将这些写在 Dao 层的逻辑转移到 Service 层去。
代码地址:https://github.com/Snailclimb/springboot-guide/tree/master/source-code/basis/jpa-demo
推荐阅读
新手也能看懂的 SpringBoot 异步编程指南
Github 上热门的 Spring Boot 项目实战推荐
Java 编程技巧之数据结构
JWT 身份认证优缺点分析以及常见问题解决方案
架构设计--互联网架构演化
值得开发者关注的 Java 8 后时代的语言特性
【原创】关于Spring中的参数校验的一点思考
Spring常见问题总结(补充版)
分布式ID生成方案总结
入职一个月的职场小白,谈谈自己这段时间的感受
Code Review最佳实践
后端开发必备的 RestFul API 知识
技术面试复习大纲
如何给老婆解释什么是RPC
干货收藏 | Java程序员必备的一些流程图
十分钟搞懂Java效率工具Lombok使用与原理
看完这篇文章,别说自己不会用Lambda表达式了!
一些有助于你拿Offer的文章
面试官:“谈谈Spring中都用到了哪些设计模式?”。
如果大家想要实时关注我更新的文章以及分享的干货的话,可以关注我的公众号。