diff --git a/docs/zh/base/field-query.md b/docs/zh/base/field-query.md index 1c75ed67..980f28e5 100644 --- a/docs/zh/base/field-query.md +++ b/docs/zh/base/field-query.md @@ -108,7 +108,7 @@ List
articles = mapper.selectListByQuery(query ## 结果映射 -您也可以继续使用连表查询,如果是原生 MyBatis 的话,可以使用 `` 标签来构建结果映射,在 MyBatis-Flex 中提供了自动结果映射功能,这样您就可以只关注于 SQL 语句的构建。 +您也可以继续使用联表查询,如果是原生 MyBatis 的话,可以使用 `` 标签来构建结果映射,在 MyBatis-Flex 中提供了自动结果映射功能,这样您就可以只关注于 SQL 语句的构建。 ## 代码示例(Join Query) @@ -147,7 +147,7 @@ public class UserVO { } ``` -这个操作只需要连表查询即可完成,对于连表查询的结果映射,MyBatis-Flex 会自动帮您完成: +这个操作只需要联表查询即可完成,对于联表查询的结果映射,MyBatis-Flex 会自动帮您完成: ```java @SpringBootTest @@ -170,7 +170,7 @@ class UserMapperTest { } ``` -构建的连表查询 SQL 语句为: +构建的联表查询 SQL 语句为: ```sql SELECT `u`.`user_id`, @@ -187,4 +187,17 @@ LEFT JOIN `sys_role` AS `r` ON `ur`.`role_id` = `r`.`role_id`; UserVO{userId='1', userName='admin', roleList=[Role{roleId=1, roleKey='admin', roleName='超级管理员'}]} UserVO{userId='2', userName='ry', roleList=[Role{roleId=2, roleKey='common', roleName='普通角色'}]} UserVO{userId='3', userName='test', roleList=[Role{roleId=1, roleKey='admin', roleName='超级管理员'}, Role{roleId=2, roleKey='common', roleName='普通角色'}]} -``` \ No newline at end of file +``` + +## 特别注意!!! + +使用 `join` 联表查询的时候,只能使用 `selectListXxx` 方法查询 List 数据,不能使用 `selectOneXxx` 方法查询单个数据。 + +```java +default R selectOneByQueryAs(QueryWrapper queryWrapper, Class asType) { + List entities = selectListByQueryAs(queryWrapper.limit(1), asType); + return (entities == null || entities.isEmpty()) ? null : entities.get(0); +} +``` + +因为这个 `selectOneXxx` 方法都是调用的对应的 `selectListXxx` 方法,其中添加了 `queryWrapper.limit(1)` 约束,将数据限制在了一条,而联表查询数据有可能是多条的,这样自动映射就会出现数据丢失。 \ No newline at end of file