refactor(phase-3): ShopDataCrawl 接入底座,家族层按证据不接——三支接得上、两处接不上写死
七支巨石里第三支接进 AbstractFileTaskPipeline。它接的是**底座**、不是 shop-payload 家族层: 家族模板 submitShopScopedResults 要求「按店名自建索引→逐行→changed 闸门→重算」,本支三条都不成立 (索引自建且带「回传店铺与任务不匹配」这道拒、单店合同 resultRows.size()!=1、尾部无 changed 闸门 而是无条件 persistProgressOrSnapshot+tryFinalizeTask)。照家族层套就是替它改行为。 本支复用底座的六件:newTaskHeader/newScopeRow(带显式时刻那一版——建单时刻一枚复用给头行与每一行, 默认时区逐行各取那一版会把这格改掉)、insertTask、listScopeRows(本地 listTaskRows 与孪生两支逐字同形,删)、 requireUserId(本地 validateUserId 逐字同形,删)、requireTaskId、writeJson(第四份同名件并进来, 捕获账净减:RETHROW 386→385 按该尺自述的「逐条点名改基线」处置,出处与授权逐字写进 CatchSilenceRatchetTest 注释;total 1002、不重抛/只 log/空体三格未涨)。 两处「按证据不做」写进代码而不是只留在注释里: 1)准入步序现网先归属后终态,与底座默认序相反 ⇒ 为它把 admitSubmission 拆成 requireSubmissionTask/rejectTerminalSubmission/touchSubmissionHeartbeat 三格、按本支的序复用; 孪生两支走的默认序一个字没动,它们的 golden 就是这条等值的证明。 2)收尾刷结果列走 LambdaUpdateWrapper 批量条件更新(只刷 success=1 的行、不写 success/errorMessage、 objectKey 传 null)⇒ publishResultFile 仍不适用,本地写法保留。 代价要说在白处:显式构造器是继承的结构性成本,本支 23 枚参数(孪生两支 17/15), ShopDataCrawlTaskService 3196→3215 行——这一格在 readability 棘轮上是**涨**, 与 Phase 3「只许降」那条准出标准相冲,不自行改基线判据、留给用户拍板。 对撞证据:本支两条新 golden(建单 14 例/回传 20 例)+孪生两支四条 golden 迁移前后逐字节相等, git status -- src/test/resources 一字未动;后端全量 mvn -o test 绿。
This commit is contained in:
+52
-19
@@ -48,8 +48,9 @@ import java.util.List;
|
||||
* {@code writeJson(Object, String)} 就是带文案参数的形状。
|
||||
* ⚠ task 模块内部那三份逐字同名件({@code TaskProgressSnapshotService:186}/
|
||||
* {@code TaskResultItemService:405}/{@code TaskResultPayloadService:113})<b>本轮仍未归并</b>:
|
||||
* 归并会把 RETHROW 那一格跌破下限(它是下限不是上限,实测首迁后正好落在 386),
|
||||
* 那属于「调整门禁判据」动作,与 Phase 0 那格「三格守卫」同批做,不在迁移笔里顺手干。</li>
|
||||
* 归并会把 RETHROW 那一格跌破下限(它是下限不是上限;首迁后落在 386,3B 并掉 ShopDataCrawl
|
||||
* 那份私有同名件后按「逐条点名改基线」调到 385,出处写在 {@code CatchSilenceRatchetTest}),
|
||||
* 再往下降就属于「调整门禁判据」动作,与 Phase 0 那格「三格守卫」同批做,不在迁移笔里顺手干。</li>
|
||||
* <li><b>跑批</b>:服务端<b>没有属于这七支的可沉件</b>——机制早已收在
|
||||
* {@link TaskFileJobService}(enqueue/claim/markSuccess/markFailed)+
|
||||
* {@code TaskResultFileJobWorker}(取锁、重排、重试)+
|
||||
@@ -357,9 +358,11 @@ public abstract class AbstractFileTaskPipeline<T> {
|
||||
*
|
||||
* <p><b>步序按 ShopMatch/PriceTrack 定:终态判定在归属校验之前。</b>ShopDataCrawl 现网是反的
|
||||
* ({@code :631} 先查归属、{@code :632} 再判终态),一支既被别人持有又已终态的任务,
|
||||
* 走它会得 {@code TaskOwnerMismatchException}、走本方法是终态拒绝。所以 ShopDataCrawl 迁移时
|
||||
* 要么保留自己的步序(传 {@code null} 后自查归属),要么把这条差异单独立账,
|
||||
* 不许悄悄套用本默认序就算迁完。
|
||||
* 走它会得 {@code TaskOwnerMismatchException}、走本方法是终态拒绝。3B 迁移那一支的处置是
|
||||
* <b>保留本地步序</b>:它按自己的序复用 {@link #requireSubmissionTask}/
|
||||
* {@link #rejectTerminalSubmission}/{@link #touchSubmissionHeartbeat} 三格,
|
||||
* 不整段套本方法——本方法的默认序因此一个字也没替它改,这条差异也不再只是记在注释里的口头账
|
||||
* (golden 的 {@code ownershipCheckedBeforeTerminal} 那例钉着)。
|
||||
*
|
||||
* <p><b>本方法不打日志</b>:七支里只有 PriceTrack{@code :602} 在终态拒绝前打一行 warn,
|
||||
* 其余六支沉默。日志不是公共形状,所以那一行留在它自己的调用点,别当成已沉掉后把它删了。
|
||||
@@ -368,30 +371,60 @@ public abstract class AbstractFileTaskPipeline<T> {
|
||||
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("任务已结束,拒绝重复提交");
|
||||
}
|
||||
FileTaskEntity task = requireSubmissionTask(taskId);
|
||||
rejectTerminalSubmission(task.getStatus(), terminalRejection);
|
||||
if (ownershipOperation != null) {
|
||||
ensureTaskOwnedByCurrentInstance(task, ownershipOperation);
|
||||
}
|
||||
AbstractModuleTaskCacheService<T> cacheService = taskCacheService();
|
||||
if (cacheService != null) {
|
||||
cacheService.touchTaskHeartbeat(taskId);
|
||||
touchSubmissionHeartbeat(taskId);
|
||||
return task;
|
||||
}
|
||||
|
||||
/**
|
||||
* 准入的前两行:加载+模块校验,不符即「任务不存在」。
|
||||
* 出处:ShopMatch{@code :647-650}/PriceTrack{@code :597-600}/ShopDataCrawl{@code :627-630}(三支逐字同形)。
|
||||
*
|
||||
* <p><b>为什么把它从 {@link #admitSubmission} 里拆出来。</b>3B 实测缺件:ShopDataCrawl 的准入
|
||||
* 步序与本类默认序相反(先归属后终态),整段套 {@code admitSubmission} 就会改掉那格的可见结果
|
||||
* (见方法注释里立着的账)。拆开后它按自己的序复用这三格,而 ShopMatch/PriceTrack 走的
|
||||
* 默认序一个字没动——四格合起来与拆前逐句等值,两支的 golden 就是这条等值的证明。
|
||||
*/
|
||||
protected final FileTaskEntity requireSubmissionTask(Long taskId) {
|
||||
FileTaskEntity task = loadTaskForSubmission(taskId);
|
||||
if (task == null || !moduleType().equals(task.getModuleType())) {
|
||||
throw new BusinessException("任务不存在");
|
||||
}
|
||||
return task;
|
||||
}
|
||||
|
||||
/**
|
||||
* 终态那格:怎么拒由 {@code terminalRejection} 决定(两种线协议,见 {@link TerminalRejection})。
|
||||
* 与 {@link #requireSubmissionTask} 同一笔拆开的理由——步序不同的支要能单独复用这一格。
|
||||
*/
|
||||
protected final void rejectTerminalSubmission(String status, TerminalRejection terminalRejection) {
|
||||
if (!"SUCCESS".equals(status) && !"FAILED".equals(status)) {
|
||||
return;
|
||||
}
|
||||
if (terminalRejection == TerminalRejection.IDEMPOTENT) {
|
||||
throw new BusinessException(BusinessCodes.TASK_ALREADY_FINISHED, "任务已结束,拒绝重复提交");
|
||||
}
|
||||
throw new BusinessException("任务已结束,拒绝重复提交");
|
||||
}
|
||||
|
||||
/** 有模块缓存服务的支按现网形状打一次心跳;没有的支什么都不做(见 {@link #taskCacheService()})。 */
|
||||
protected final void touchSubmissionHeartbeat(Long taskId) {
|
||||
AbstractModuleTaskCacheService<T> cacheService = taskCacheService();
|
||||
if (cacheService != null) {
|
||||
cacheService.touchTaskHeartbeat(taskId);
|
||||
}
|
||||
}
|
||||
|
||||
/**
|
||||
* 该任务的全部结果行,按主键升序——回传侧的作用域匹配与收尾判定都依赖这个顺序。
|
||||
* 出处:ShopMatch{@code :656-659}/PriceTrack{@code :606-610}/DeleteBrand 同款 selectList。
|
||||
* 3B 又并进来一支:ShopDataCrawl 本地那枚 {@code listTaskRows}(原 {@code :1194-1199})与这两家
|
||||
* 逐字同形、已删 ⇒ 真正调本件的支数现在是三(ShopMatch/PriceTrack/ShopDataCrawl),
|
||||
* 其余四支尚未迁移,别说成「七支都用它」。
|
||||
*/
|
||||
protected final List<FileResultEntity> listScopeRows(Long taskId) {
|
||||
return fileResultMapper.selectList(new LambdaQueryWrapper<FileResultEntity>()
|
||||
|
||||
Reference in New Issue
Block a user