docs(spec): 修正 listUserByQy mapper 与 SQL 参数引用

This commit is contained in:
liulujian 2026-07-27 12:04:00 +08:00
parent 7ae24236df
commit a97d84290c

View File

@ -110,11 +110,11 @@ Controller#listUserByQy
JOIN txw_mhzc_yhqygxb g ON g.yh_uuid = y.yh_uuid
JOIN txw_mhzc_qyxxb q ON q.qyuuid = g.qyuuid
WHERE y.yxbz = 'Y' AND y.sdbz = 'N'
<if test="dlzh != null and dlzh != ''">
AND y.dlzh LIKE CONCAT('%', #{dlzh}, '%')
<if test="reqVO.dlzh != null and reqVO.dlzh != ''">
AND y.dlzh LIKE CONCAT('%', #{reqVO.dlzh}, '%')
</if>
<if test="qymc != null and qymc != ''">
AND q.qymc LIKE CONCAT('%', #{qymc}, '%')
<if test="reqVO.qymc != null and reqVO.qymc != ''">
AND q.qymc LIKE CONCAT('%', #{reqVO.qymc}, '%')
</if>
ORDER BY y.lrrq DESC
</select>
@ -169,15 +169,10 @@ public class UserQyVO {
### 6.3 `TxwMhzcYhxxbMapper.java` 新增方法
```java
default Page<UserQyVO> listUserByQy(UserQyReqVO reqVO){
Page<UserQyVO> page = new Page<>(reqVO.getPageNo(), reqVO.getPageSize());
return selectPage(page, Wrappers.emptyWrapper()
// 由 XML 中的 <select> 接管
);
}
Page<UserQyVO> listUserByQy(IPage<UserQyVO> page, @Param("reqVO") UserQyReqVO reqVO);
```
> **备注**:项目内 MyBatis-Plus 习惯 `default` 方法直接用 `QueryWrapper`,复杂 SQL 才走 XML。本接口需三表 JOIN + LIKE + 分页,**直接走 XML**。Mapper 接口声明形如 `Page<UserQyVO> listUserByQy(UserQyReqVO reqVO)`,由 XML`<select id="listUserByQy">` 提供实现。
> **备注**:项目内 MyBatis-Plus 习惯 `default` 方法直接用 `QueryWrapper`,复杂 SQL 才走 XML。本接口需三表 JOIN + LIKE + 分页,**直接走 XML**。Mapper 接口只声明方法,由 `TxwMhzcYhxxbMapper.xml``<select id="listUserByQy">` 提供实现;由于 MP 的 `PaginationInnerInterceptor` 仅在 mapper 方法签名出现 `IPage` 参数时才会自动注入 `SELECT COUNT(*)``LIMIT`,必须把 `Page` 显式作为参数传入。
### 6.4 `TxwMhzcYhxxbService.java` 新增方法
@ -190,7 +185,8 @@ Page<UserQyVO> listUserByQy(UserQyReqVO reqVO);
```java
@Override
public Page<UserQyVO> listUserByQy(UserQyReqVO reqVO) {
return yhxxbMapper.listUserByQy(reqVO);
Page<UserQyVO> page = new Page<>(reqVO.getPageNo(), reqVO.getPageSize());
return yhxxbMapper.listUserByQy(page, reqVO);
}
```