Browse Source
六个步骤对应操作手册的调用顺序: 1. 构造 ChannelAccount(provider/platform/omsStoreId + externalStoreId + platformCode) 2. 构造 ChannelConnection(端点 + appId/appSecret) 3. 构建 ChannelSdk(accountRepository 必需;工厂或适配器实例注册) 4. capabilities() 不发网络请求 5. pull 时打印并断言真实请求:先换 token,再拉订单,含 platform_code/store_id/offset/length/时间窗 6. 三类快速失败:账户未配置、能力缺失(在调用动作时报错)、平台无适配器 注意:领星 appId 同时作为签名 AES 密钥,测试里必须是 16/24/32 字节。 Co-Authored-By: Claude <noreply@anthropic.com>feature/supplier-lingxing
1 changed files with 213 additions and 0 deletions
@ -0,0 +1,213 @@
@@ -0,0 +1,213 @@
|
||||
package common.ecommerce.lingxing; |
||||
|
||||
import common.ecommerce.capability.CapabilityReport; |
||||
import common.ecommerce.error.ChannelException; |
||||
import common.ecommerce.http.HttpRequest; |
||||
import common.ecommerce.http.HttpResponse; |
||||
import common.ecommerce.http.HttpTransport; |
||||
import common.ecommerce.lingxing.adapter.LingxingAdapterFactory; |
||||
import common.ecommerce.model.Capability; |
||||
import common.ecommerce.model.ChannelProvider; |
||||
import common.ecommerce.model.Platform; |
||||
import common.ecommerce.model.account.AccountKey; |
||||
import common.ecommerce.model.account.ChannelAccount; |
||||
import common.ecommerce.model.order.SalesOrderQuery; |
||||
import common.ecommerce.model.support.Page; |
||||
import common.ecommerce.sdk.ChannelConnection; |
||||
import common.ecommerce.sdk.ChannelSdk; |
||||
import common.ecommerce.spi.ChannelSecret; |
||||
import common.ecommerce.testkit.InMemoryAccounts; |
||||
import common.ecommerce.testkit.InMemoryIdempotencyStore; |
||||
import common.ecommerce.testkit.InMemoryLockProvider; |
||||
import common.ecommerce.testkit.InMemoryTokenStore; |
||||
import org.junit.jupiter.api.Test; |
||||
|
||||
import java.time.Clock; |
||||
import java.time.Instant; |
||||
import java.time.ZoneOffset; |
||||
import java.util.ArrayList; |
||||
import java.util.List; |
||||
|
||||
import static org.junit.jupiter.api.Assertions.assertEquals; |
||||
import static org.junit.jupiter.api.Assertions.assertFalse; |
||||
import static org.junit.jupiter.api.Assertions.assertNotNull; |
||||
import static org.junit.jupiter.api.Assertions.assertThrows; |
||||
import static org.junit.jupiter.api.Assertions.assertTrue; |
||||
|
||||
/** |
||||
* 从 ChannelSdk 调用领星的完整写法演示。 |
||||
* |
||||
* <p>这不是契约测试,而是<b>用法说明</b>:每一段代码对应操作手册里的一节。 |
||||
* 网络层用 {@link RecordingTransport} 记录请求后中断,不联网、不伪造响应。</p> |
||||
*/ |
||||
class SdkCallGuideTest { |
||||
|
||||
private static final String ENDPOINT = "https://openapi.lingxing.com"; |
||||
private static final String OMS_STORE_ID = "oms-wm-001"; |
||||
/** 领星 appId 同时作为签名 AES 密钥,长度必须是 16/24/32 字节。 */ |
||||
private static final String APP_KEY = "test-app-id-1234"; |
||||
private static final String APP_SECRET = "test-app-secret"; |
||||
|
||||
/** ---------------------------------------------------------------- 第 1 步:账户 */ |
||||
private static ChannelAccount walmartAccount() { |
||||
return ChannelAccount.builder() |
||||
.key(AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID)) |
||||
.externalStoreId("1108413237731") // 领星 store_id
|
||||
.platformCode(10008) // 领星 platform_code:10008 = Walmart
|
||||
.credentialRef("kms://test/lingxing") // 只存引用(本 SDK 目前不用它取密钥)
|
||||
.marketplaceZone("America/Los_Angeles") // 必须是合法 IANA 时区
|
||||
.currency("USD") |
||||
.build(); |
||||
} |
||||
|
||||
/** ---------------------------------------------------------------- 第 2 步:连接信息 */ |
||||
private static ChannelConnection connection() { |
||||
return ChannelConnection.of(ENDPOINT, |
||||
ChannelSecret.builder().appKey(APP_KEY).appSecret(APP_SECRET).build()); |
||||
} |
||||
|
||||
/** ---------------------------------------------------------------- 第 3 步:构建 SDK */ |
||||
private static ChannelSdk buildSdk(HttpTransport transport, ChannelAccount account) { |
||||
InMemoryAccounts accounts = new InMemoryAccounts().put(account); |
||||
|
||||
ChannelSdk.Builder builder = ChannelSdk.builder() |
||||
.accountRepository(accounts) // 必需:按 AccountKey 查账户
|
||||
.idempotencyStore(new InMemoryIdempotencyStore()) // 写操作用;本用例不写
|
||||
.idempotencyOwner("test-node") |
||||
.clock(Clock.fixed(Instant.parse("2026-11-04T00:00:00Z"), ZoneOffset.UTC)); |
||||
|
||||
// 工厂内部会 new OkHttpTransport,所以这里直接注册适配器实例以便注入测试传输层。
|
||||
// 生产环境用 .register(new LingxingAdapterFactory(tokenStore, lockProvider, clock))。
|
||||
return builder.register(new common.ecommerce.lingxing.adapter.LingxingAdapter( |
||||
transport, |
||||
new common.ecommerce.http.JacksonJsonCodec(), |
||||
new InMemoryTokenStore(), |
||||
new InMemoryLockProvider(), |
||||
Clock.systemUTC())).build(); |
||||
} |
||||
|
||||
@Test |
||||
void step3_factoryStyleRegistration() { |
||||
// 生产写法:注册工厂,SDK 在 build() 时调用 factory.create(...)
|
||||
LingxingAdapterFactory factory = new LingxingAdapterFactory( |
||||
new InMemoryTokenStore(), new InMemoryLockProvider(), Clock.systemUTC()); |
||||
|
||||
assertNotNull(factory); |
||||
assertEquals("lingxing", factory.adapterId()); |
||||
assertEquals(ChannelProvider.LINGXING, factory.provider()); |
||||
assertTrue(factory.platforms().contains(Platform.WALMART_SC)); |
||||
} |
||||
|
||||
/** ---------------------------------------------------------------- 第 4 步:查能力(不发请求) */ |
||||
@Test |
||||
void step4_capabilitiesDoNotCallNetwork() { |
||||
RecordingTransport transport = new RecordingTransport(); |
||||
ChannelSdk sdk = buildSdk(transport, walmartAccount()); |
||||
|
||||
AccountKey key = AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID); |
||||
CapabilityReport caps = sdk.capabilities(key); |
||||
|
||||
assertTrue(caps.supports(Capability.SALES_ORDER)); |
||||
assertTrue(caps.supports(Capability.PRODUCT)); |
||||
assertFalse(caps.supports(Capability.REFUND)); |
||||
assertTrue(transport.recorded.isEmpty(), "capabilities() 不应发起网络请求"); |
||||
} |
||||
|
||||
/** ---------------------------------------------------------------- 第 5 步:拉订单 */ |
||||
@Test |
||||
void step5_pullOrdersShowsRequestParameters() { |
||||
RecordingTransport transport = new RecordingTransport(); |
||||
ChannelSdk sdk = buildSdk(transport, walmartAccount()); |
||||
AccountKey key = AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID); |
||||
|
||||
// 请求构造完成后 RecordingTransport 会抛 StopException 中断,这里接住
|
||||
assertThrows(RecordingTransport.Stop.class, () -> sdk.salesOrders(key, connection()).pull( |
||||
SalesOrderQuery.builder() |
||||
.updatedAfter(Instant.parse("2026-11-01T00:00:00Z")) |
||||
.updatedBefore(Instant.parse("2026-11-02T00:00:00Z")) |
||||
.pageSize(50) |
||||
.build())); |
||||
|
||||
// 两次请求:先换 token,再拉订单
|
||||
assertEquals(2, transport.recorded.size()); |
||||
HttpRequest tokenReq = transport.recorded.get(0); |
||||
HttpRequest orderReq = transport.recorded.get(1); |
||||
|
||||
assertTrue(tokenReq.url().endsWith("/api/auth-server/oauth/access-token"), tokenReq.url()); |
||||
assertTrue(tokenReq.body().contains("name=\"appId\"\r\n\r\n" + APP_KEY), tokenReq.body()); |
||||
assertTrue(tokenReq.body().contains("name=\"appSecret\"\r\n\r\n" + APP_SECRET), tokenReq.body()); |
||||
|
||||
assertTrue(orderReq.url().startsWith(ENDPOINT + "/pb/mp/order/v2/list"), orderReq.url()); |
||||
assertTrue(orderReq.url().contains("app_key=" + APP_KEY), orderReq.url()); |
||||
assertTrue(orderReq.url().contains("sign="), orderReq.url()); |
||||
assertTrue(orderReq.body().contains("\"platform_code\":[10008]"), orderReq.body()); |
||||
assertTrue(orderReq.body().contains("\"store_id\":[\"1108413237731\"]"), orderReq.body()); |
||||
assertTrue(orderReq.body().contains("\"offset\":0"), orderReq.body()); |
||||
assertTrue(orderReq.body().contains("\"length\":50"), orderReq.body()); |
||||
assertTrue(orderReq.body().contains("\"start_time\":1793491200"), orderReq.body()); |
||||
assertEquals("Bearer ", orderReq.headers().get("Authorization").substring(0, 7)); |
||||
} |
||||
|
||||
/** ---------------------------------------------------------------- 第 6 步:参数不对时的报错 */ |
||||
@Test |
||||
void step6_unknownAccountFailsFast() { |
||||
ChannelSdk sdk = buildSdk(new RecordingTransport(), walmartAccount()); |
||||
AccountKey missing = AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, "oms-not-exists"); |
||||
|
||||
IllegalStateException ex = assertThrows(IllegalStateException.class, |
||||
() -> sdk.salesOrders(missing, connection())); |
||||
assertTrue(ex.getMessage().contains("channel account not configured"), ex.getMessage()); |
||||
} |
||||
|
||||
@Test |
||||
void step6_unsupportedCapabilityFailsFast() { |
||||
ChannelSdk sdk = buildSdk(new RecordingTransport(), walmartAccount()); |
||||
AccountKey key = AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID); |
||||
|
||||
// 能力检查发生在调用动作时(pull/submit),不是取视图时
|
||||
ChannelException.UnsupportedCapabilityException ex = |
||||
assertThrows(ChannelException.UnsupportedCapabilityException.class, |
||||
() -> sdk.settlements(key, connection()).pull( |
||||
common.ecommerce.model.settlement.SettlementQuery.builder().build())); |
||||
assertEquals(Capability.BILLING, ex.capability()); |
||||
} |
||||
|
||||
@Test |
||||
void step6_unregisteredPlatformFailsFast() { |
||||
ChannelSdk sdk = buildSdk(new RecordingTransport(), walmartAccount()); |
||||
// 账户仓库里只有沃尔玛 SC 的账户,用 EBAY 的 key 会先卡在账户查询
|
||||
AccountKey ebay = AccountKey.of(ChannelProvider.LINGXING, Platform.EBAY, OMS_STORE_ID); |
||||
|
||||
IllegalStateException ex = assertThrows(IllegalStateException.class, |
||||
() -> sdk.salesOrders(ebay, connection())); |
||||
assertTrue(ex.getMessage().contains("channel account not configured"), ex.getMessage()); |
||||
} |
||||
|
||||
/** |
||||
* 记录请求后中断的传输层。 |
||||
* |
||||
* <p>令牌请求返回一个最小的成功响应,让流程能走到业务请求; |
||||
* 业务请求记录后中断,用来看请求是怎么构造的。</p> |
||||
*/ |
||||
static final class RecordingTransport implements HttpTransport { |
||||
|
||||
final List<HttpRequest> recorded = new ArrayList<HttpRequest>(); |
||||
|
||||
@Override |
||||
public HttpResponse execute(HttpRequest request) { |
||||
recorded.add(request); |
||||
if (request.url().contains("/api/auth-server/oauth/access-token")) { |
||||
return HttpResponse.of(200, java.util.Collections.<String, String>emptyMap(), |
||||
"{\"code\":\"200\",\"msg\":\"OK\",\"data\":{" |
||||
+ "\"access_token\":\"tok-1\",\"refresh_token\":\"ref-1\"," |
||||
+ "\"expires_in\":7199}}", 1); |
||||
} |
||||
throw new Stop(); |
||||
} |
||||
|
||||
/** 用于中断调用链,不是错误。 */ |
||||
static final class Stop extends RuntimeException { |
||||
private static final long serialVersionUID = 1L; |
||||
} |
||||
} |
||||
} |
||||
Loading…
Reference in new issue