7.8 repository
repository是最接近数据库的一个层,它的功能就是对数据库的表进行CRUD 操作(create、Read、Update和Delete)。Spring Boot一个很重要的革新,就是repository仅有接口无需实现,按照特定的规则命名函数,Spring Data JPA会自动实现接口。在7.5节已经看过一个例子,本节将介绍更多细节。
一个repository接口对应一个实体类
每个repository接口的命名一般都是按照实体类来,例如User表的repository接口就应该命名成UserRepository,例如代码7-18所示:
一个repository接口实例
UserRepository 首先需要标签@Repository,然后它必须继承Spring提供的接口,这里继承的是CrudRepository(还有很多个接口可供继承),还需要指定泛化的参数<User,String>,第一个参数是绑定的实体类,第二个是这个实体类的主键的类型。
和实体类一样,repository的所有接口通常都放在一个包里。
方法命名规则
首先来看看UserRepository对应的实体类User,如代码7-19所示:
实体类User
现在看看代码7-18里面的几个方法。
findByUsername 根据主键查找,username是主键
findByRole 根据角色查找,此方法返回一个列表
save 新增或者更新都是用这个方法名,参数是要更新的实体对象
delete 删除,参数是要删除的实体对象
existsByUsername 判断用户是否存在,参数是主键
queryRoleByName 这个是自定义的查询方法,不必遵循特定的命名规则,写在上方的@Query标签处的是类SQL的查询语言JPQL。如果要使用原生的SQL语言,可以在@Query标签加上第二个参数,如代码7-20所示:
使用原生SQL查询
总结一下前缀:
普通查询,返回对象或集合:findBy
存在查询,返回布尔值:existsBy
保存或更新:save
删除:delete
自定义:方法名字自定,但需要在标签@Query写上查询语句
另外save,delete,findAll(查询所有)等几个方法如果没有别的逻辑要求,可以不定义。由JpaRepository和父接口提供的方法有:
save(S entity):保存给定的实体,可以是新的实体或更新现有实体。
saveAll(Iterable<S> entities):保存给定的所有实体。
findById(ID id):根据id查找实体。
existsById(ID id):根据id判断实体是否存在。
findAll():查找所有实体。
findAll(Sort sort):查找所有实体,根据排序参数进行排序。
findAllById(Iterable<ID> ids):根据多个id查找对应的所有实体。
count():返回实体总数。
deleteById(ID id):根据id删除实体。
delete(T entity):删除一个实体。
deleteAll(Iterable<? extends T> entities):删除给定的实体集合。
deleteAll():删除所有实体。
deleteAllInBatch():批量删除表中的所有实体。
getOne(ID id):根据id获取实体的引用,此方法不会立即访问数据库,直到实体被真正使用。
findAll(Pageable pageable):分页查询实体。
常用的查询命名规则
查询是最常用,也是逻辑最复杂的,Spring Boot提供了很多规则来命名查询方法:
find用作查询,可以根据喜好使用query,read,get。
By后面跟属性名称:表示查询的条件(例如,findByUsername根据用户名查询)。
Containing(包含), Between(之间), LessThan(小于), GreaterThan(大于), Like。在属性名之后添加这些词,可以指定属性的查询方式。下面是具体的例子:
Containing
说明: 此方法会找出所有username字段包含给定username字符串的User实例。例如,如果数据库中存在用户名为"john_doe", "jane_doe", "johanna"的用户,调用findByUsernameContaining("john")将返回包含"john_doe"和"johanna"的User实例列表。这类似于SQL中的LIKE '%value%'操作。
Between
说明: 这个方法会返回年龄在startAge和endAge之间的所有User实例(包括边界值)。比如,findByAgeBetween(18, 25)会找出所有年龄在18到25岁之间的用户。
LessThan
说明: 此方法会返回年龄小于给定age的所有User实例。例如,findByAgeLessThan(18)将返回所有未满18岁的用户。
GreaterThan
说明: 这个方法会返回年龄大于给定age的所有User实例。如果调用findByAgeGreaterThan(65),它将找到所有年龄超过65岁的用户。
Like
说明: 此方法将找出所有email字段匹配给定emailPattern字符串模式的User实例。例如,findByEmailLike("%@gmail.com")会返回所有电子邮件地址以"@gmail.com"结尾的用户。这与Containing相似,但Like可以更灵活地用于任何位置的匹配,而不仅仅是包含(尽管在实践中Containing通常被用来实现LIKE '%value%'查询)。
And 和Or,就是并且和或者。下面是具体的例子
And
说明: 此方法将会找出用户名等于给定username且年龄等于age的所有User实例。这相当于SQL中的查询条件WHERE username = ? AND age = ?。
Or
说明: 这个方法会返回用户名等于给定username或年龄等于age的所有User实例,相当于SQL中的WHERE username = ? OR age = ?。
OrderBy后面跟属性名称和Asc/Desc:表示查询结果的排序方式。例如:
说明: 此方法会查找所有年龄大于给定age的User实例,并按照年龄升序排序。这等同于SQL查询中的WHERE age > ? ORDER BY age ASC。
使用Top或者First
限制查询结果的数量,例如:
findTop10ByOrderByAgeDesc方法将返回年龄最大的前10个用户。
findFirst5ByUsernameContaining方法将返回用户名中包含指定字符串的前5个用户。
这些方法对于实现简单的限制查询非常方便,但仅仅支持从开始取若干个数,它不能完全替代limit;如果要分页逻辑,使用Pageable通常是更灵活的选择。
《前后端穿透》课程目录
按教材顺序从 Vue 前端讲到 Spring Boot 后端:模板、组件、路由、axios、Controller、JPA、文件上传、Nginx 部署,最后完成学习平台实训。10 章 71 节,配 220 张操作截图与可直接运行的代码。
- 第1章 前端介绍
- 1.1 前端和后台
- 1.2 vue.js是什么
- 1.3 vue开发环境设置
- 1.4 第一个vue项目
- 1.5 Git代码管理
- 第2章 vue的基础
- 2.1 示范项目的简单解释
- 2.2 插值
- 2.3 插入原始HTML
- 2.4 双向绑定
- 2.5 条件
- 2.6 实训:模拟登陆
- 2.7 循环
- 2.8 实训:显示学生成绩
- 第3章 vue组件技术
- 3.1 组件
- 3.2 组件的构成
- 3.3 组件的data和props
- 3.4 组件的script
- 3.5 组件的template部分的事件绑定
- 3.6 组件路由
- 3.7 组件间通信(未完成)
- 3.8 动态计算变量
- 3.9 页面跳转
- 3.10 watch机制
- 第4章 获取数据
- 4.1 http请求是什么
- 4.2 axios模块
- 4.3 实训:查找数据库登录
- 第5章 实训:重构网站
- 5.1 需求
- 5.2 组件设计:游戏主页MobieGame
- 5.3 开始重构页面
- 5.4 组件设计:框架GameFrame
- 5.5 再次修改MobileGame
- 5.6 继续GameFrame组件
- 5.7 组件设计:游戏卡片Game
- 5.8 横排还是竖排?
- 5.9 组件设计:游戏详情组件
- 第6章 Spring Boot介绍
- 6.1 开发工具
- 6.2 第一个Spring Boot项目
- 6.3 maven项目结构介绍
- 6.4 启动项目
- 6.5 Spring Boot项目的部署
- 第7章 Spring Boot基本特性
- 7.1 响应HTTP请求
- 7.2 发送json数据
- 7.3 Controller
- 7.4 从对象自动构建JSON
- 7.5 JPA支持
- 7.6 MySQL支持
- 7.7 实体类配置
- 7.8 repository
- 7.9 service
- 7.10 文件上传
- 第8章 Nginx
- 8.1 原文:多项目与反向代理
- 8.2 Nginx 的安装与配置结构
- 8.3 upstream 与反向代理补全
- 8.4 部署 Vue 前端与 /api 反向代理
- 8.5 HTTPS 与证书
- 8.6 常见错误排查
- 8.7 一份完整的上线配置
- 8.8 上线检查清单
- 第9章 实训:学习平台
- 9.1 创建顶部菜单组件
- 9.2 添加底部信息组件
- 9.3 中间内容部分组件
- 9.4 添加About组件
- 9.5 添加Study组件
- 9.6 添加sidebar
- 9.7 sidebar功能完善
- 第10章 附录:ES6常用特性
- 10.1 变量声明
- 10.2 字符串
- 10.3 对象
- 10.4 lambda表达式
- 10.5 模块
- 10.6 修饰符