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
87 lines
3.5 KiB
|
2 weeks ago
|
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.WarehouseCapability;
|
||
|
|
import common.ecommerce.warehouse.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();
|
||
|
|
}
|
||
|
|
}
|