mirror of
https://gitee.com/mybatis-flex/mybatis-flex.git
synced 2025-12-08 01:28:24 +08:00
88 lines
3.1 KiB
Markdown
88 lines
3.1 KiB
Markdown
# QueryWrapperChain
|
||
|
||
`QueryWrapperChain.java` 是一个对 `QueryWrapper` 进行链式调用封装的一个类，在 Service 中，
|
||
我们可以调用 `service.queryChain()` 获得该实例。
|
||
|
||
例如，查询文章列表代码如下：
|
||
|
||
```java
|
||
|
||
@SpringBootTest
|
||
class ArticleServiceTest {
|
||
|
||
@Autowired
|
||
ArticleService articleService;
|
||
|
||
@Test
|
||
void testChain() {
|
||
List<Article> articles = articleService.queryChain()
|
||
.select(ARTICLE.ALL_COLUMNS)
|
||
.from(ARTICLE)
|
||
.where(ARTICLE.ID.ge(100))
|
||
.list();
|
||
}
|
||
|
||
}
|
||
```
|
||
|
||
若不是在 Service 中，我们也可以通过 `QueryWrapperChain.create` 方法，自己创建一个 `QueryWrapperChain` 实例，代码如下：
|
||
|
||
```java
|
||
List<Article> articles=QueryWrapperChain.create(mapper)
|
||
.select(ARTICLE.ALL_COLUMNS)
|
||
.from(ARTICLE)
|
||
.where(ARTICLE.ID.ge(100))
|
||
.list();
|
||
```
|
||
|
||
## QueryWrapperChain 的方法
|
||
|
||
- one()：获取一条数据
|
||
- list()：获取多条数据
|
||
- page()：分页查询
|
||
- obj()：当 SQL 查询只返回 1 列数据的时候，且只有 1 条数据时，可以使用此方法
|
||
- objList()：当 SQL 查询只返回 1 列数据的时候，可以使用此方法
|
||
- remove()：删除数据
|
||
- update(entity)：更新数据
|
||
- count()：查询数据条数
|
||
- exists()：是否存在，判断 count 是否大于 0
|
||
|
||
## 扩展方法
|
||
|
||
### `one()` 系列方法
|
||
|
||
- one()：获取一条数据
|
||
- oneAs(asType)：查询数据，并直接转换为 vo、dto 等
|
||
- oneWithRelations：查询一条数据及其关联数据
|
||
- oneWithRelationsAs：查询一条数据及其关联数据，并直接转换为 vo、dto 等
|
||
- oneOpt：返回 Optional 类型，获取一条数据
|
||
- oneAsOpt(asType)：返回 Optional 类型，查询数据，并直接转换为 vo、dto 等
|
||
- oneWithRelationsOpt：返回 Optional 类型，查询一条数据及其关联数据
|
||
- oneWithRelationsAsOpt：返回 Optional 类型，查询一条数据及其关联数据，并直接转换为 vo、dto 等
|
||
|
||
### `list()` 系列方法
|
||
|
||
- list()：查询数据列表
|
||
- listWithRelations()：查询数据列表极其关联数据
|
||
- listAs()：查询数据列表，并直接转换为 vo、dto 等
|
||
- listWithRelationsAs()：查询数据列表，及其关联数据，并直接转换为 vo、dto 等
|
||
|
||
### `page()` 系列方法
|
||
|
||
- page(page)：分页查询数据列表
|
||
- pageWithRelations(page)：分页查询数据列表极其关联数据
|
||
- pageAs(page)：分页查询数据列表，并直接转换为 vo、dto 等
|
||
- pageWithRelationsAs(page)：分页查询数据列表，及其关联数据，并直接转换为 vo、dto 等
|
||
|
||
### `obj()` 系列方法
|
||
|
||
- obj()：查询第一列，且第一条数据
|
||
- objAs(asType)：查询第一列，且第一条数据并转换为指定类型，比如 Long, String 等
|
||
- objOpt()：返回 Optional 类型，查询第一列，且第一条数据
|
||
- objAsOpt(asType)：返回 Optional 类型，查询第一列，且第一条数据并转换为指定类型，比如 Long, String 等
|
||
|
||
### `objList()` 系列方法
|
||
|
||
- objList()：查询第一列
|
||
- objListAs(asType)：查询第一列，并转换为指定类型，比如 Long, String 等
|