Browse Source

test(lingxing): 新增从 ChannelSdk 调用领星的用法演示测试

六个步骤对应操作手册的调用顺序:
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
chenchuchuan 2 weeks ago
parent
commit
831cd71ce2
  1. 213
      lingxing/src/test/java/common/ecommerce/lingxing/SdkCallGuideTest.java

213
lingxing/src/test/java/common/ecommerce/lingxing/SdkCallGuideTest.java

@ -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…
Cancel
Save