package common.ecommerce.xincang.adapter; import common.ecommerce.http.HttpRequest; import common.ecommerce.http.HttpResponse; import common.ecommerce.http.HttpTransport; import common.ecommerce.http.JacksonJsonCodec; import common.ecommerce.http.TokenManager; import common.ecommerce.shared.error.PlatformBusinessException; 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.WarehouseCapability; import common.ecommerce.warehouse.WarehouseProvider; import common.ecommerce.warehouse.capability.WarehouseProduct; import common.ecommerce.warehouse.capability.WarehouseProductCapable; import common.ecommerce.warehouse.sdk.WarehouseContext; import common.ecommerce.xincang.XincangConstants; import common.ecommerce.xincang.auth.XincangTokenClient; import common.ecommerce.xincang.dto.XincangDtos; import common.ecommerce.xincang.http.XincangEnvelope; import common.ecommerce.xincang.http.XincangRateLimiter; import common.ecommerce.xincang.http.XincangRequestFactory; import java.time.Clock; import java.util.EnumSet; import java.util.LinkedHashMap; import java.util.List; import java.util.Map; /** * 信仓适配器。 * *

文档确认的鉴权方式:{@code GET /api.login?appkey=&secret=} 换取客户级 token, * 有效期 2 小时、无 refresh 接口;业务请求把 token 放在 query 参数 {@code token} 里 * (新增 / 更新产品的请求体 schema 里也要求一份,见 {@link XincangRequestFactory})。

* *

已实现能力:商品建档 / 更新({@link WarehouseCapability#PRODUCT})。 * 其余能力位不声明,门面调用会显式抛 {@code WarehouseUnsupportedCapabilityException}。

* *

适配器只持有协议与基础设施,不持有端点与凭据——两者随每次调用经 * {@code WarehouseConnection} 传入。

*/ public final class XincangAdapter implements WarehouseProductCapable { private static final String OP_PRODUCT_QUERY = "warehouse.product.query"; private static final String OP_PRODUCT_ADD = "warehouse.product.add"; private static final String OP_PRODUCT_UPDATE = "warehouse.product.update"; /** 查重时只取一页;按 SKU 过滤后通常 0~1 条。 */ private static final int PRODUCT_QUERY_LIMIT = 100; /** 信仓产品状态:0 临时产品。 */ private static final String STATE_TEMPORARY = XincangConstants.PRODUCT_STATE_TEMPORARY; private final HttpTransport transport; private final JacksonJsonCodec json; private final XincangTokenClient tokenClient; private final TokenManager tokenManager; private final XincangRequestFactory requestFactory; private final XincangRateLimiter rateLimiter; public XincangAdapter(HttpTransport transport, JacksonJsonCodec json, TokenStore tokenStore, LockProvider lockProvider, Clock clock) { this.transport = transport; this.json = json; 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()); } }; this.requestFactory = new XincangRequestFactory(json); this.rateLimiter = new XincangRateLimiter(); } @Override public String adapterId() { return XincangConstants.ADAPTER_ID; } @Override public WarehouseProvider provider() { return WarehouseProvider.XINCANG; } @Override public EnumSet capabilities() { return EnumSet.of(WarehouseCapability.PRODUCT); } /** * 取一个可用 token(缓存命中则不登录)。 * *

供健康检查与联调探针使用;业务方法接入时也应经此取 token, * 不要在适配器外自行缓存。

* * @throws common.ecommerce.shared.error.AuthException 登录被拒或令牌结构不符合文档 */ public AccessToken login(WarehouseContext ctx) { return tokenManager.getOrRefresh(tokenKey(ctx.secret()), ctx.secret()); } // ------------------------------------------------------------------ 商品 /** * 创建或更新商品。 * *

信仓没有 upsert 接口,按「先查临时产品、有则更新、无则新增」实现:

* * * @return {@code status} 为 {@code ADDED} / {@code UPDATED},{@code rawStatus} 为信仓产品状态码 * @throws PlatformBusinessException 信仓业务失败(SKU / 条码重复、参数不合法等) */ @Override public ProductResult createOrUpdate(WarehouseContext ctx, WarehouseProduct product) { AccessToken token = login(ctx); XincangDtos.ProductRequest body = XincangProductMapper.toRequest(product, token.value()); boolean existsAsTemporary = findTemporaryProduct(ctx, token, body.productNo) != null; if (existsAsTemporary) { execute(ctx, XincangConstants.PATH_PRODUCT_UPDATE, body, token, OP_PRODUCT_UPDATE); return ProductResult.of(body.productNo, "UPDATED", STATE_TEMPORARY); } execute(ctx, XincangConstants.PATH_PRODUCT_ADD, body, token, OP_PRODUCT_ADD); return ProductResult.of(body.productNo, "ADDED", STATE_TEMPORARY); } /** * 查该 SKU 是否已是临时产品。 * *

{@code api.productlist} 的 {@code key} 是 SKU 过滤条件,但文档没说是否精确匹配, * 这里再按 {@code product_no} 精确比对一次。

*/ private XincangDtos.ProductListItem findTemporaryProduct(WarehouseContext ctx, AccessToken token, String sku) { Map params = new LinkedHashMap<>(); params.put("state", 0); params.put("page", 1); params.put("limit", PRODUCT_QUERY_LIMIT); params.put("key", sku); String raw = executeGet(ctx, XincangConstants.PATH_PRODUCT_LIST, params, token, OP_PRODUCT_QUERY); List items = json.listAt(raw, "rst.data", XincangDtos.ProductListItem.class); for (XincangDtos.ProductListItem item : items) { if (sku.equals(item.productNo)) { return item; } } return null; } // ------------------------------------------------------------------ internals /** 写接口:JSON 请求体(含 token)+ query token。 */ private String execute(WarehouseContext ctx, String path, Object body, AccessToken token, String operation) { rateLimiter.acquire(path, XincangConstants.PERMITS_PER_SECOND); HttpRequest req = requestFactory.postJsonWithToken(ctx.endpointBaseUrl(), path, json.toJson(body), token.value(), operation); HttpResponse resp = transport.execute(req); return XincangEnvelope.of(resp, json, operation, ctx.requestId()).body(); } /** 读接口:query token。 */ private String executeGet(WarehouseContext ctx, String path, Map params, AccessToken token, String operation) { rateLimiter.acquire(path, XincangConstants.PERMITS_PER_SECOND); HttpRequest req = requestFactory.getWithToken(ctx.endpointBaseUrl(), path, params, token.value(), operation); HttpResponse resp = transport.execute(req); return XincangEnvelope.of(resp, json, operation, ctx.requestId()).body(); } /** * 令牌缓存维度:信仓 token 按客户(appkey)发放,同一 appkey 下多仓共用一个 token。 * *

用 appkey 而不是 {@code warehouseCode},避免同客户多仓重复登录。

*/ static String tokenKey(ChannelSecret secret) { return XincangConstants.ADAPTER_ID + ":" + secret.appKey(); } }