refactor(SQL分层): TaskImageCacheMapper 9 条注解 SQL 迁进 mapper XML,读侧判据改逐接口钉

档 B 口径:自定义语句一律进 XML,"特别简单"只剩 BaseMapper 自带 CRUD 与单表主键/唯一键点查。

判据这次不只是改数字。读侧原来钉的是「总数 65 + 文件数 16」两个标量,那么 A 接口加一条、
B 接口减一条就能让两个标量双双不动而绕过闸门,等于档 B 下没有闸门。改成逐接口清单
SELECT_SQL_BASELINE,并加 thePerFileLedgerCatchesWhatTheScalarsCouldNot 自证:在内存里造出
那次搬家,先断言总数与文件数确实都不变(证明旧钉法失明),再断言逐接口清单必须不等。

复用片段抽在真重复处:WHERE url_hash IN <foreach> 被三条语句共用,抽成 byUrlHashIn。
没抽列清单是刻意的——这个表每条语句只取必要列,image_bytes 是 BLOB,整行回读会把省内存
的缓存变成内存负担。所以新守卫 TaskImageCacheMapperXmlTest 钉的第一条就是"只有两条直读
字节的语句能碰 image_bytes"(迁 SQL 最顺手写成 SELECT *,而它在没有库的单测里不会自然变红),
其余钉 &lt; 是否还原成 <、LIMIT ? 是否仍是绑定参数、NOW(3) 毫秒精度、byte[] 的 resultType
必须写 "[B"(别名表里没有它)。

基线同步递减:写侧 29→25、读侧 65→60,MIGRATED_TO_XML 加 TaskImageCacheMapper。
定向 47 例绿(判据 9 + 新守卫 7 + asincache 样板 6 + 两个消费方 service 25)。
既有接口是 CRLF,改动走二进制删行,没把整份文件翻成 LF。
This commit is contained in:
2026-10-08 10:29:36 +08:00
parent 207225eb86
commit 3ed8a4265d
4 changed files with 308 additions and 33 deletions
@@ -0,0 +1,63 @@
<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE mapper PUBLIC "-//mybatis.org//DTD Mapper 3.0//EN" "https://mybatis.org/dtd/mybatis-3-mapper.dtd">
<!--
biz_task_image_cache 的读写 SQL(原先全在注解文本块里,见 TaskImageCacheMapper 的 git 历史)。
这个 mapper 的每条语句都刻意只取必要列 —— image_bytes 是 BLOB,整行拉回 JVM 会把缓存
变成内存负担,所以这里没有"全列清单"那种片段可复用;真正重复的是 url_hash 的 IN 形状,
三条语句共用,抽成 byUrlHashIn 一处维护。
复用片段的隐式约束:片段里写死了参数名 urlHashes,所以引用它的语句必须都带
@Param("urlHashes"),否则报错发生在调用期而不是启动期。
-->
<mapper namespace="com.nanri.aiimage.modules.task.mapper.TaskImageCacheMapper">
<sql id="byUrlHashIn">
WHERE url_hash IN
<foreach collection="urlHashes" item="hash" open="(" separator="," close=")">#{hash}</foreach>
</sql>
<update id="touchLastUsed">
UPDATE biz_task_image_cache SET last_used_at = NOW(3) WHERE url_hash = #{urlHash}
</update>
<select id="selectUrlHashes" resultType="string">
SELECT url_hash FROM biz_task_image_cache
<include refid="byUrlHashIn"/>
</select>
<update id="touchLastUsedBatch">
UPDATE biz_task_image_cache SET last_used_at = NOW(3)
<include refid="byUrlHashIn"/>
</update>
<!-- resultType="[B" 是 byte[].class 的 JVM 名字,MyBatis 的类型别名表里没有它 -->
<select id="selectBytesByUrlHash" resultType="[B">
SELECT image_bytes FROM biz_task_image_cache WHERE url_hash = #{urlHash} LIMIT 1
</select>
<select id="selectBytesByUrlHashes"
resultType="com.nanri.aiimage.modules.task.model.entity.TaskImageCacheEntity">
SELECT url_hash, image_bytes FROM biz_task_image_cache
<include refid="byUrlHashIn"/>
</select>
<select id="sumByteSize" resultType="long">
SELECT COALESCE(SUM(byte_size), 0) FROM biz_task_image_cache
</select>
<select id="sumOldestBatchByteSize" resultType="long">
SELECT COALESCE(SUM(byte_size), 0) FROM (
SELECT byte_size FROM biz_task_image_cache ORDER BY last_used_at LIMIT #{limit}
) oldest
</select>
<delete id="deleteExpiredBatch">
DELETE FROM biz_task_image_cache WHERE last_used_at &lt; #{cutoff}
ORDER BY last_used_at LIMIT #{limit}
</delete>
<delete id="deleteOldestBatch">
DELETE FROM biz_task_image_cache ORDER BY last_used_at LIMIT #{limit}
</delete>
</mapper>