feat(keyword-share): 新增客户端批量同步端点,保住真实使用人/时间与四级类目
工作台「关键词使用记录」与后台管理对不上,根因不是链路不通(后台现存词 426 与桌面 426 逐字相等),而是「谁、何时」两个字段在推拉两个方向上各丢一次: - 推:markInternal 把 user_name/used_time 硬写成 token 账号与服务器此刻, 历史使用记录推上去一律变成「同步账号 + 同步那一刻」; - 拉:selectRows/selectRandomUnused 投影 u.user_name,而 VO 属性叫 usedUser, 驼峰映射只会认成不存在的 userName ⇒ GET /keywords 的 usedUser 恒为 null; - 词本体:add() 从不写四级类目,且 keyword_share 侧只有 INSERT IGNORE、 没有任何 UPSERT,重复词静默 no-op。 处置: - 修 used_user 别名(两处投影); - 新增 KeywordShareMapper#upsertBatchFromSync,类目/chinese 按 COALESCE(NULLIF(VALUES(x),''),x) 非空才覆盖,更新分支不碰 user_name/add_time (那是历史归属,不由同步改写); - 新增 POST /api/keyword-share/sync/import:每行携带 usedUser/usedTime, 绕开 markInternal 复用现成 KeywordUsageMapper#upsertBatch(本就是 =VALUES(...)), 不改表结构、不加 Flyway 迁移; - used 取三态:null=不改动使用状态。按 false 处理会让「只同步词库」的一次 调用把后台已有使用记录整批删掉; - 共享 API 账号下的归属失真用服务端名单收口:命中 aiimage.keyword-share-sync .used-users 才按姓名落库且落名单里那份写法(全/半角括号归一,否则同一人被 后管拆成两个使用者);strict 默认 false,名单未填时放行并计 usedUserUnknown, 避免首次上线把全部记录静默改写成账号名。 顺带:CatchSilenceRatchetTest 要求新增 catch 必须同批净减,而宽松时间解析需要 try/catch ⇒ 把 ShopDataCrawlAdminTasksService 已有的同形状实现抽成 common/support/LooseLocalDateTimeParser 两处共用,净新增 catch 为 0,未放宽基线。 尺子:XML_STATEMENT_TOTAL 140→141,NOT_MIGRATED 点名新 insert(非 select, XML_SELECT_TOTAL 不动)。 验证:mvn -o test-compile rc=0;后端整面 mvn -o test 4892 passed/0 failed/18 skipped。 本机无 MySQL,端到端未跑,真链路待客户端联调(ops BACKLOG B44)。
This commit is contained in:
+51
@@ -0,0 +1,51 @@
|
||||
package com.nanri.aiimage.common.support;
|
||||
|
||||
import java.time.LocalDateTime;
|
||||
import java.time.format.DateTimeFormatter;
|
||||
import java.time.format.DateTimeParseException;
|
||||
import java.util.List;
|
||||
|
||||
/**
|
||||
* 宽松本地日期时间解析:兼容 {@code T}/空格分隔、可选秒与小时、尾随 {@code Z} 与小数秒。
|
||||
*
|
||||
* <p>存在的理由是「调用方给的从来不是同一个时间形状」:Flask 侧的管理接口会传
|
||||
* {@code 2026-10-25 22:59:26},Python 客户端 {@code isoformat()} 会传 {@code 2026-10-25T22:59:26},
|
||||
* 带毫秒和 UTC 后缀的也见过。收在一处,是为了让"试几种格式"这件事只有一份实现、只有一处 try/catch。</p>
|
||||
*
|
||||
* <p>解析不出来返回 {@code null},不抛异常——要不要把 null 变成 400、还是降级成服务器此刻,
|
||||
* 是调用方的业务判断,不该由解析器替它决定。</p>
|
||||
*/
|
||||
public final class LooseLocalDateTimeParser {
|
||||
|
||||
/** 按优先级逐个试;顺序即语义(先信息全的后退化到只到日)。 */
|
||||
private static final List<DateTimeFormatter> FORMATS = List.of(
|
||||
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"),
|
||||
DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm"),
|
||||
DateTimeFormatter.ofPattern("yyyy-MM-dd HH"),
|
||||
DateTimeFormatter.ofPattern("yyyy-MM-dd"));
|
||||
|
||||
private LooseLocalDateTimeParser() {
|
||||
}
|
||||
|
||||
/**
|
||||
* @return 解析结果;{@code raw} 为空或任何格式都对不上时返回 {@code null}
|
||||
*/
|
||||
public static LocalDateTime parseOrNull(String raw) {
|
||||
String value = raw == null ? "" : raw.trim();
|
||||
if (value.isEmpty()) {
|
||||
return null;
|
||||
}
|
||||
String normalized = value.replace('T', ' ')
|
||||
.replaceAll("[Zz]$", "")
|
||||
.replaceAll("\\.\\d+$", "")
|
||||
.trim();
|
||||
for (DateTimeFormatter formatter : FORMATS) {
|
||||
try {
|
||||
return LocalDateTime.parse(normalized, formatter);
|
||||
} catch (DateTimeParseException ignored) {
|
||||
// 尝试下一种格式
|
||||
}
|
||||
}
|
||||
return null;
|
||||
}
|
||||
}
|
||||
Reference in New Issue
Block a user