refactor(phase-3): 3E 第五支接入底座——接得上七件九点,接不上的六格逐格立账
DeleteBrandRunService extends AbstractFileTaskPipeline<DeleteBrandParsedFileCacheDto>:
@RequiredArgsConstructor 换显式 14 枚构造子,五枚(两支 Mapper+锁+Job+OSS)交 super,
本支不再重复声明那五个字段;moduleType()/loadTaskForSubmission() 两枚钩子落地。
接上并逐点核对的七件九点:requireUserId(:176)、newTaskHeader+insertTask(:180/183)、
newScopeRow 两处(:259/271)、requireSubmissionTask(:1372)、enqueueResultAssembly(:1516)、
listScopeRows 两处(:1609/1717)。
接不上、且都写了实测理由的六格(不是「没做」,是「做了会改行为」):
- requireTaskId:本支 :1361 文案「任务 id 不合法」≠ 底座「taskId 不合法」,且它在取锁之前
- rejectTerminalSubmission:本支 :1384 只说「任务已结束」——同一 ERROR 形内部有两种文案,
底座把文案写死了
- acquireSubmissionLockOrThrow:本支 :2249 抛不带 TASK_BUSY code 的那句,而 :1577 用
message.contains("任务正被占用,请稍后重试") 当收尾跳过的判据 ⇒ 换件=改锁竞争语义
- writeJson:本支建单走 hutool JSONUtil,压根没有 Jackson 序列化失败那一格
- publishResultFile:形状同但本支 :1916-1924 写的是可空 Integer rowCount(缓存 DTO),
底座件收 int ⇒ 套上去要么 NPE 要么把 NULL 洗成 0
- taskCacheService():DeleteBrandTaskCacheService 不继承 AbstractModuleTaskCacheService
(第二例,第一例是 AP 的兄弟抽象)⇒ 心跳那格没有承接件,admitSubmission 整段用不上
另有 :1770 那处 enqueueAssembleResult 因吃掉返回值(按 job.status/retryCount 判组装已终态
失败)也没换。底座 javadoc 的四处出处账按上述实测更正,并把 :1265 那枚会腐烂的行号指针
改成方法名指针。
拆薄同笔抵账(readability 点名基线只许降):删两枚零调用私有件 countCompletedFiles/
inNewTransaction,接走建单 12 行与结果行各 5-7 行;棘轮读数 2305→2300。本支手抄的
「!MODULE_TYPE.equals(」由 8 处降到 7 处(TaskLifecycleDebt 那格方向对)。基线一格未改。
接线:TaskServiceWiringSliceTest 加第五支(3 枚新 @Bean 桩+逐枚 assertSame 本支 9 枚私有件
+「五枚底座字段不许在本支重复声明」那条 NoSuchFieldException 断言+DELETE_BRAND 那对
moduleType 验证);顺手把这篇测试自己两处会撒谎的计数(两支/三支)改成实数。
门禁:后端全量 mvn -o test 4523 例/0 红/0 错/13 skipped,BUILD SUCCESS;两条 deletebrand
golden(run-snapshot+昨日新落 submit-result-snapshot)跑完 git status 一字未动 ⇒ 建单/解析/
载荷/回传四段对外行为零变化;定向 79 例全绿;ops 面 ruff All checks passed、readability 9 passed。
⚠ 真机启动验收(mvn -o spring-boot:run)仍未做,五支都欠着,账在 Phase 8。
This commit is contained in:
+40
-5
@@ -71,7 +71,8 @@ import java.util.List;
|
||||
* (AppearancePatent/ShopDataCrawl/ShopMatch/PriceTrack),其余三支没有——
|
||||
* 故 {@link #taskCacheService()} 默认 {@code null},心跳只在有缓存服务的支上落,
|
||||
* 与现网一致(DeleteBrand 走自家 {@code saveProgress},其缓存服务<b>不</b>继承本抽象,
|
||||
* 见 {@code DeleteBrandRunService:1265} 注释)。
|
||||
* 见 {@code DeleteBrandRunService#loadTaskForExecution} 里那句注释;3A 的 AppearancePatent
|
||||
* 是第二例——它继承的是兄弟抽象 {@code AbstractPendingRowTaskCacheService})。
|
||||
*
|
||||
* <p>依赖严格限于 task 模块内部+{@code common}+{@code modules.file},不触碰任何业务模块,
|
||||
* 满足 ArchUnit 冻结线 {@code TASK_TO_BUSINESS_BASELINE = 0}
|
||||
@@ -81,7 +82,7 @@ import java.util.List;
|
||||
@Slf4j
|
||||
public abstract class AbstractFileTaskPipeline<T> {
|
||||
|
||||
/** 终态任务被再次回传时的拒绝形状。两支差异不是文案,是线协议。 */
|
||||
/** 终态任务被再次回传时的拒绝形状。两支的主要差异是线协议,但 3E 实测:同一形内部文案也不止一种。 */
|
||||
public enum TerminalRejection {
|
||||
/**
|
||||
* 带 {@link BusinessCodes#TASK_ALREADY_FINISHED}(40901):
|
||||
@@ -91,7 +92,13 @@ public abstract class AbstractFileTaskPipeline<T> {
|
||||
IDEMPOTENT,
|
||||
/**
|
||||
* 不带 code({@code BusinessException(String)}):响应 success=false,调用方会当错误处理。
|
||||
* 现网出处:ShopDataCrawl {@code :633}/DeleteBrand {@code :1362-1374}/Publish {@code :1344}。
|
||||
* 现网出处:ShopDataCrawl {@code :633}/Publish {@code :1344}——两支文案就是本件那句
|
||||
* 「任务已结束,拒绝重复提交」。
|
||||
*
|
||||
* <p><b>3E 实测补正:{@code DeleteBrandRunService:1384} 同属不带 code 这一形,文案却只有
|
||||
* 「任务已结束」。</b>本件把文案写死了,所以那一支接不上、留本地写法(它的回传段 golden
|
||||
* {@code terminalTaskRejected} 逐字钉着这句)。Phase 2 原先把 DeleteBrand 列在本件出处里,
|
||||
* 是按「有无 code」这一维归的类,文案那一维当时没数过。
|
||||
*/
|
||||
ERROR
|
||||
}
|
||||
@@ -312,7 +319,14 @@ public abstract class AbstractFileTaskPipeline<T> {
|
||||
// 段 3:回传落库——准入序列
|
||||
// ------------------------------------------------------------------
|
||||
|
||||
/** {@code taskId} 非法即拒。出处:ShopDataCrawl{@code :619}/ShopMatch{@code :631}/PriceTrack{@code :592}。 */
|
||||
/**
|
||||
* {@code taskId} 非法即拒。出处:ShopDataCrawl{@code :619}/ShopMatch{@code :631}/PriceTrack{@code :592}。
|
||||
*
|
||||
* <p><b>3E 实测补充:这一格不是七支通用。</b>{@code DeleteBrandRunService:1361} 判据逐字相同
|
||||
* 但文案是「任务 id 不合法」(本件是「taskId 不合法」),且它把这一格放在<b>取锁之前</b>——
|
||||
* 回传段 golden 里 {@code reject:taskIdNull} 那例的 {@code lockAcquire=0} 钉的就是这个步序。
|
||||
* 文案是对外契约(golden 逐字锁着),底座只收上面那三支的形状,第五支要留本地写法。
|
||||
*/
|
||||
protected final void requireTaskId(Long taskId) {
|
||||
if (taskId == null || taskId <= 0) {
|
||||
throw new BusinessException("taskId 不合法");
|
||||
@@ -334,7 +348,17 @@ public abstract class AbstractFileTaskPipeline<T> {
|
||||
return TaskFinalizeSupport.acquireTaskLockOrThrow(taskDistributedLockService, moduleType(), taskId, logTag);
|
||||
}
|
||||
|
||||
/** 带等待时长的变体(CollectData/ShopDataCrawl 等自有 {@code TASK_LOCK_WAIT_MILLIS})。 */
|
||||
/**
|
||||
* 带等待时长的变体(CollectData/ShopDataCrawl 等自有 {@code TASK_LOCK_WAIT_MILLIS})。
|
||||
*
|
||||
* <p><b>3E 实测:这一格对 DeleteBrand 接不上,而且接上会踩掉一条本地语义。</b>
|
||||
* {@code DeleteBrandRunService:2249} 抢锁失败抛的是<b>不带 code</b> 的
|
||||
* {@code BusinessException("任务正被占用,请稍后重试")},而本件抛带 {@link BusinessCodes#TASK_BUSY}
|
||||
* 的「任务正在处理中,请稍后再试」;更要命的是它家 {@code :1577} 用
|
||||
* {@code ex.getMessage().contains("任务正被占用,请稍后重试")} 来识别「锁竞争 ⇒ 收尾跳过、不报错」。
|
||||
* 也就是说那句文案在本支内部是<b>被字符串匹配的判据</b>,换件就等于悄悄把锁竞争时的收尾
|
||||
* 从「静默跳过」改成「整条回传冒错」。golden 的 {@code lockBusyRejected} 钉着这一格。
|
||||
*/
|
||||
protected final TaskDistributedLockService.LockHandle acquireSubmissionLockOrThrow(Long taskId,
|
||||
String logTag,
|
||||
long waitMillis) {
|
||||
@@ -388,6 +412,11 @@ public abstract class AbstractFileTaskPipeline<T> {
|
||||
* 步序与本类默认序相反(先归属后终态),整段套 {@code admitSubmission} 就会改掉那格的可见结果
|
||||
* (见方法注释里立着的账)。拆开后它按自己的序复用这三格,而 ShopMatch/PriceTrack 走的
|
||||
* 默认序一个字没动——四格合起来与拆前逐句等值,两支的 golden 就是这条等值的证明。
|
||||
*
|
||||
* <p><b>3E 是这条拆格决定的第二次兑现</b>:{@code DeleteBrandRunService:1372} 也是先取锁后加载,
|
||||
* 只复用本格(它的「任务不存在」文案逐字相同),终态那格因文案不同留在本地(见
|
||||
* {@link TerminalRejection#ERROR})。没有这一格,3E 就只能整段套或整段不套——套即改行为、
|
||||
* 不套即零复用,两边都是亏。
|
||||
*/
|
||||
protected final FileTaskEntity requireSubmissionTask(Long taskId) {
|
||||
FileTaskEntity task = loadTaskForSubmission(taskId);
|
||||
@@ -454,6 +483,12 @@ public abstract class AbstractFileTaskPipeline<T> {
|
||||
* Publish{@code :590-598}/CollectData{@code :1166-1190}/AppearancePatent{@code :1876}
|
||||
* /DeleteBrand{@code :1921-1929}。
|
||||
*
|
||||
* <p><b>DeleteBrand 形状同、入参不同,本件对它接不上(3E 实测)</b>:现网
|
||||
* {@code :1916-1924} 写的是 {@code setRowCount(parsedFile.getTotalRows())},那枚
|
||||
* {@code DeleteBrandParsedFileCacheDto.totalRows} 是<b>可空 Integer</b>(缓存里读出来的载荷可能没这格),
|
||||
* 而本件收 {@code int rowCount}——换上去要么 NPE、要么把 NULL 洗成 0。本支留本地写法;
|
||||
* 把入参放宽成 {@code Integer} 属于「调整底座判据」动作,不在迁移笔里顺手干。
|
||||
*
|
||||
* <p><b>ShopDataCrawl 不在此件适用范围内</b>:它写 5 列走的是另一条路——
|
||||
* {@code updateResultFileColumns:1880-1892} 用 {@code LambdaUpdateWrapper} 按 id 集合批量
|
||||
* {@code .in(ids).eq(success, RESULT_SUCCESS).set(...)},既不 {@code updateById} 载入的实体、
|
||||
|
||||
Reference in New Issue
Block a user