You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

87 lines
3.5 KiB

package common.ecommerce.xincang.adapter;
import common.ecommerce.http.HttpTransport;
import common.ecommerce.http.JsonCodec;
import common.ecommerce.http.TokenManager;
import common.ecommerce.shared.spi.AccessToken;
import common.ecommerce.shared.spi.ChannelSecret;
import common.ecommerce.shared.spi.LockProvider;
import common.ecommerce.shared.spi.TokenStore;
refactor(warehouse): 枚举下沉 core + 平台枚举分层映射 枚举原来散在各模型内部(OutboundStatus 嵌在 OutboundOrder 里、DealMethod 嵌在 ReturnCommand 里),且直接带仓方的数字码,导致 core 知道运去哪的协议值。改成两层: - 底层枚举(warehouse-sdk-core/enums):只含 SDK 自编稳定 code + 中文名, 不认识任何仓的码值。code 从 10 起按 10 递增、只追加不重排,落库用。 - 平台枚举(warehouse-sdk-yqn/enums):带仓方原始码,toCore() 映射到底层。 运去哪出库状态是自由文本(无码表),按关键字收敛;其余按文档码表 1:1。 Mapper 里 9 个散落的 switch 全部删除,改为一行 of(raw).toCore()。 顺带修两处会误导下游的问题: - OutboundStatus 缺 UNKNOWN,认不出的状态被兜底成 SUBMITTED(已下发)。 补 UNKNOWN(0, rank=-1),认不出归它;对应测试断言一并修正, 新增 unknownStatusIsNotGuessed 覆盖 null / 空串 / 未知值。 - InboundOrder / TransferOrder / WarehouseReturn / BillingDocument 缺 sourceProvider,rawStatus 无法解释(同一数字在不同仓含义不同)。补上字段, 运去哪的 Mapper 全部标注 YQN。 落库契约写进 WarehouseSink:rawStatus 必须与 sourceProvider 成对保存, 它是映射调整后唯一能重跑、修正历史数据的依据。 删除 WarehouseEnum 接口——在该规模下各枚举自带 code()/label()/ofCode() 足够, 不引入额外抽象。合并 ReturnDisposition 到 ReturnProcessDisposition(后者加 UNKNOWN),退货只保留「预约预报」与「检验后决定」两套语义。 Co-Authored-By: Claude <noreply@anthropic.com>
2 weeks ago
import common.ecommerce.warehouse.enums.WarehouseCapability;
import common.ecommerce.warehouse.enums.WarehouseProvider;
import common.ecommerce.warehouse.sdk.WarehouseAdapter;
import common.ecommerce.warehouse.sdk.WarehouseContext;
import common.ecommerce.xincang.XincangConstants;
import common.ecommerce.xincang.auth.XincangTokenClient;
import java.time.Clock;
import java.util.EnumSet;
/**
* 信仓适配器(本期只做登录换 token)。
*
* <p>文档确认的鉴权方式:{@code GET /api.login?appkey=&secret=} 换取客户级 token,
* 有效期 2 小时、无 refresh 接口;业务请求把 token 放在 query 参数 {@code token} 里。
* 本轮只落地登录与令牌缓存,出库 / 库存 / 预报等能力位<b>一律不声明</b>,
* 门面调用这些能力会显式抛 {@code WarehouseUnsupportedCapabilityException}。</p>
*
* <p>适配器只持有协议与基础设施,不持有端点与凭据——两者随每次调用经
* {@code WarehouseConnection} 传入。</p>
*/
public final class XincangAdapter implements WarehouseAdapter {
private final XincangTokenClient tokenClient;
private final TokenManager tokenManager;
public XincangAdapter(HttpTransport transport, JsonCodec json,
TokenStore tokenStore, LockProvider lockProvider, Clock clock) {
this.tokenClient = new XincangTokenClient(transport, json, clock);
// 信仓 token 2h、无 refresh 接口:到期前 10 分钟重新登录换取;
// TokenManager 负责锁内防击穿与缓存读写,缓存键按 appkey(客户级)。
this.tokenManager = new TokenManager(tokenStore, lockProvider, clock,
XincangConstants.TOKEN_EARLY_REFRESH_SECONDS) {
@Override
protected AccessToken refresh(ChannelSecret secret, AccessToken previous) {
return tokenClient.fetch(secret.endpointBaseUrl(), secret.appKey(), secret.appSecret());
}
};
}
@Override
public String adapterId() {
return XincangConstants.ADAPTER_ID;
}
@Override
public WarehouseProvider provider() {
return WarehouseProvider.XINCANG;
}
/** 本期没有已实现的能力;后续接入业务接口时再逐个声明。 */
@Override
public EnumSet<WarehouseCapability> capabilities() {
return EnumSet.noneOf(WarehouseCapability.class);
}
/**
* 取一个可用 token(缓存命中则不登录)。
*
* <p>供健康检查与联调探针使用;业务方法接入时也应经此取 token,
* 不要在适配器外自行缓存。</p>
*
* @throws common.ecommerce.shared.error.AuthException 登录被拒或令牌结构不符合文档
*/
public AccessToken login(WarehouseContext ctx) {
return tokenManager.getOrRefresh(tokenKey(ctx.secret()), ctx.secret());
}
/**
* 令牌缓存维度:信仓 token 按客户(appkey)发放,同一 appkey 下多仓共用一个 token。
*
* <p>用 appkey 而不是 {@code warehouseCode},避免同客户多仓重复登录。</p>
*/
static String tokenKey(ChannelSecret secret) {
return XincangConstants.ADAPTER_ID + ":" + secret.appKey();
}
}