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; 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)。 * *
文档确认的鉴权方式:{@code GET /api.login?appkey=&secret=} 换取客户级 token, * 有效期 2 小时、无 refresh 接口;业务请求把 token 放在 query 参数 {@code token} 里。 * 本轮只落地登录与令牌缓存,出库 / 库存 / 预报等能力位一律不声明, * 门面调用这些能力会显式抛 {@code WarehouseUnsupportedCapabilityException}。
* *适配器只持有协议与基础设施,不持有端点与凭据——两者随每次调用经 * {@code WarehouseConnection} 传入。
*/ 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供健康检查与联调探针使用;业务方法接入时也应经此取 token, * 不要在适配器外自行缓存。
* * @throws common.ecommerce.shared.error.AuthException 登录被拒或令牌结构不符合文档 */ public AccessToken login(WarehouseContext ctx) { return tokenManager.getOrRefresh(tokenKey(ctx.secret()), ctx.secret()); } /** * 令牌缓存维度:信仓 token 按客户(appkey)发放,同一 appkey 下多仓共用一个 token。 * *用 appkey 而不是 {@code warehouseCode},避免同客户多仓重复登录。
*/ static String tokenKey(ChannelSecret secret) { return XincangConstants.ADAPTER_ID + ":" + secret.appKey(); } }