一、什么是JPA
1.JPA的定义和基本概念
JPA(Java Persistence API)是Java中用于进行持久化操作的一种规范,它定义了一系列用于操作关系型数据库的API接口。通过这些接口,开发人员可以方便地进行数据库的增删改查等操作,而无需关注具体的数据库操作细节。JPA通过JDK 5.0注解或XML描述对象-关系表的映射关系,并将运行期的实体对象持久化到数据库中。
2.JPA的核心概念
JPA的核心概念包括对象-关系映射(ORM)和实体对象持久化。ORM技术是一种将对象模型和关系模型进行映射的技术,通过ORM,开发人员可以将Java对象直接映射到数据库表中,从而避免了手动编写SQL语句的繁琐工作。JPA提供了一套注解和配置方式,可以方便地将Java类与数据库表进行映射,使得开发人员可以直接操作Java对象,而无需手动维护SQL语句。
3.JPA的用途和目标
JPA的目标是简化企业应用开发,使得开发者能够更容易地实现对象与数据库表之间的映射关系。它定义了对象-关系映射(ORM)以及实体对象持久化的标准接口,旨在规范和简化Java对象的持久化工作。通过提供统一的API和封装数据库操作细节,JPA使得开发人员可以更加方便地进行数据库操作,提高了代码的可维护性和可读性。
4.JPA的优势
使用JPA的优势包括提高代码的可维护性和可读性。通过使用JPA,开发人员可以使用面向对象的方式来操作数据库,无需直接操作SQL语句,这使得代码更加直观和易于理解。此外,JPA还提供了一些高级特性,如缓存管理、事务管理等,这些特性可以帮助开发人员更好地进行性能优化和并发控制。
二、JPA的使用
1.准备数据库脚本
DROP TABLE IF EXISTS user;CREATE TABLE user
(id BIGINT(20) NOT NULL COMMENT '主键ID',name VARCHAR(30) NULL DEFAULT NULL COMMENT '姓名',age INT(11) NULL DEFAULT NULL COMMENT '年龄',email VARCHAR(50) NULL DEFAULT NULL COMMENT '邮箱',PRIMARY KEY (id)
);
2.初始化数据
INSERT INTO user (id, name, age, email) VALUES
(1, 'Jone', 18, 'test1@baomidou.com'),
(2, 'Jack', 20, 'test2@baomidou.com'),
(3, 'Tom', 28, 'test3@baomidou.com'),
(4, 'Sandy', 21, 'test4@baomidou.com'),
(5, 'Billie', 24, 'test5@baomidou.com');
3.xml文件导入依赖
<!-- JPA框架 -->
<dependency><groupId>org.springframework.boot</groupId><artifactId>spring-boot-starter-data-jpa</artifactId>
</dependency>
4.引入JPA配置
spring:jpa:hibernate:# ddl-auto 枚举:# none(默认):禁用DDL处理# validate:验证schema,不对数据库做任何操作# update:更新schema# create:创建schema,并销毁之前数据# create-drop:会话创建时创建schema,会话关闭时销毁schemaddl-auto: update# jpa配置:在控制台显示Hibernate的sql(可选)show-sql: true
(1)加载数据库驱动,springboot3.0开始mysql驱动改为com.mysql.cj.jdbc.Driver,而非com.mysql.jdbc.Driver。
(2)jpa底层实现采用hibernate,自动建表配置使用update,表示第一次创建schema,后续只做更新操作。
5.创建实体对象
import lombok.Data;import javax.persistence.*;@Entity
@Data
@Table(name = "user")
public class UserDO {private static final long serialVersionUID = -2952735933715107252L;@Id@GeneratedValue(strategy = GenerationType.IDENTITY)private Long id;private String name;private Integer age;private String email;}
6.定义Repository接口
public interface UserRepository extends JpaRepository<UserDO, Long> {/*** 根据用户姓名查找用户** @param name 用户姓名* @return 找到的用户对象,如果不存在返回 null*/UserDO findByName(String name);/*** 根据用户姓名或电子邮箱查找用户** @param name 用户姓名* @param email 用户电子邮箱* @return 找到的用户对象,如果不存在返回 null*/UserDO findByNameOrEmail(String name, String email);/*** 根据用户姓名计数用户数量** @param name 用户姓名* @return 具有该姓名的用户数量*/Long countByName(String name);/*** 根据用户名进行模糊搜索** @param name 用户姓名(可以包含通配符)* @return 匹配的用户列表*/List<UserDO> findByNameLike(String name);/*** 根据用户姓名忽略大小写查找用户** @param name 用户姓名* @return 找到的用户对象,如果不存在返回 null*/UserDO findByNameIgnoreCase(String name);/*** 根据用户姓名查找用户,并按年龄降序排列** @param name 用户姓名* @return 匹配的用户列表,按年龄降序排列*/List<UserDO> findByNameContainingOrderByAgeDesc(String name);/*** 根据用户姓名进行分页查询** @param name 用户姓名* @param pageable 分页信息* @return 包含用户对象的分页结果*/Page<UserDO> findByName(String name, Pageable pageable);
}
注:Repository接口用于定义对实体对象UserDO进行持久化操作的方法。
7.创建controller层调用Repository接口方法
这里只是简单测了根据ID查询
@RestController
@RequestMapping("/user")
public class UserController {@Autowiredprivate UserRepository userRepository;/*** 测试单条查询*/@GetMapping("/id")public void testSelectOne() {// 从 UserRepository 中查找 ID 为 1 的用户Optional<UserDO> user = userRepository.findById(1L);System.out.println(user);}
}
测试效果:
三、JPA的常用
1.常用注解
注解 | 描述 |
@Entity | 声明该类为实体类。 |
@Table | 指定实体类映射的数据库表,通常与@Entity注解一起使用。 |
@Id | 声明实体类的属性或字段作为数据库表的主键。 |
@GeneratedValue | 指定主键的生成策略。 |
@Column | 用于标注实体类中的属性与数据库表中的字段之间的映射关系。 |
@Transient | 声明实体类的属性或字段不是持久化的。 |
@Basic | 指定实体类属性的存取策略。 |
@Temporal | 指定java.util.Date或java.util.Calendar 属性映射到数据库类型时的时间精度。 |
@Enumerated | 指定枚举类型的属性映射。 |
@OneToOne | 指定一对一的关联映射。 |
@OneToMany | 指定一对多的关联映射。 |
@ManyToOne | 指定多对一的关联映射。 |
@ManyToMany | 指定多对多的关联映射。 |
@JoinColumn | 指定关联的外键列。 |
@MapKey | 指定映射关系中的键。 |
2.常用查询方法
方法类型 | 方法名称 | 描述 |
查询方法 | findBy/getBy/queryBy/readBy | 后面跟要查询的字段名,用于精确匹配。 |
find/get/query/read | 后面跟要查询的字段名,使用条件表达式进行模糊匹配。 | |
findAll/getAll | 不跟字段名,表示查询所有记录。 | |
支持的关键字 | And | 连接多个查询条件,相当于 SQL 中的 AND。 |
Or | 连接多个查询条件,相当于 SQL 中的 OR。 | |
Between | 查询字段在某个范围内的记录。 | |
LessThan/LessThanEqual | 查询字段小于或小于等于某个值的记录。 | |
GreaterThan/GreaterThanEqual | 查询字段大于或大于等于某个值的记录。 | |
IsNull/IsNotNull | 查询字段为空或不为空的记录。 | |
Like/NotLike | 模糊查询字段值。 | |
OrderBy | 指定查询结果的排序方式。 | |
删除方法 | deleteBy/removeBy | 后面跟要查询的字段名,用于精确匹配。 |
delete/remove | 后面跟要查询的字段名,使用条件表达式进行模糊匹配。 | |
统计方法 | countBy | 后面跟要查询的字段名,用于精确匹配。 |
count | 不跟字段名,表示统计所有记录数。 | |
更新方法 | updateBy | 后面跟要查询的字段名,用于精确匹配。 |
update | 后面跟要查询的字段名,使用条件表达式进行模糊匹配。 | |
支持的关键字 | Set | 设置要更新的字段的值。 |
Where | 指定更新操作的条件。 |
3.部分查询关键字映射示例
部分查询关键字映射示例 | |
关键字 | 使用示例 |
And | findByLastnameAndFirstname |
Or | findByLastnameOrFirstname |
Is,Equals | findByFirstnameIs,findByFirstnameEquals |
Between | findByStartDateBetween |
LessThan | findByAgeLessThan |
LessThanEqual | findByAgeLessThanEqual |
GreaterThan | findByAgeGreaterThan |
GreaterThanEqual | findByAgeGreaterThanEqual |
After | findByStartDateAfter |
Before | findByStartDateBefore |
IsNull | findByAgeIsNull |
IsNotNull,NotNull | findByAge(Is)NotNull |
Like | findByFirstnameLike |
NotLike | findByFirstnameNotLike |
StartingWith | findByFirstnameStartingWith |
EndingWith | findByFirstnameEndingWith |
Containing | findByFirstnameContaining |
OrderBy | findByAgeOrderByLastnameDesc |
Not | findByLastnameNot |
In | findByAgeIn(Collection ages) |
NotIn | findByAgeNotIn(Collection ages) |
TRUE | findByActiveTrue() |
FALSE | findByActiveFalse() |
IgnoreCase | findByFirstnameIgnoreCase |