|
|
|
|
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;
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 信仓适配器。
|
|
|
|
|
*
|
|
|
|
|
* <p>文档确认的鉴权方式:{@code GET /api.login?appkey=&secret=} 换取客户级 token,
|
|
|
|
|
* 有效期 2 小时、无 refresh 接口;业务请求把 token 放在 query 参数 {@code token} 里
|
|
|
|
|
* (新增 / 更新产品的请求体 schema 里也要求一份,见 {@link XincangRequestFactory})。</p>
|
|
|
|
|
*
|
|
|
|
|
* <p>已实现能力:商品建档 / 更新({@link WarehouseCapability#PRODUCT})。
|
|
|
|
|
* 其余能力位不声明,门面调用会显式抛 {@code WarehouseUnsupportedCapabilityException}。</p>
|
|
|
|
|
*
|
|
|
|
|
* <p>适配器只持有协议与基础设施,不持有端点与凭据——两者随每次调用经
|
|
|
|
|
* {@code WarehouseConnection} 传入。</p>
|
|
|
|
|
*/
|
|
|
|
|
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<WarehouseCapability> capabilities() {
|
|
|
|
|
return EnumSet.of(WarehouseCapability.PRODUCT);
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 取一个可用 token(缓存命中则不登录)。
|
|
|
|
|
*
|
|
|
|
|
* <p>供健康检查与联调探针使用;业务方法接入时也应经此取 token,
|
|
|
|
|
* 不要在适配器外自行缓存。</p>
|
|
|
|
|
*
|
|
|
|
|
* @throws common.ecommerce.shared.error.AuthException 登录被拒或令牌结构不符合文档
|
|
|
|
|
*/
|
|
|
|
|
public AccessToken login(WarehouseContext ctx) {
|
|
|
|
|
return tokenManager.getOrRefresh(tokenKey(ctx.secret()), ctx.secret());
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
// ------------------------------------------------------------------ 商品
|
|
|
|
|
|
|
|
|
|
/**
|
|
|
|
|
* 创建或更新商品。
|
|
|
|
|
*
|
|
|
|
|
* <p>信仓没有 upsert 接口,按「先查临时产品、有则更新、无则新增」实现:</p>
|
|
|
|
|
* <ul>
|
|
|
|
|
* <li>{@code api.add_product} 新建的是<b>临时产品</b>({@code state=0}),
|
|
|
|
|
* 要用于出库还需另行上架为正式产品({@code api.pub_product},本轮未接入)</li>
|
|
|
|
|
* <li>{@code api.update_product} 只对临时产品有效;若同 SKU 已是正式产品,
|
|
|
|
|
* 新增会返回「产品SKU已存在」,这里原样抛给调用方,不静默忽略</li>
|
|
|
|
|
* </ul>
|
|
|
|
|
*
|
|
|
|
|
* @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 是否已是临时产品。
|
|
|
|
|
*
|
|
|
|
|
* <p>{@code api.productlist} 的 {@code key} 是 SKU 过滤条件,但文档没说是否精确匹配,
|
|
|
|
|
* 这里再按 {@code product_no} 精确比对一次。</p>
|
|
|
|
|
*/
|
|
|
|
|
private XincangDtos.ProductListItem findTemporaryProduct(WarehouseContext ctx, AccessToken token,
|
|
|
|
|
String sku) {
|
|
|
|
|
Map<String, Object> 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<XincangDtos.ProductListItem> 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<String, Object> 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。
|
|
|
|
|
*
|
|
|
|
|
* <p>用 appkey 而不是 {@code warehouseCode},避免同客户多仓重复登录。</p>
|
|
|
|
|
*/
|
|
|
|
|
static String tokenKey(ChannelSecret secret) {
|
|
|
|
|
return XincangConstants.ADAPTER_ID + ":" + secret.appKey();
|
|
|
|
|
}
|
|
|
|
|
}
|