Quick Reference · 配 Lesson 0012
一次查询的五个文件
全部按名字对上,对不上多数情况不报错,只是那一格为空。
分工
文件
干什么
靠什么对上
Controller
门牌号:接网址,转给 Service,包
ApiResult 返回类上
@RequestMapping + 方法上 @GetMapping/@PostMapping = 网址Mapper 接口
.java声明「有这个查询」,无方法体
—
Mapper
.xmlSQL 本体
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
提问三句
- 这个片段被几个查询 include?每个都有对应的 join 吗?
- select 加的列,VO 加字段了吗?
- 生产最大量级下,这条 SQL 有多少个参数?
主源:MyBatis 入门 · XML 映射器 · Spring MVC 方法参数