refactor(phase-2): 后端任务管线公共层下沉——三段沉实测逐字件,跑批段如实登记无可沉
新增 modules/task/service/pipeline 两支公共件(AbstractFileTaskPipeline 394 行/ AbstractShopPayloadTaskPipeline 149 行)+ 29 例单测(19+10,覆盖正常/边界/异常)。 签名逐条来自 2026-10-18 对七支现网代码的定点实贴,注释里带出处行号: - 解析建单沉 task 头行与结果行的落库形状(七支公共列,出处逐一点名); - 回传落库沉准入序列(校验→加载→模块校验→终态拒绝→归属→心跳), 终态拒绝按 BusinessCodes 拆成 IDEMPOTENT(40901)/ERROR(无 code) 两格——这不是文案,是线协议; - 出结果沉「上传对象存储→写 6 列→updateById」,六支同形,ShopDataCrawl 走批量条件更新 (updateResultFileColumns:1880-1892,还会传 null objectKey)不在其列,已从名单点名撤出; - 跑批段服务端无可沉(机制早已收在 TaskFileJobService/TaskResultFileJobWorker, ClientTaskPullSpi 只 3/7 支实现),故不立转发钩子=不造空壳; - report 段不新造 SPI,复用既有 ResultFileJobHandler;缓存/心跳复用 AbstractModuleTaskCacheService。 七支巨石内部一行未动(Phase 2 硬边界)。 两处「没替现网做决定」: 1) writeJson(序列化失败即 BusinessException、不带 cause,Publish:2122/AP:213/CollectData:362 同形) 本轮不沉——CatchSilenceRatchetTest 自述「新增捕获块要么别加,要么同批减一处同形状」, 而 Phase 2 不许改七支 ⇒ 减不掉就只能不加,该件随 Phase 3 首迁同笔落(本文件零捕获块)。 2) successFileCount/failedFileCount 不由底座初始化:建单时五支写 0、Publish 写真实失败数、 DeleteBrand 首次 insert 两列留 NULL(:146-157 → :268-278 才回填),底座一-default 0 就是偷换语义。 门禁:mvn -o test 4460 例/3 红,三红逐条取证均不归本笔(catch 棘轮 1004=另一路在飞 CollectDataService 新增的一处捕获块;CollectDataBrandBatchFilterTest 与 ShopDataCrawlTemplateLargeWorkbookTest 单独复跑皆绿,前者是顺序污染、后者是 93s 耗时断言被抢核)。 本笔单独跑 88 例全绿(新件 29+ArchitectureBoundaryTest 6+八套 Phase 0 快照), src/test/resources 下 golden 一字未动=未迁移模块行为逐字节相等;task→业务 依赖仍为 0。
This commit is contained in:
+394
@@ -0,0 +1,394 @@
|
||||
package com.nanri.aiimage.modules.task.service.pipeline;
|
||||
|
||||
import cn.hutool.core.util.IdUtil;
|
||||
import com.baomidou.mybatisplus.core.conditions.query.LambdaQueryWrapper;
|
||||
import com.nanri.aiimage.common.exception.BusinessCodes;
|
||||
import com.nanri.aiimage.common.exception.BusinessException;
|
||||
import com.nanri.aiimage.common.security.AdminAuthSupport;
|
||||
import com.nanri.aiimage.modules.file.service.oss.OssStorageService;
|
||||
import com.nanri.aiimage.modules.task.mapper.FileResultMapper;
|
||||
import com.nanri.aiimage.modules.task.mapper.FileTaskMapper;
|
||||
import com.nanri.aiimage.modules.task.model.entity.FileResultEntity;
|
||||
import com.nanri.aiimage.modules.task.model.entity.FileTaskEntity;
|
||||
import com.nanri.aiimage.modules.task.service.AbstractModuleTaskCacheService;
|
||||
import com.nanri.aiimage.modules.task.service.TaskDistributedLockService;
|
||||
import com.nanri.aiimage.modules.task.service.TaskFileJobService;
|
||||
import com.nanri.aiimage.modules.task.service.TaskFinalizeSupport;
|
||||
import lombok.extern.slf4j.Slf4j;
|
||||
|
||||
import java.io.File;
|
||||
import java.time.LocalDateTime;
|
||||
import java.util.ArrayList;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 后端任务管线四段(文件任务→解析→跑批→出结果)的公共底座。
|
||||
*
|
||||
* <p><b>本类只沉「七支巨石实测逐字相同的那一截」,不承诺统一四段。</b>签名逐条来自
|
||||
* 2026-10-18 对七支现网代码的定点实贴(AppearancePatent 3,377/ShopDataCrawl 3,195/
|
||||
* DeleteBrand 2,304/PriceTrack 2,302/Publish 2,249/CollectData 2,162/ShopMatch 2,027),
|
||||
* 每段方法的注释里都写了它的出处行号,Phase 3 迁移时被迁移支必须能逐字替换,
|
||||
* 换不上就是本类缺件,不是迁移方自由发挥。
|
||||
*
|
||||
* <p>四段实测结论(决定了下面有什么、没有什么):
|
||||
* <ul>
|
||||
* <li><b>解析建单</b>:能沉的是 task 头行与结果行的<b>落库形状</b>({@link #newTaskHeader}
|
||||
* /{@link #newScopeRow});<b>不能沉</b>的是解析本身——
|
||||
* 七支只有 4 支读 Excel(ShopDataCrawl/ShopMatch 无文件概念),且事务策略三分
|
||||
* (AppearancePatent 与 DeleteBrand 全程无事务、Publish/CollectData 用
|
||||
* {@code TransactionTemplate}、ShopDataCrawl/ShopMatch 用 {@code @Transactional}),
|
||||
* 返回 VO 字段互不相交。所以 parse 是钩子留在各支,底座只提供落库件。</li>
|
||||
* <li><b>序列化那半件本轮不沉</b>:七支建单时都写「{@code writeValueAsString} 失败即
|
||||
* {@code BusinessException}(不带 cause)」,形状一致、只有文案不同,本来是最干净的公共件。
|
||||
* 但 {@code config/CatchSilenceRatchetTest} 的自述规则是「新增捕获块要么别加,
|
||||
* 要么同批减掉一处同形状」,而 Phase 2 禁止改七支 ⇒ 减不掉,只能不加。
|
||||
* 该件随 Phase 3 首支迁移同笔落:那笔删掉被迁支的本地同名件,净增 ≤ 0。
|
||||
* 现成模板已存在——{@code PublishTaskService:2118-2124} 的私有 {@code writeJson(Object, String)}
|
||||
* 就是带文案参数的形状,task 模块内部另有三份逐字同名件
|
||||
* ({@code TaskProgressSnapshotService:186}/{@code TaskResultItemService:405}/
|
||||
* {@code TaskResultPayloadService:113}),一并归并才是正解(注意 RETHROW 那格是下限,
|
||||
* 归并必须逐处记名,别悄悄搬)。</li>
|
||||
* <li><b>跑批</b>:服务端<b>没有属于这七支的可沉件</b>——机制早已收在
|
||||
* {@link TaskFileJobService}(enqueue/claim/markSuccess/markFailed)+
|
||||
* {@code TaskResultFileJobWorker}(取锁、重排、重试)+
|
||||
* {@code TaskClientPullService},而 {@code ClientTaskPullSpi} 只有 3/7 支实现。
|
||||
* 本类<b>不</b>为此段提供转发钩子:那是空壳,不是抽象。</li>
|
||||
* <li><b>回传落库</b>:能沉的是准入(校验→取锁→加载→模块校验→终态拒绝→心跳)
|
||||
* 与结果行列举;<b>不能沉</b>的是合并模型——实测三个家族(chunk+scope/
|
||||
* shop-payload/DeleteBrand 自有存储),shop-payload 那族见
|
||||
* {@link AbstractShopPayloadTaskPipeline}。</li>
|
||||
* <li><b>出结果</b>:六支逐字相同的是「上传对象存储 → 写 6 列 → {@code updateById}」
|
||||
* ({@link #publishResultFile}),第七支 ShopDataCrawl 走批量条件更新、不在其列
|
||||
* (见该方法注释)。<b>本类不新建 report SPI</b>——
|
||||
* {@code ResultFileJobHandler} 已是该段的注册契约(moduleType 唯一、启动 fail-fast),
|
||||
* 各支的 Handler 实现改为复用这段骨架,而不是再立一套。</li>
|
||||
* </ul>
|
||||
*
|
||||
* <p>缓存与心跳复用 {@link AbstractModuleTaskCacheService},不新造第二套:4/7 支有模块缓存服务
|
||||
* (AppearancePatent/ShopDataCrawl/ShopMatch/PriceTrack),其余三支没有——
|
||||
* 故 {@link #taskCacheService()} 默认 {@code null},心跳只在有缓存服务的支上落,
|
||||
* 与现网一致(DeleteBrand 走自家 {@code saveProgress},其缓存服务<b>不</b>继承本抽象,
|
||||
* 见 {@code DeleteBrandRunService:1265} 注释)。
|
||||
*
|
||||
* <p>依赖严格限于 task 模块内部+{@code common}+{@code modules.file},不触碰任何业务模块,
|
||||
* 满足 ArchUnit 冻结线 {@code TASK_TO_BUSINESS_BASELINE = 0}
|
||||
* ({@code ArchitectureBoundaryTest:39})。泛型 {@code T} 即该支店铺维度合并载荷类型,
|
||||
* 与 {@link AbstractModuleTaskCacheService} 的 {@code T} 同义,因此两者可直接对接。
|
||||
*/
|
||||
@Slf4j
|
||||
public abstract class AbstractFileTaskPipeline<T> {
|
||||
|
||||
/** 终态任务被再次回传时的拒绝形状。两支差异不是文案,是线协议。 */
|
||||
public enum TerminalRejection {
|
||||
/**
|
||||
* 带 {@link BusinessCodes#TASK_ALREADY_FINISHED}(40901):
|
||||
* {@code GlobalExceptionHandler} 转 HTTP 200 + success=true,Python 侧按幂等忽略、停止重试。
|
||||
* 现网出处:ShopMatch {@code :652}/PriceTrack {@code :603}/CollectData {@code :864/:904}。
|
||||
*/
|
||||
IDEMPOTENT,
|
||||
/**
|
||||
* 不带 code({@code BusinessException(String)}):响应 success=false,调用方会当错误处理。
|
||||
* 现网出处:ShopDataCrawl {@code :633}/DeleteBrand {@code :1362-1374}/Publish {@code :1344}。
|
||||
*/
|
||||
ERROR
|
||||
}
|
||||
|
||||
protected final FileTaskMapper fileTaskMapper;
|
||||
protected final FileResultMapper fileResultMapper;
|
||||
protected final TaskDistributedLockService taskDistributedLockService;
|
||||
protected final TaskFileJobService taskFileJobService;
|
||||
protected final OssStorageService ossStorageService;
|
||||
|
||||
protected AbstractFileTaskPipeline(FileTaskMapper fileTaskMapper,
|
||||
FileResultMapper fileResultMapper,
|
||||
TaskDistributedLockService taskDistributedLockService,
|
||||
TaskFileJobService taskFileJobService,
|
||||
OssStorageService ossStorageService) {
|
||||
this.fileTaskMapper = fileTaskMapper;
|
||||
this.fileResultMapper = fileResultMapper;
|
||||
this.taskDistributedLockService = taskDistributedLockService;
|
||||
this.taskFileJobService = taskFileJobService;
|
||||
this.ossStorageService = ossStorageService;
|
||||
}
|
||||
|
||||
// ------------------------------------------------------------------
|
||||
// 钩子:实测真差异处,只有这四条
|
||||
// ------------------------------------------------------------------
|
||||
|
||||
/** 该支模块标识,全库唯一(同时是结果文件 Job 的注册键与锁键)。 */
|
||||
protected abstract String moduleType();
|
||||
|
||||
/**
|
||||
* 回传准入用任务加载:实测两派——AppearancePatent/Publish/CollectData 直接
|
||||
* {@code fileTaskMapper.selectById}(DB),ShopDataCrawl/ShopMatch/PriceTrack 走
|
||||
* 缓存优先({@link TaskFinalizeSupport#loadTaskForExecution}),DeleteBrand 用本地缓存件。
|
||||
* 派别由子类定,底座不替它选。
|
||||
*/
|
||||
protected abstract FileTaskEntity loadTaskForSubmission(Long taskId);
|
||||
|
||||
/**
|
||||
* 该支的模块缓存服务;无缓存服务的三支返回 {@code null}。
|
||||
* 返回非空时 {@link #admitSubmission} 会按现网形状打一次心跳。
|
||||
*/
|
||||
protected AbstractModuleTaskCacheService<T> taskCacheService() {
|
||||
return null;
|
||||
}
|
||||
|
||||
/**
|
||||
* 归属实例校验钩子,默认放过。现网只有 AppearancePatent{@code :2026}/
|
||||
* Publish{@code :1375}/ShopDataCrawl{@code :3114} 三支实现(多实例转发用),
|
||||
* 其余四支不校验——所以默认必须是空实现而不是抛错。
|
||||
*/
|
||||
protected void ensureTaskOwnedByCurrentInstance(FileTaskEntity task, String operation) {
|
||||
}
|
||||
|
||||
// ------------------------------------------------------------------
|
||||
// 段 1:解析建单——task 头行与结果行的落库形状
|
||||
// ------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* 建任务头行(不落库)。七支逐字相同的字段集合在此钉死:
|
||||
* {@code taskNo = <moduleType>-<雪花id>}、{@code createdBy = "user:" + userId}、
|
||||
* {@code deviceId = AdminAuthSupport.normalizeDeviceId(deviceId)}、{@code createdAt/updatedAt}
|
||||
* 取同一时刻。后者对 AppearancePatent{@code :207-208} 与 DeleteBrand{@code :156-157}
|
||||
* 是一处微差——它们各调了两次 {@code LocalDateTime.now()}(可能差几微秒),底座只取一次;
|
||||
* 两列都只用于「建单时刻」,无人拿它们互相比较,故按 Majority 的单次写法沉。
|
||||
* 出处:ShopDataCrawl{@code :575-587}/ShopMatch{@code :473-486}/Publish{@code :1054-1070}
|
||||
* /CollectData{@code :329-341}/AppearancePatent{@code :196-214}/PriceTrack{@code :501-513}
|
||||
* /DeleteBrand{@code :146-157}。
|
||||
*
|
||||
* <p>{@code taskMode} 六支 {@code "PYTHON_QUEUE"}、DeleteBrand 一支 {@code "IMMEDIATE"};
|
||||
* {@code status} 建单时各不相同——{@code RUNNING}(ShopDataCrawl/PriceTrack/DeleteBrand)、
|
||||
* {@code PENDING}(AppearancePatent/CollectData)、{@code SCHEDULED}(ShopMatch 带排期时)、
|
||||
* 乃至 Publish 在全部文件解析失败时直接 {@code FAILED}({@code :1058})。
|
||||
* 两者一律由调用方显式传入,不在底座设默认值——设了就会有人不再想它。
|
||||
*
|
||||
* <p><b>{@code successFileCount}/{@code failedFileCount} 刻意不由底座初始化</b>:建单时五支写 0
|
||||
* (AppearancePatent{@code :202-203}/ShopDataCrawl{@code :581-582}/ShopMatch{@code :479-480}/
|
||||
* PriceTrack{@code :507-508}/CollectData{@code :333-334}),Publish{@code :1060-1061} 写的是
|
||||
* 真实失败数,而 DeleteBrand{@code :146-157} 首次 insert 两列都留 NULL、到 {@code :268-278}
|
||||
* 循环后才回填。底座一旦默认写 0,就把 DeleteBrand 的「还没统计」偷换成了「零成功零失败」。
|
||||
* 其余模块专有列({@code requestJson}/{@code resultJson}/{@code scheduledAt}
|
||||
* /{@code errorMessage}/{@code finishedAt})同样请在返回的实体上继续 set,再交 {@link #insertTask}。
|
||||
*/
|
||||
protected final FileTaskEntity newTaskHeader(String status,
|
||||
String taskMode,
|
||||
Long userId,
|
||||
String deviceId,
|
||||
int sourceFileCount) {
|
||||
requireUserId(userId);
|
||||
LocalDateTime now = LocalDateTime.now();
|
||||
FileTaskEntity task = new FileTaskEntity();
|
||||
task.setTaskNo(moduleType() + "-" + IdUtil.getSnowflakeNextIdStr());
|
||||
task.setModuleType(moduleType());
|
||||
task.setTaskMode(taskMode);
|
||||
task.setStatus(status);
|
||||
task.setSourceFileCount(sourceFileCount);
|
||||
task.setCreatedBy("user:" + userId);
|
||||
task.setUserId(userId);
|
||||
task.setDeviceId(AdminAuthSupport.normalizeDeviceId(deviceId));
|
||||
task.setCreatedAt(now);
|
||||
task.setUpdatedAt(now);
|
||||
return task;
|
||||
}
|
||||
|
||||
/** 落库任务头行。主键由 {@code IdType.AUTO} 回填,返回同一实体以便调用方继续用 id。 */
|
||||
protected final FileTaskEntity insertTask(FileTaskEntity task) {
|
||||
fileTaskMapper.insert(task);
|
||||
return task;
|
||||
}
|
||||
|
||||
/**
|
||||
* 建一个「作用域结果行」(一支一店/一支一文件)。七支逐字相同的字段集合:
|
||||
* {@code taskId/moduleType/sourceFilename/sourceFileUrl/userId/createdAt}。
|
||||
* {@code rowCount} 与 {@code success} 刻意可空——现网 ShopDataCrawl{@code :598-606}
|
||||
* 与 ShopMatch{@code :496-504} 不写 rowCount,{@code success} 则有三值:
|
||||
* {@code null}(AppearancePatent{@code :229-237} 不写)、{@code 0}(多数)、
|
||||
* {@code -1}(ShopDataCrawl 的 {@code RESULT_PENDING})。底座不替它们归一。
|
||||
*
|
||||
* <p>{@code sourceFilename} 在 shop 族是店铺名、在 file 族是源文件名,
|
||||
* 且回传侧正是用它当作用域键({@code ShopMatchTaskService:674} {@code row.getSourceFilename()}),
|
||||
* 所以这里的入参就是后续 {@link #listScopeRows} 的匹配键,别传展示用的名字。
|
||||
*/
|
||||
protected final FileResultEntity newScopeRow(Long taskId,
|
||||
Long userId,
|
||||
String sourceFilename,
|
||||
String sourceFileUrl,
|
||||
Integer rowCount,
|
||||
Integer success) {
|
||||
FileResultEntity row = new FileResultEntity();
|
||||
row.setTaskId(taskId);
|
||||
row.setModuleType(moduleType());
|
||||
row.setSourceFilename(sourceFilename);
|
||||
row.setSourceFileUrl(sourceFileUrl);
|
||||
row.setRowCount(rowCount);
|
||||
row.setSuccess(success);
|
||||
row.setUserId(userId);
|
||||
row.setCreatedAt(LocalDateTime.now());
|
||||
return row;
|
||||
}
|
||||
|
||||
/**
|
||||
* 逐条插入结果行。<b>刻意不批插</b>:PriceTrack{@code :524-527} 的注释写明了原因——
|
||||
* 后续要用 {@code useGeneratedKeys} 回填的 {@code resultId} 去挂载荷,批插拿不到逐行主键。
|
||||
*/
|
||||
protected final List<FileResultEntity> insertScopeRows(List<FileResultEntity> rows) {
|
||||
List<FileResultEntity> saved = new ArrayList<>(rows.size());
|
||||
for (FileResultEntity row : rows) {
|
||||
fileResultMapper.insert(row);
|
||||
saved.add(row);
|
||||
}
|
||||
return saved;
|
||||
}
|
||||
|
||||
// ------------------------------------------------------------------
|
||||
// 段 3:回传落库——准入序列
|
||||
// ------------------------------------------------------------------
|
||||
|
||||
/** {@code taskId} 非法即拒。出处:ShopDataCrawl{@code :619}/ShopMatch{@code :631}/PriceTrack{@code :592}。 */
|
||||
protected final void requireTaskId(Long taskId) {
|
||||
if (taskId == null || taskId <= 0) {
|
||||
throw new BusinessException("taskId 不合法");
|
||||
}
|
||||
}
|
||||
|
||||
/** {@code user_id} 非法即拒;七支文案逐字相同({@code user_id 不合法})。 */
|
||||
protected final void requireUserId(Long userId) {
|
||||
if (userId == null || userId <= 0) {
|
||||
throw new BusinessException("user_id 不合法");
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 取任务分布式锁,竞争即 {@link BusinessCodes#TASK_BUSY} 拒绝(不静默降级)。
|
||||
* 委托既有 {@link TaskFinalizeSupport#acquireTaskLockOrThrow},不另立一套锁语义。
|
||||
*/
|
||||
protected final TaskDistributedLockService.LockHandle acquireSubmissionLockOrThrow(Long taskId, String logTag) {
|
||||
return TaskFinalizeSupport.acquireTaskLockOrThrow(taskDistributedLockService, moduleType(), taskId, logTag);
|
||||
}
|
||||
|
||||
/** 带等待时长的变体(CollectData/ShopDataCrawl 等自有 {@code TASK_LOCK_WAIT_MILLIS})。 */
|
||||
protected final TaskDistributedLockService.LockHandle acquireSubmissionLockOrThrow(Long taskId,
|
||||
String logTag,
|
||||
long waitMillis) {
|
||||
TaskDistributedLockService.LockHandle lockHandle =
|
||||
TaskFinalizeSupport.acquireTaskLock(taskDistributedLockService, moduleType(), taskId, waitMillis);
|
||||
if (lockHandle == null) {
|
||||
log.warn("[{}] 任务锁竞争,拒绝本次提交 taskId={}", logTag, taskId);
|
||||
throw new BusinessException(BusinessCodes.TASK_BUSY, "任务正在处理中,请稍后再试");
|
||||
}
|
||||
return lockHandle;
|
||||
}
|
||||
|
||||
/**
|
||||
* 回传准入:校验 taskId → 加载任务 → 模块校验 → 终态拒绝 → 归属校验 → 心跳。
|
||||
* 出处:ShopMatch{@code :647-655} 对 PriceTrack{@code :597-605} 除终态那格的日志外逐字相同;
|
||||
* ShopDataCrawl{@code :627-636} 同形但步序相反(见下)。
|
||||
*
|
||||
* <p>终态怎么拒由 {@code terminalRejection} 决定(见 {@link TerminalRejection} 的线协议后果),
|
||||
* 归属校验是否发生由 {@code ownershipOperation} 决定(传 {@code null} = 不校验,
|
||||
* 对应现网 ShopMatch/PriceTrack/DeleteBrand/CollectData 四支不查归属)。
|
||||
*
|
||||
* <p><b>步序按 ShopMatch/PriceTrack 定:终态判定在归属校验之前。</b>ShopDataCrawl 现网是反的
|
||||
* ({@code :631} 先查归属、{@code :632} 再判终态),一支既被别人持有又已终态的任务,
|
||||
* 走它会得 {@code TaskOwnerMismatchException}、走本方法是终态拒绝。所以 ShopDataCrawl 迁移时
|
||||
* 要么保留自己的步序(传 {@code null} 后自查归属),要么把这条差异单独立账,
|
||||
* 不许悄悄套用本默认序就算迁完。
|
||||
*
|
||||
* <p><b>本方法不打日志</b>:七支里只有 PriceTrack{@code :602} 在终态拒绝前打一行 warn,
|
||||
* 其余六支沉默。日志不是公共形状,所以那一行留在它自己的调用点,别当成已沉掉后把它删了。
|
||||
*/
|
||||
protected final FileTaskEntity admitSubmission(Long taskId,
|
||||
TerminalRejection terminalRejection,
|
||||
String ownershipOperation) {
|
||||
requireTaskId(taskId);
|
||||
FileTaskEntity task = loadTaskForSubmission(taskId);
|
||||
if (task == null || !moduleType().equals(task.getModuleType())) {
|
||||
throw new BusinessException("任务不存在");
|
||||
}
|
||||
String status = task.getStatus();
|
||||
if ("SUCCESS".equals(status) || "FAILED".equals(status)) {
|
||||
if (terminalRejection == TerminalRejection.IDEMPOTENT) {
|
||||
throw new BusinessException(BusinessCodes.TASK_ALREADY_FINISHED, "任务已结束,拒绝重复提交");
|
||||
}
|
||||
throw new BusinessException("任务已结束,拒绝重复提交");
|
||||
}
|
||||
if (ownershipOperation != null) {
|
||||
ensureTaskOwnedByCurrentInstance(task, ownershipOperation);
|
||||
}
|
||||
AbstractModuleTaskCacheService<T> cacheService = taskCacheService();
|
||||
if (cacheService != null) {
|
||||
cacheService.touchTaskHeartbeat(taskId);
|
||||
}
|
||||
return task;
|
||||
}
|
||||
|
||||
/**
|
||||
* 该任务的全部结果行,按主键升序——回传侧的作用域匹配与收尾判定都依赖这个顺序。
|
||||
* 出处:ShopMatch{@code :656-659}/PriceTrack{@code :606-610}/DeleteBrand 同款 selectList。
|
||||
*/
|
||||
protected final List<FileResultEntity> listScopeRows(Long taskId) {
|
||||
return fileResultMapper.selectList(new LambdaQueryWrapper<FileResultEntity>()
|
||||
.eq(FileResultEntity::getTaskId, taskId)
|
||||
.eq(FileResultEntity::getModuleType, moduleType())
|
||||
.orderByAsc(FileResultEntity::getId));
|
||||
}
|
||||
|
||||
/**
|
||||
* 挂一个结果文件组装 Job。{@code scopeKey} 实测是<b>四形</b>的,不是笔误:
|
||||
* 归属实例域 {@code task:{id}:owner:{instance}}(Publish{@code :1046/:1216}、
|
||||
* ShopDataCrawl{@code :1920}、AppearancePatent{@code :1753})/固定 {@code task:{id}}
|
||||
* (CollectData{@code :1122})/店铺名(ShopMatch{@code :883}、PriceTrack{@code :905})
|
||||
* /文件身份(DeleteBrand{@code :1505/:1770})。底座只转发,不解释形状。
|
||||
*/
|
||||
protected final void enqueueResultAssembly(Long taskId, Long resultId, String scopeKey) {
|
||||
taskFileJobService.enqueueAssembleResult(taskId, moduleType(), resultId, scopeKey);
|
||||
}
|
||||
|
||||
// ------------------------------------------------------------------
|
||||
// 段 4:出结果——上传与结果行 6 列落库
|
||||
// ------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* 把已组装好的结果文件上传对象存储,并写回结果行的 6 列后落库。
|
||||
* 出处(六支同形):ShopMatch{@code :828-840}/PriceTrack{@code :845-857}/
|
||||
* Publish{@code :590-598}/CollectData{@code :1166-1190}/AppearancePatent{@code :1876}
|
||||
* /DeleteBrand{@code :1921-1929}。
|
||||
*
|
||||
* <p><b>ShopDataCrawl 不在此件适用范围内</b>:它写 5 列走的是另一条路——
|
||||
* {@code updateResultFileColumns:1880-1892} 用 {@code LambdaUpdateWrapper} 按 id 集合批量
|
||||
* {@code .in(ids).eq(success, RESULT_SUCCESS).set(...)},既不 {@code updateById} 载入的实体、
|
||||
* 不写 {@code success}/{@code errorMessage},还会在 {@code :1919} 传 {@code objectKey=null}
|
||||
* (终态无工作簿那格)。硬套本方法会把它的「只刷成功行、不动状态位」语义改掉,
|
||||
* 故 3B 迁移那一支必须保留本地写法,别把这句读成「七支都能换」。
|
||||
*
|
||||
* <p>{@code preserveFailure} 是 ShopMatch/PriceTrack 的「失败店铺部分结果」语义:
|
||||
* 结果行已带 {@code errorMessage} 时只挂文件、{@code success} 保持 0,
|
||||
* 否则组装一落地就把行“洗成成功”,用户再也看不到「这个店铺其实没跑完」
|
||||
* (原注释见 {@code ShopMatchTaskService:823-825})。其余五支恒传 {@code false}
|
||||
* (它们无条件 {@code success=1} 并清 {@code errorMessage})。
|
||||
*
|
||||
* <p><b>临时文件不由本方法删</b>:现网七支的清理点不同(有的在本层 {@code finally}、
|
||||
* 有的在外层),谁上传谁负责,与本类 javadoc 说的「只沉逐字相同那截」一致。
|
||||
*/
|
||||
protected final void publishResultFile(FileResultEntity row,
|
||||
File resultFile,
|
||||
String filename,
|
||||
String contentType,
|
||||
int rowCount,
|
||||
boolean preserveFailure) {
|
||||
String objectKey = ossStorageService.uploadResultFile(resultFile, moduleType());
|
||||
if (preserveFailure) {
|
||||
row.setSuccess(0);
|
||||
} else {
|
||||
row.setSuccess(1);
|
||||
row.setErrorMessage(null);
|
||||
}
|
||||
row.setResultFilename(filename);
|
||||
row.setResultFileUrl(objectKey);
|
||||
row.setResultFileSize(resultFile.length());
|
||||
row.setResultContentType(contentType);
|
||||
row.setRowCount(rowCount);
|
||||
fileResultMapper.updateById(row);
|
||||
}
|
||||
}
|
||||
+149
@@ -0,0 +1,149 @@
|
||||
package com.nanri.aiimage.modules.task.service.pipeline;
|
||||
|
||||
import com.nanri.aiimage.common.exception.BusinessException;
|
||||
import com.nanri.aiimage.modules.file.service.oss.OssStorageService;
|
||||
import com.nanri.aiimage.modules.task.mapper.FileResultMapper;
|
||||
import com.nanri.aiimage.modules.task.mapper.FileTaskMapper;
|
||||
import com.nanri.aiimage.modules.task.model.entity.FileResultEntity;
|
||||
import com.nanri.aiimage.modules.task.model.entity.FileTaskEntity;
|
||||
import com.nanri.aiimage.modules.task.service.TaskDistributedLockService;
|
||||
import com.nanri.aiimage.modules.task.service.TaskFileJobService;
|
||||
|
||||
import java.util.LinkedHashMap;
|
||||
import java.util.List;
|
||||
import java.util.Map;
|
||||
import java.util.function.Function;
|
||||
|
||||
/**
|
||||
* 「店铺维度合并载荷」家族的回传落库(段 3)骨架——{@link AbstractFileTaskPipeline} 的家族层。
|
||||
*
|
||||
* <p><b>为什么只有这一族值得再下一层。</b>2026-10-18 实贴七支的 {@code submitResult},
|
||||
* 合并模型实测分三族:chunk+scope(AppearancePatent/Publish/CollectData)、
|
||||
* shop-payload(ShopDataCrawl/ShopMatch/PriceTrack)、DeleteBrand 自有分片存储。
|
||||
* 其中 <b>ShopMatch 与 PriceTrack 两支的 {@code submitResult} 是行级孪生件</b>:
|
||||
* 校验→取锁→准入→按店铺名建索引→逐行合并→{@code changed} 闸门→重读结果行→重算任务状态
|
||||
* 整段结构一致({@code ShopMatchTaskService:630-710} 对 {@code PriceTrackTaskService:591-663}),
|
||||
* 差异全在「单行怎么处理」那一步里。ShopDataCrawl 只共用「准入」与「用
|
||||
* {@code row.sourceFilename} 当作用域匹配键」这两件事({@code :644-648}):它的索引是自建的
|
||||
* {@code normalizePayloadByShop(shops, 首行店铺名)}({@code :641}),尾部<b>没有</b> {@code changed}
|
||||
* 闸门而是无条件 {@code persistProgressOrSnapshot}+{@code tryFinalizeTask}({@code :679-681}),
|
||||
* 单行体整段走快照机——所以本模板对 ShopDataCrawl <b>不适用</b>,那一支保留自己的写法。
|
||||
*
|
||||
* <p><b>刻意不沉的两处</b>(沉了就是替现网做决定,Phase 3 会拿不到行为对撞):
|
||||
* <ul>
|
||||
* <li>单行处理体:ShopMatch 先合并再判 {@code error}({@code :680-684}),PriceTrack 先判
|
||||
* {@code error} 与 {@code success==FALSE} 再合并({@code :627-636}),且 PriceTrack 多一段
|
||||
* {@code handleSkipAsinDeletionSignals}——合并时机与副作用顺序不同,抽成一个钩子实现,
|
||||
* 两套语义各自保留。</li>
|
||||
* <li>结果簿组装:两支的 {@code assembleShopResult} 近乎相同,但各自吃
|
||||
* {@code ShopMatchExcelAssemblyService}/{@code PriceTrackExcelAssemblyService} 两种类型,
|
||||
* 合并它们要先造一个装配服务接口=新立抽象。两支共同的「上传+6 列落库」那截
|
||||
* 已由 {@link AbstractFileTaskPipeline#publishResultFile} 承接。</li>
|
||||
* </ul>
|
||||
*
|
||||
* <p>店铺名归一化留成钩子:两支现网都调 {@code ZiniaoShopSwitchService.normalizeShopName}
|
||||
* ({@code ShopMatchTaskService:665}/{@code PriceTrackTaskService:614}),但该 bean 在
|
||||
* {@code modules.ziniao} 下,底座直接依赖它会把 task→业务 的冻结线(0)顶开。
|
||||
*/
|
||||
public abstract class AbstractShopPayloadTaskPipeline<T> extends AbstractFileTaskPipeline<T> {
|
||||
|
||||
protected AbstractShopPayloadTaskPipeline(FileTaskMapper fileTaskMapper,
|
||||
FileResultMapper fileResultMapper,
|
||||
TaskDistributedLockService taskDistributedLockService,
|
||||
TaskFileJobService taskFileJobService,
|
||||
OssStorageService ossStorageService) {
|
||||
super(fileTaskMapper, fileResultMapper, taskDistributedLockService,
|
||||
taskFileJobService, ossStorageService);
|
||||
}
|
||||
|
||||
/**
|
||||
* 店铺名归一化(同时是结果行 {@code sourceFilename} 与载荷索引键的构造规则)。
|
||||
* 两支必须用同一规则建与查,否则回传永远匹配不上行。
|
||||
*/
|
||||
protected abstract String normalizeShopKey(String rawShopName);
|
||||
|
||||
/**
|
||||
* 单行处理:合并该店铺载荷,并按各自现网语义决定「失败置位/等待更多分片/挂组装 Job」。
|
||||
* 调用即代表本次回传命中了该行({@code changed} 由模板在调用前置位,与两支现网一致)。
|
||||
*/
|
||||
protected abstract void applyShopResultRow(Long taskId,
|
||||
FileTaskEntity task,
|
||||
FileResultEntity row,
|
||||
String shopKey,
|
||||
T incoming);
|
||||
|
||||
/** 本轮有行被命中后的收尾:两支现网都是拿最新结果行重算任务状态。 */
|
||||
protected abstract void onShopRowsRecomputed(FileTaskEntity task, List<FileResultEntity> latestRows);
|
||||
|
||||
/**
|
||||
* 锁竞争日志标签。历史值是各支小写短名({@code shop-match}/{@code price-track}/
|
||||
* {@code shop-data-crawl}),与 {@link #moduleType()} 的大写枚举形不同,
|
||||
* 默认返回 moduleType 仅供未覆写时不缺标签,两支迁移时必须按历史值覆写。
|
||||
*/
|
||||
protected String submissionLockLogTag() {
|
||||
return moduleType();
|
||||
}
|
||||
|
||||
/**
|
||||
* 段 3「回传落库」整段骨架。入参 {@code incoming} 即各支请求里的 {@code shops} 列表。
|
||||
*
|
||||
* <p>闸门与终态拒绝形状由 {@code terminalRejection} 决定;{@code ownershipOperation}
|
||||
* 传 {@code null} 表示不校验归属(两支现网都不校验)。
|
||||
*
|
||||
* <p>结果行匹配键取 {@code row.getSourceFilename()},因此建单时写进该列的必须是
|
||||
* {@link #normalizeShopKey(String)} 归一化后的店铺名({@code ShopMatchTaskService:499}
|
||||
* 与 {@code PriceTrackTaskService:534} 正是这么写的)。
|
||||
*
|
||||
* <p><b>校验在取锁之前</b>(按 PriceTrack{@code :592-596} 的形状):ShopMatch 现网把
|
||||
* {@code shops} 非空检查放在锁内({@code :634} 取锁 → {@code :643} 才检查)。两者对调用方
|
||||
* 的可见结果相同,本模板选前者是为了「明显不合法的请求不去抢锁」。迁移这一支时把这句
|
||||
* 微差登记在案,别让它变成「顺手改的」没人知道。
|
||||
*/
|
||||
protected final void submitShopScopedResults(Long taskId,
|
||||
List<T> incoming,
|
||||
Function<T, String> rawShopNameOf,
|
||||
TerminalRejection terminalRejection,
|
||||
String ownershipOperation) {
|
||||
requireTaskId(taskId);
|
||||
if (incoming == null || incoming.isEmpty()) {
|
||||
throw new BusinessException("shops 不能为空");
|
||||
}
|
||||
try (TaskDistributedLockService.LockHandle ignored =
|
||||
acquireSubmissionLockOrThrow(taskId, submissionLockLogTag())) {
|
||||
FileTaskEntity task = admitSubmission(taskId, terminalRejection, ownershipOperation);
|
||||
Map<String, T> payloadByShopKey = indexByShopKey(incoming, rawShopNameOf);
|
||||
boolean changed = false;
|
||||
for (FileResultEntity row : listScopeRows(taskId)) {
|
||||
String shopKey = row.getSourceFilename();
|
||||
T item = shopKey == null ? null : payloadByShopKey.get(shopKey);
|
||||
if (item == null) {
|
||||
continue;
|
||||
}
|
||||
changed = true;
|
||||
applyShopResultRow(taskId, task, row, shopKey, item);
|
||||
}
|
||||
if (!changed) {
|
||||
return;
|
||||
}
|
||||
onShopRowsRecomputed(task, listScopeRows(taskId));
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 回传载荷按店铺名建索引:跳过 null 项与归一化后为空的项,保持请求顺序。
|
||||
* 出处:{@code ShopMatchTaskService:660-669}/{@code PriceTrackTaskService:611-616}(逐字同形)。
|
||||
*/
|
||||
protected final Map<String, T> indexByShopKey(List<T> incoming, Function<T, String> rawShopNameOf) {
|
||||
Map<String, T> indexed = new LinkedHashMap<>();
|
||||
for (T item : incoming) {
|
||||
if (item == null) {
|
||||
continue;
|
||||
}
|
||||
String shopKey = normalizeShopKey(rawShopNameOf.apply(item));
|
||||
if (shopKey != null && !shopKey.isBlank()) {
|
||||
indexed.put(shopKey, item);
|
||||
}
|
||||
}
|
||||
return indexed;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user