Quick Reference · 配 Lesson 0012

一次查询的五个文件

全部按名字对上,对不上多数情况不报错,只是那一格为空。

分工

文件
干什么
靠什么对上
Controller
门牌号:接网址,转给 Service,包 ApiResult 返回
类上 @RequestMapping + 方法上 @GetMapping/@PostMapping = 网址
Mapper 接口 .java
声明「有这个查询」,无方法体
—
Mapper .xml
SQL 本体
namespace = 接口全名;id = 方法名
DTO
进:查询条件 / 操作入参
网址参数或 JSON 的名字 = 字段名;XML 里用 @Param 名做前缀
VO
出:每行结果
SQL 列 a_b → 字段 aB(下划线转驼峰)

网址拆解

/api/vcm-order   /v1/order              /page
  网关→服务       类 @RequestMapping      方法 @GetMapping
GET 查询
POST 操作
参数写法
page(OrderDTO order) 无注解
@Valid @RequestBody XxxDTO
值来源
网址 ?a=1
请求体 JSON
F12 看
Query String Parameters
Request Payload

静默失败三连

前端名 ≠ DTO 字段
DTO 那格为空 → XML <if … != null> 跳过 → 筛选没生效
SQL 列 ≠ VO 字段
列被忽略 → 接口不返回该字段(铁律一)
片段用别名、引用方没 join
XML 校验通过 → 运行时 Unknown column(铁律三)

评审会打回的 SQL(铁律七节选)

1:1 取列用子查询
改 left join … w on w.id = s.waybill_id 取列(80279abeb)
WHERE 里 or (select…) = ?
索引失效,改 join 后列比较
上万个参数的大 IN
按 1000 分批;9-21 导出 504
SQL 里 join 字典表
SQL 只出 key,Java 翻译
同类列两种口径
承运商列一律 freight_settle_object = 3

提问三句

  1. 这个片段被几个查询 include?每个都有对应的 join 吗?
  2. select 加的列,VO 加字段了吗?
  3. 生产最大量级下,这条 SQL 有多少个参数?

主源:MyBatis 入门 · XML 映射器 · Spring MVC 方法参数