From c9d60153c7cc3dfb12a289a974cecb4ecd6a4c0c Mon Sep 17 00:00:00 2001 From: chenchuchuan <13554600537@163.com> Date: Wed, 4 Nov 2026 17:19:30 +0800 Subject: [PATCH] =?UTF-8?q?test:=20=E6=AF=8F=E4=B8=AA=E5=B9=B3=E5=8F=B0?= =?UTF-8?q?=E8=A1=A5=20listing=20/=20=E5=94=AE=E5=90=8E=E5=A5=91=E7=BA=A6?= =?UTF-8?q?=E6=B5=8B=E8=AF=95=EF=BC=8C=E6=96=B0=E5=A2=9E=20SDK=20=E9=97=A8?= =?UTF-8?q?=E9=9D=A2=E8=B0=83=E7=94=A8=E6=B5=8B=E8=AF=95?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit testkit(测试支撑): - RecordingTransport:记录全部请求、按 URL 路由响应;令牌请求自动返回最小成功响应, 业务请求可断言 - JsonFixture:classpath 夹具加载 - Responses:恢复快捷响应构造 - FakeDirectAdapter:补 AfterSaleCapable,支持 afterSales(count) lingxing(每平台一套): - 9 个 listing 测试:walmart / ebay / temu / shein / tiktok / target / aliexpress / amazon sc / amazon vc 覆盖请求参数(店铺、时间窗、分页、搜索编码)与响应映射 - 售后:ListSource(请求构造、过滤、上限、时间窗校验、行展开)+ Mapper(10 例) - LingxingTestSupport:测试公共样板(账户/调用/断言) - 夹具:每平台一套 success.json testkit(门面调用): - SdkFacadeCallTest:products / afterSales / salesOrders 的完整调用、分页、 参数校验、能力检查、账户缺失等错误路径 清理: - 删除 ProductCallExampleTest、SdkCallGuideTest 与两份 AmazonScProductLiveTest (已被上述测试覆盖) - 探针改为 -Dlingxing.probe=true 才运行,避免真实凭证让 mvn test 变红 修复: - TargetProductSource 的 store_ids 被误注释,恢复 - AmazonVcProductSource 传搜索条件时显式抛异常,不再静默忽略 Co-Authored-By: Claude --- .../amazon/vc/product/AmazonVcProductSource.java | 6 + .../target/product/TargetProductSource.java | 8 +- .../ecommerce/lingxing/ProductCallExampleTest.java | 182 ---------------- .../ecommerce/lingxing/SdkCallGuideTest.java | 212 ------------------- .../aftersale/LingxingAfterSaleListSourceTest.java | 204 +++++++++--------- .../product/AliexpressProductSourceTest.java | 76 +++++++ .../platform/amazon/AmazonScProductLiveTest.java | 229 --------------------- .../amazon/sc/AmazonScProductLiveTest.java | 229 --------------------- .../sc/product/AmazonScProductSourceTest.java | 75 +++++++ .../vc/product/AmazonVcProductSourceTest.java | 60 ++++++ .../ebay/product/EbayProductSourceTest.java | 62 ++++++ .../shein/product/SheinProductSourceTest.java | 56 +++++ .../temu/product/TemuProductSourceTest.java | 67 ++++++ .../tiktok/product/TiktokProductSourceTest.java | 49 +++++ .../walmart/product/WalmartProductSourceTest.java | 85 ++++++++ .../lingxing/probe/SearchFieldProbeTest.java | 4 + .../lingxing/probe/ShopListProbeTest.java | 4 + .../lingxing/support/LingxingTestSupport.java | 122 +++++++++++ .../lingxing/aliexpressListing/success.json | 8 + .../fixtures/lingxing/amazonScListing/success.json | 7 + .../fixtures/lingxing/amazonVcListing/success.json | 6 + .../fixtures/lingxing/ebayListing/success.json | 10 + .../fixtures/lingxing/sheinListing/success.json | 7 + .../fixtures/lingxing/targetListing/success.json | 10 + .../fixtures/lingxing/temuListing/success.json | 11 + .../fixtures/lingxing/tiktokListing/success.json | 7 + .../fixtures/lingxing/walmartListing/success.json | 10 + .../ecommerce/testkit/FakeDirectAdapter.java | 39 +++- .../java/common/ecommerce/testkit/JsonFixture.java | 38 ++++ .../ecommerce/testkit/RecordingTransport.java | 108 ++++++++++ .../java/common/ecommerce/testkit/Responses.java | 34 +++ .../ecommerce/testkit/SdkFacadeCallTest.java | 181 ++++++++++++++++ 32 files changed, 1246 insertions(+), 960 deletions(-) delete mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/ProductCallExampleTest.java delete mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/SdkCallGuideTest.java create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java delete mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/AmazonScProductLiveTest.java delete mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/AmazonScProductLiveTest.java create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java create mode 100644 lingxing/src/test/resources/fixtures/lingxing/aliexpressListing/success.json create mode 100644 lingxing/src/test/resources/fixtures/lingxing/amazonScListing/success.json create mode 100644 lingxing/src/test/resources/fixtures/lingxing/amazonVcListing/success.json create mode 100644 lingxing/src/test/resources/fixtures/lingxing/ebayListing/success.json create mode 100644 lingxing/src/test/resources/fixtures/lingxing/sheinListing/success.json create mode 100644 lingxing/src/test/resources/fixtures/lingxing/targetListing/success.json create mode 100644 lingxing/src/test/resources/fixtures/lingxing/temuListing/success.json create mode 100644 lingxing/src/test/resources/fixtures/lingxing/tiktokListing/success.json create mode 100644 lingxing/src/test/resources/fixtures/lingxing/walmartListing/success.json create mode 100644 testkit/src/main/java/common/ecommerce/testkit/JsonFixture.java create mode 100644 testkit/src/main/java/common/ecommerce/testkit/RecordingTransport.java create mode 100644 testkit/src/main/java/common/ecommerce/testkit/Responses.java create mode 100644 testkit/src/test/java/common/ecommerce/testkit/SdkFacadeCallTest.java diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java index 80057e2..9100a35 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java @@ -54,6 +54,12 @@ public final class AmazonVcProductSource implements LingxingProductSource { if (storeId != null && !storeId.trim().isEmpty()) { body.put("vc_store_ids", Collections.singletonList(storeId)); } + // 该接口文档没有搜索参数,传了搜索条件必须显式失败,不能静默返回全量 + if (query.hasSearch()) { + throw new UnsupportedOperationException( + "amazon vc listing does not support search field " + query.searchField()); + } + HttpRequest req = call.signed(LingxingApi.LISTING_AMAZON_VC, body, "products.pull"); HttpResponse resp = call.execute(req); LingxingEnvelope envelope = call.envelope(resp, "products.pull"); diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java index c193149..ab4986f 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java @@ -55,10 +55,10 @@ public final class TargetProductSource implements LingxingProductSource { body.put("offset", offset); body.put("length", length); // store_ids 非必填:账户配了才传,由平台侧校验是否必填 -// String storeId = call.ctx().account().externalStoreId(); -// if (storeId != null && !storeId.trim().isEmpty()) { -// body.put("store_ids", Collections.singletonList(storeId)); -// } + String storeId = call.ctx().account().externalStoreId(); + if (storeId != null && !storeId.trim().isEmpty()) { + body.put("store_ids", Collections.singletonList(storeId)); + } applyTimeWindow(body, query); // 按 SKU 搜索:平台不支持的维度直接报错,不静默忽略 diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/ProductCallExampleTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/ProductCallExampleTest.java deleted file mode 100644 index 8567e14..0000000 --- a/lingxing/src/test/java/common/ecommerce/lingxing/ProductCallExampleTest.java +++ /dev/null @@ -1,182 +0,0 @@ -package common.ecommerce.lingxing; - -import common.ecommerce.http.HttpResponse; -import common.ecommerce.http.HttpTransport; -import common.ecommerce.lingxing.adapter.LingxingAdapter; -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.product.ProductListing; -import common.ecommerce.model.product.ProductQuery; -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.InMemoryLockProvider; -import common.ecommerce.testkit.InMemoryTokenStore; -import org.junit.jupiter.api.Test; - -import java.time.Clock; -import java.time.Instant; - -import static org.junit.jupiter.api.Assertions.assertEquals; -import static org.junit.jupiter.api.Assertions.assertNotNull; - -/** - * 从 ChannelSdk 拉商品的完整示例。 - * - *

这是用法文档,不是契约测试。传输层返回一页固定的领星 Listing 响应, - * 目的是让你看清:三段配置分别是什么、拼出来的请求长什么样、结果如何映射成统一模型。

- */ -class ProductCallExampleTest { - - /** 领星生产域名。SDK 不保存它,每次调用通过 ChannelConnection 传入。 */ - private static final String ENDPOINT = "https://openapi.lingxing.com"; - - // ==================== 第 1 段:账户 ==================== - - /** 你自己的店铺 ID,业务归属维度。 */ - private static final String OMS_STORE_ID = "oms-wm-001"; - - /** 领星侧的店铺 ID(store_id)。 */ - private static final String LINGXING_STORE_ID = "1108413237731"; - - /** 领星平台码:10008 = Walmart,10001 = Amazon SC。 */ - private static final int PLATFORM_CODE = 10008; - - /** - * 领星 AppID。同时作为签名用的 AES 密钥,长度必须是 16/24/32 字节, - * 否则 LingxingSigner 会直接拒绝。 - */ - private static final String APP_KEY = "test-app-id-1234"; - - /** 领星 AppSecret。 */ - private static final String APP_SECRET = "test-app-secret"; - - /** 账户:告诉 SDK「这是哪个店铺」,SDK 用它校验归属、拼请求参数。 */ - private static ChannelAccount account() { - return ChannelAccount.builder() - // provider + platform + omsStoreId:三个一起决定用哪个适配器 - .key(AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID)) - // 领星 store_id,会拼进请求体的 store_ids - .externalStoreId(LINGXING_STORE_ID) - // 领星 platform_code,会拼进请求体的 platform_code - .platformCode(PLATFORM_CODE) - // 密钥引用;本 SDK 目前不使用(密钥从 ChannelConnection 传) - .credentialRef("kms://test/lingxing") - // 市场时区,必须能被 ZoneId.of 解析;影响返回时间的当地视图 - .marketplaceZone("America/Los_Angeles") - // 店铺币种 - .currency("USD") - .build(); - } - - // ==================== 第 2 段:连接 ==================== - - /** 连接:告诉 SDK「这次连哪里、用谁的身份」。每次调用都可以不同(换环境、换 app)。 */ - private static ChannelConnection connection() { - return ChannelConnection.of(ENDPOINT, ChannelSecret.builder() - .appKey(APP_KEY) // 领星 AppID - .appSecret(APP_SECRET) // 领星 AppSecret - .build()); - } - - // ==================== 第 3 段:构建 SDK ==================== - - /** 构建 SDK:账户仓库 + 适配器。写操作才需要幂等存储。 */ - private static ChannelSdk buildSdk(HttpTransport transport) { - InMemoryAccounts accounts = new InMemoryAccounts().put(account()); - - // 生产写法是 .register(new LingxingAdapterFactory(tokenStore, lockProvider, clock)), - // 工厂内部会 new OkHttpTransport;这里为了接管网络层,直接注册适配器实例。 - LingxingAdapter adapter = new LingxingAdapter(transport, - new common.ecommerce.http.JacksonJsonCodec(), - new InMemoryTokenStore(), new InMemoryLockProvider(), Clock.systemUTC()); - - return ChannelSdk.builder() - .accountRepository(accounts) // 必需:按 AccountKey 找账户 - .register(adapter) // 必需:至少一个适配器 - .build(); - } - - // ==================== 调用 ==================== - - @Test - void pullProductsThroughSdk() { - FixedResponseTransport transport = new FixedResponseTransport(); - ChannelSdk sdk = buildSdk(transport); - - // 每次调用都传 AccountKey + ChannelConnection - AccountKey key = AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID); - - Page page = sdk.products(key, connection()).pull(ProductQuery.builder() - .updatedAfter(Instant.parse("2026-11-01T00:00:00Z")) // 可选 - .updatedBefore(Instant.parse("2026-11-04T00:00:00Z")) // 可选,不传则用 SDK 时钟 - .pageSize(20) // 平台上限内自动截断 - .build()); - - // 解析结果:领星字段 → 统一模型 - assertEquals(1, page.size()); - ProductListing p = page.items().get(0); - assertEquals("wal-0726-102", p.platformSku()); // ← msku - assertEquals("FBSPORT Round Inflatable", p.title()); // ← title - assertEquals(Platform.WALMART_SC, p.platform()); - assertEquals(OMS_STORE_ID, p.omsStoreId()); - assertEquals("USD", p.currency()); // ← currency_icon "$" 映射 - assertEquals("139.90", p.price().amount().toPlainString()); - assertNotNull(p.attributes().get("store_name")); // 未标准化的原始字段 - } - - @Test - void requestBodyCarriesAccountParameters() { - FixedResponseTransport transport = new FixedResponseTransport(); - ChannelSdk sdk = buildSdk(transport); - AccountKey key = AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID); - - sdk.products(key, connection()).pull(ProductQuery.builder().pageSize(20).build()); - - // 第一次是换 token,第二次是拉商品 - assertEquals(2, transport.requests.size()); - String productBody = transport.requests.get(1).body(); - - // 账户里的四个参数分别落到请求里 - assertTrueContains(productBody, "\"store_ids\":[\"" + LINGXING_STORE_ID + "\"]"); - assertTrueContains(productBody, "\"offset\":0"); - assertTrueContains(productBody, "\"length\":20"); - // 时间窗按 UTC 日期发送 - assertTrueContains(transport.requests.get(1).url(), "/basicOpen/multiplatform/walmart/list"); - } - - private static void assertTrueContains(String haystack, String needle) { - org.junit.jupiter.api.Assertions.assertTrue(haystack.contains(needle), - "期望包含 " + needle + ",实际:" + haystack); - } - - /** - * 固定响应传输层:令牌请求返回最小 token 响应,商品请求返回一页沃尔玛 Listing。 - */ - static final class FixedResponseTransport implements HttpTransport { - - final java.util.List requests = - new java.util.ArrayList(); - - @Override - public HttpResponse execute(common.ecommerce.http.HttpRequest request) { - requests.add(request); - if (request.url().contains("/oauth/access-token")) { - return HttpResponse.of(200, java.util.Collections.emptyMap(), - "{\"code\":\"200\",\"msg\":\"OK\",\"data\":{\"access_token\":\"tok-1\"," - + "\"refresh_token\":\"ref-1\",\"expires_in\":7199}}", 1); - } - return HttpResponse.of(200, java.util.Collections.emptyMap(), - "{\"code\":0,\"message\":\"success\",\"total\":1,\"data\":{\"list\":[{" - + "\"item_id\":\"wal-0726-102\",\"msku\":\"wal-0726-102\"," - + "\"title\":\"FBSPORT Round Inflatable\",\"picture_url\":\"\"," - + "\"status_name\":\"PUBLISHED\",\"store_id\":\"" + LINGXING_STORE_ID + "\"," - + "\"store_name\":\"测试店铺\",\"currency_icon\":\"$\",\"price\":\"139.90\"," - + "\"gtin\":\"00723849594300\"}]}}", 1); - } - } -} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/SdkCallGuideTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/SdkCallGuideTest.java deleted file mode 100644 index 5775914..0000000 --- a/lingxing/src/test/java/common/ecommerce/lingxing/SdkCallGuideTest.java +++ /dev/null @@ -1,212 +0,0 @@ -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 调用领星的完整写法演示。 - * - *

这不是契约测试,而是用法说明:每一段代码对应操作手册里的一节。 - * 网络层用 {@link RecordingTransport} 记录请求后中断,不联网、不伪造响应。

- */ -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()); - } - - /** - * 记录请求后中断的传输层。 - * - *

令牌请求返回一个最小的成功响应,让流程能走到业务请求; - * 业务请求记录后中断,用来看请求是怎么构造的。

- */ - static final class RecordingTransport implements HttpTransport { - - final List recorded = new ArrayList(); - - @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.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; - } - } -} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java index eedd592..9ab95cc 100644 --- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java +++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java @@ -1,134 +1,134 @@ package common.ecommerce.lingxing.platform.aftersale; -import common.ecommerce.http.HttpRequest; -import common.ecommerce.http.HttpResponse; -import common.ecommerce.http.HttpTransport; -import common.ecommerce.http.JacksonJsonCodec; +import common.ecommerce.error.ChannelException; +import common.ecommerce.error.ValidationException; import common.ecommerce.lingxing.LingxingApi; -import common.ecommerce.lingxing.auth.LingxingTokenClient; -import common.ecommerce.lingxing.http.LingxingRateLimiter; -import common.ecommerce.lingxing.http.LingxingRequestFactory; -import common.ecommerce.lingxing.platform.LingxingCall; -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.aftersale.AfterSale; import common.ecommerce.model.aftersale.AfterSaleQuery; import common.ecommerce.model.aftersale.AfterSaleType; import common.ecommerce.model.support.Page; -import common.ecommerce.sdk.ChannelConnection; -import common.ecommerce.sdk.ChannelContext; -import common.ecommerce.spi.AccessToken; -import common.ecommerce.spi.ChannelSecret; +import common.ecommerce.testkit.JsonFixture; +import common.ecommerce.testkit.RecordingTransport; +import common.ecommerce.testkit.Responses; import org.junit.jupiter.api.Test; -import java.time.Clock; import java.time.LocalDate; -import java.util.ArrayList; import java.util.Arrays; -import java.util.Collections; -import java.util.List; +import static common.ecommerce.lingxing.support.LingxingTestSupport.ENDPOINT; +import static common.ecommerce.lingxing.support.LingxingTestSupport.account; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyNotContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertUrlStartsWith; +import static common.ecommerce.lingxing.support.LingxingTestSupport.call; +import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody; +import static common.ecommerce.lingxing.support.LingxingTestSupport.lastUrl; import static org.junit.jupiter.api.Assertions.assertEquals; -import static org.junit.jupiter.api.Assertions.assertTrue; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertThrows; -/** - * 领星售后列表接口的请求构造测试。 - * - *

传输层返回录制报文后直接断言请求体,不联网。

- */ +/** 领星售后订单列表:请求构造 + 响应映射 + 边界校验。 */ class LingxingAfterSaleListSourceTest { - private static final Clock CLOCK = Clock.fixed(java.time.Instant.parse("2026-11-04T00:00:00Z"), - java.time.ZoneOffset.UTC); + private final RecordingTransport transport = RecordingTransport.create() + .route(LingxingApi.AFTER_SALE_LIST.path(), + r -> Responses.ok(JsonFixture.load("fixtures/lingxing/afterSale/success.json"))); @Test - void requestCarriesTimeWindowAndFilters() throws Exception { - RecordingTransport transport = new RecordingTransport(); - LingxingAfterSaleListSource source = new LingxingAfterSaleListSource(); + void requestCarriesTimeWindowAndFilters() { + Page page = new LingxingAfterSaleListSource().pull( + call(transport, account(Platform.AMAZON_SC, 10001, "1099")), + AfterSaleQuery.builder() + .startDate(LocalDate.parse("2026-10-01")) + .endDate(LocalDate.parse("2026-11-01")) + .dateType(AfterSaleQuery.DateType.UPDATE_TIME) + .types(Arrays.asList(AfterSaleType.REFUND, AfterSaleType.RETURN)) + .channelOrderIds(Arrays.asList("113-1", "113-2")) + .pageSize(200) + .build()); - Page page = source.pull(call(transport, "1105"), AfterSaleQuery.builder() - .startDate(LocalDate.parse("2026-10-01")) - .endDate(LocalDate.parse("2026-11-01")) - .dateType(AfterSaleQuery.DateType.UPDATE_TIME) - .types(Arrays.asList(AfterSaleType.REFUND, AfterSaleType.RETURN)) - .channelOrderIds(Arrays.asList("113-1", "113-2")) - .pageSize(200) - .build()); + assertUrlStartsWith(lastUrl(transport), ENDPOINT + LingxingApi.AFTER_SALE_LIST.path()); + String body = lastBody(transport); + assertBodyContains(body, "\"start_date\":\"2026-10-01\""); + assertBodyContains(body, "\"end_date\":\"2026-11-01\""); + assertBodyContains(body, "\"date_type\":3"); + assertBodyContains(body, "\"after_type\":\"1,2\""); + assertBodyContains(body, "\"amazon_order_id_list\":[\"113-1\",\"113-2\"]"); + assertBodyContains(body, "\"sid\":\"1099\""); + assertBodyContains(body, "\"length\":200"); - // 两条请求:先换 token,再拉售后 - assertEquals(2, transport.requests.size()); - HttpRequest req = transport.requests.get(1); - assertTrue(req.url().startsWith("https://openapi.lingxing.com" - + LingxingApi.AFTER_SALE_LIST.path()), req.url()); + // 一条记录含 2 个商品行 → 2 条统一模型;游标按记录数推进 + assertEquals(2, page.size()); + assertNull(page.nextCursor()); + } - String body = req.body(); - assertTrue(body.contains("\"start_date\":\"2026-10-01\""), body); - assertTrue(body.contains("\"end_date\":\"2026-11-01\""), body); - assertTrue(body.contains("\"date_type\":3"), body); - assertTrue(body.contains("\"after_type\":\"1,2\""), body); - assertTrue(body.contains("\"amazon_order_id_list\":[\"113-1\",\"113-2\"]"), body); - assertTrue(body.contains("\"sid\":\"1105\""), body); - assertTrue(body.contains("\"length\":200"), body); - assertTrue(body.contains("\"offset\":0"), body); + @Test + void defaultDateTypeIsAfterSaleTime() { + new LingxingAfterSaleListSource().pull( + call(transport, account(Platform.AMAZON_SC, 10001, "1099")), + AfterSaleQuery.builder() + .startDate(LocalDate.parse("2026-10-01")) + .endDate(LocalDate.parse("2026-11-02")) + .build()); + assertBodyContains(lastBody(transport), "\"date_type\":1"); + } - // 一条筛选记录含 2 个商品行 → 2 条统一模型;游标按记录数推进 - assertEquals(2, page.size()); - assertEquals(null, page.nextCursor()); + @Test + void noFiltersWhenListsEmpty() { + new LingxingAfterSaleListSource().pull( + call(transport, account(Platform.AMAZON_SC, 10001, "1099")), + AfterSaleQuery.builder() + .startDate(LocalDate.parse("2026-10-01")) + .endDate(LocalDate.parse("2026-11-02")) + .build()); + assertBodyNotContains(lastBody(transport), "after_type"); + assertBodyNotContains(lastBody(transport), "amazon_order_id_list"); } - private static LingxingCall call(HttpTransport transport, String storeId) throws Exception { - JacksonJsonCodec json = new JacksonJsonCodec(); - ChannelAccount account = ChannelAccount.builder() - .key(AccountKey.of(ChannelProvider.LINGXING, Platform.AMAZON_SC, "oms-amz-001")) - .externalStoreId(storeId) - .platformCode(10001) - .credentialRef("test") - .marketplaceZone("America/Los_Angeles") - .currency("USD") - .build(); - ChannelSecret secret = ChannelSecret.builder() - .appKey("test-app-id-1234").appSecret("test-app-secret").build(); - ChannelConnection conn = ChannelConnection.of("https://openapi.lingxing.com", secret); - ChannelContext ctx = ChannelContext.of(account, conn, "req-1", CLOCK); - AccessToken token = new LingxingTokenClient(transport, json, CLOCK) - .fetch("https://openapi.lingxing.com", "test-app-id-1234", "test-app-secret"); - return new LingxingCall(ctx, token, new LingxingRequestFactory(json, CLOCK), - new LingxingRateLimiter(), json, transport); + @Test + void orderIdLimitIsEnforced() { + String[] ids = new String[51]; + for (int i = 0; i < ids.length; i++) { + ids[i] = "order-" + i; + } + assertThrows(IllegalArgumentException.class, + () -> new LingxingAfterSaleListSource().pull( + call(transport, account(Platform.AMAZON_SC, 10001, "1099")), + AfterSaleQuery.builder() + .startDate(LocalDate.parse("2026-10-01")) + .endDate(LocalDate.parse("2026-11-02")) + .channelOrderIds(Arrays.asList(ids)) + .build())); } - /** 令牌返回最小成功响应;售后请求返回文档示例夹具。 */ - static final class RecordingTransport implements HttpTransport { + @Test + void timeWindowMustBeLeftClosedRightOpen() { + assertThrows(IllegalArgumentException.class, + () -> AfterSaleQuery.builder() + .startDate(LocalDate.parse("2026-11-02")) + .endDate(LocalDate.parse("2026-11-02")) + .build()); + } - final List requests = new ArrayList(); + @Test + void mapsRowsIntoUnifiedModel() { + Page page = new LingxingAfterSaleListSource().pull( + call(transport, account(Platform.AMAZON_SC, 10001, "1099")), + AfterSaleQuery.builder() + .startDate(LocalDate.parse("2026-10-01")) + .endDate(LocalDate.parse("2026-11-02")) + .build()); - @Override - public HttpResponse execute(HttpRequest request) { - requests.add(request); - if (request.url().contains("/oauth/access-token")) { - return HttpResponse.of(200, Collections.emptyMap(), - "{\"code\":\"200\",\"msg\":\"OK\",\"data\":{\"access_token\":\"tok\"," - + "\"refresh_token\":\"ref\",\"expires_in\":7199}}", 1); - } - try { - return HttpResponse.of(200, Collections.emptyMap(), - load("fixtures/lingxing/afterSale/success.json"), 1); - } catch (Exception e) { - throw new IllegalStateException(e); - } - } + AfterSale ret = page.items().get(0); + assertEquals(Platform.AMAZON_SC, ret.platform()); + assertEquals(AfterSaleType.RETURN, ret.type()); + assertEquals("113-9870855-8214638", ret.channelOrderId()); + assertEquals("D5LCqzJZRRMA", ret.rmaNumber()); - private static String load(String path) throws Exception { - java.io.InputStream in = LingxingAfterSaleListSourceTest.class.getClassLoader() - .getResourceAsStream(path); - java.io.ByteArrayOutputStream out = new java.io.ByteArrayOutputStream(); - byte[] buf = new byte[4096]; - int n; - while ((n = in.read(buf)) >= 0) { - out.write(buf, 0, n); - } - return new String(out.toByteArray(), "UTF-8"); - } + AfterSale refund = page.items().get(1); + assertEquals(AfterSaleType.REFUND, refund.type()); + assertEquals("USD", refund.refundAmount().currencyCode()); + assertEquals("-4.700", refund.refundAmount().amount().toPlainString()); } } diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java new file mode 100644 index 0000000..0df02d3 --- /dev/null +++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java @@ -0,0 +1,76 @@ +package common.ecommerce.lingxing.platform.aliexpress.product; + +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.model.Platform; +import common.ecommerce.model.product.ProductListing; +import common.ecommerce.model.product.ProductQuery; +import common.ecommerce.model.product.ProductSearchField; +import common.ecommerce.model.product.ProductStatus; +import common.ecommerce.testkit.JsonFixture; +import common.ecommerce.testkit.RecordingTransport; +import common.ecommerce.testkit.Responses; +import org.junit.jupiter.api.Test; + +import java.time.Instant; + +import static common.ecommerce.lingxing.support.LingxingTestSupport.account; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyNotContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.call; +import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody; +import static org.junit.jupiter.api.Assertions.assertEquals; + +/** + * AliExpress 在线商品。 + * + *

覆盖两处踩过的坑:接口不接受 storeIds;本地 SKU 的搜索编码是 5 而不是文档写的 3。

+ */ +class AliexpressProductSourceTest { + + private final RecordingTransport transport = RecordingTransport.create() + .route(LingxingApi.LISTING_ALIEXPRESS.path(), + r -> Responses.ok(JsonFixture.load("fixtures/lingxing/aliexpressListing/success.json"))); + + @Test + void requestOmitsStoreIdsAndUsesIsChild() { + new AliexpressProductSource().products(call(transport, account(Platform.ALIEXPRESS, 0, "8888")), + ProductQuery.builder() + .updatedAfter(Instant.parse("2026-10-01T00:00:00Z")) + .updatedBefore(Instant.parse("2026-10-08T00:00:00Z")) + .build()); + + String body = lastBody(transport); + // 该接口不需要 storeIds + assertBodyNotContains(body, "storeIds"); + assertBodyContains(body, "\"isParent\":0"); + assertBodyContains(body, "\"start\":\"2026-10-01\""); + assertBodyContains(body, "\"end\":\"2026-10-08\""); + } + + @Test + void platformSkuUsesField1LocalSkuUsesField5() { + AliexpressProductSource source = new AliexpressProductSource(); + source.products(call(transport, account(Platform.ALIEXPRESS, 0, "8888")), + ProductQuery.builder().searchField(ProductSearchField.PLATFORM_SKU).searchValue("AE-MSKU-1").build()); + assertBodyContains(lastBody(transport), "\"searchField\":1"); + + new AliexpressProductSource().products(call(transport, account(Platform.ALIEXPRESS, 0, "8888")), + ProductQuery.builder().searchField(ProductSearchField.LOCAL_SKU).searchValue("AE-LOCAL-1").build()); + // 实测:本地 SKU 是 5,不是文档写的 3 + assertBodyContains(lastBody(transport), "\"searchField\":5"); + } + + @Test + void mapsResponseWithCentsPrice() { + ProductListing p = new AliexpressProductSource().products( + call(transport, account(Platform.ALIEXPRESS, 0, "8888")), + ProductQuery.builder().build()).items().get(0); + + assertEquals(Platform.ALIEXPRESS, p.platform()); + assertEquals("AE-MSKU-1", p.platformSku()); + assertEquals(ProductStatus.ACTIVE, p.status()); + assertEquals("USD", p.currency()); + // price=5999 分 → 59.99 + assertEquals("59.99", p.price().amount().toPlainString()); + } +} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/AmazonScProductLiveTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/AmazonScProductLiveTest.java deleted file mode 100644 index 1b945df..0000000 --- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/AmazonScProductLiveTest.java +++ /dev/null @@ -1,229 +0,0 @@ -package common.ecommerce.lingxing.platform.amazon; - -import common.ecommerce.capability.AggregatorCapable.SubChannel; -import common.ecommerce.http.HttpRequest; -import common.ecommerce.http.HttpResponse; -import common.ecommerce.http.HttpTransport; -import common.ecommerce.http.JacksonJsonCodec; -import common.ecommerce.http.OkHttpTransport; -import common.ecommerce.lingxing.LingxingConstants; -import common.ecommerce.lingxing.adapter.LingxingAdapter; -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.product.ProductListing; -import common.ecommerce.model.product.ProductQuery; -import common.ecommerce.model.support.Page; -import common.ecommerce.sdk.ChannelConnection; -import common.ecommerce.sdk.ChannelContext; -import common.ecommerce.spi.ChannelSecret; -import common.ecommerce.testkit.InMemoryLockProvider; -import common.ecommerce.testkit.InMemoryTokenStore; -import org.junit.jupiter.api.Test; - -import java.time.Clock; -import java.time.Duration; -import java.time.Instant; -import java.util.List; - -import static org.junit.jupiter.api.Assertions.assertFalse; -import static org.junit.jupiter.api.Assertions.assertNotNull; - -/** - * 领星 · 亚马逊 SC 真实环境测试:先查店铺列表拿 sid,再用 sid 拉 Listing。 - * - *

跑之前填 APP_KEY / APP_SECRET 即可;SID 留空时会自动从店铺列表取第一个。

- *
- * mvn -pl lingxing -am test -Dtest=AmazonScProductLiveTest
- * 
- * - *

调用前确认出口 IP 已加入领星白名单。本类只用于联调,不要把真实凭证提交到仓库。

- * - *

两个接口的令牌桶容量都是 1,且按「账户 + path」共享,必须串行调用。

- */ -class AmazonScProductLiveTest { - - // ==================== 填写这里 ==================== - /** 领星 ERP 开放接口的 AppID。 */ - private static final String APP_KEY = "在这里填 AppID"; - /** 领星 ERP 开放接口的 AppSecret。 */ - private static final String APP_SECRET = "在这里填 AppSecret"; - /** - * 亚马逊店铺的领星 sid。 - * 留空则自动调用店铺列表接口,取第一个正常状态的店铺。 - */ - private static final String SID = ""; - // ================================================ - - private static final String BASE_URL = LingxingConstants.PRODUCTION_BASE_URL; - - private final JacksonJsonCodec json = new JacksonJsonCodec(); - private final LoggingTransport transport = - new LoggingTransport(new OkHttpTransport("common-ecommerce-smoke")); - - /** - * 店铺列表:一次性返回企业已授权到领星的全部亚马逊 SC 店铺。 - * - *

接口 {@code GET /erp/sc/data/seller/lists},非分页。打印每个店铺的 sid 与名称, - * 同时打印请求与响应原始报文(见 LoggingTransport),便于核对字段名。

- */ - @Test - void listsAmazonShops() { - requireConfigured(); - - List channels = adapter().listSubChannels(shopListContext()); - System.out.println("[shops] subChannels size=" + channels.size()); - for (SubChannel c : channels) { - System.out.println(" platformCode=" + c.platformCode() - + " sid=" + c.externalStoreId() - + " platform=" + c.platform() - + " name=" + c.name()); - } - assertNotNull(channels); - } - - /** 拿第一个正常店铺的 sid,调 Listing 接口。 */ - @Test - void pullsOnePageOfListings() { - requireConfigured(); - - String sid = resolveSid(); - System.out.println("[listings] 使用 sid=" + sid); - - ChannelContext ctx = ChannelContext.of(amazonAccount(sid), connection(), - "smoke-" + System.currentTimeMillis(), Clock.systemUTC()); - - Instant to = Instant.now(); - Instant from = to.minus(Duration.ofDays(7)); - - Page page = adapter().pull(ctx, ProductQuery.builder() - .updatedAfter(from) - .updatedBefore(to) - .pageSize(20) - .build()); - - System.out.println("[listings] window=" + from + " .. " + to - + " items=" + page.size() + " nextCursor=" + page.nextCursor()); - for (ProductListing p : page.items()) { - System.out.println(" sku=" + p.platformSku() - + " title=" + p.title() - + " status=" + p.status() - + " images=" + p.imageUrls().size() - + " updatedAt=" + (p.updatedAt() == null ? null : p.updatedAt().utc())); - } - assertFalse(page.size() > 20, "pageSize 未被平台遵守"); - } - - /** 不带时间窗,确认默认分页与解析也能走通。 */ - @Test - void pullsFirstPageWithoutTimeWindow() { - requireConfigured(); - - String sid = resolveSid(); - ChannelContext ctx = ChannelContext.of(amazonAccount(sid), connection(), - "smoke-" + System.currentTimeMillis(), Clock.systemUTC()); - - Page page = adapter().pull(ctx, ProductQuery.builder().pageSize(10).build()); - - System.out.println("[listings/no-window] sid=" + sid + " items=" + page.size() - + " nextCursor=" + page.nextCursor()); - for (ProductListing p : page.items()) { - System.out.println(" sku=" + p.platformSku() + " status=" + p.status()); - } - // 店铺可能没有商品,空列表也算通过 - assertNotNull(page); - } - - // ---------------------------------------------------------------- helpers - - private static void requireConfigured() { - org.junit.jupiter.api.Assumptions.assumeTrue( - !APP_KEY.startsWith("在这里填") && !APP_SECRET.startsWith("在这里填"), - "请先填写 AmazonScProductLiveTest 顶部的 APP_KEY / APP_SECRET"); - } - - /** 优先用常量里的 SID;留空则从店铺列表取第一个。 */ - private String resolveSid() { - if (SID != null && !SID.trim().isEmpty() && !SID.startsWith("在这里填")) { - return SID.trim(); - } - List channels = adapter().listSubChannels(shopListContext()); - if (channels.isEmpty()) { - throw new AssertionError("店铺列表为空:该企业没有已授权且状态正常的亚马逊 SC 店铺"); - } - return channels.get(0).externalStoreId(); - } - - private LingxingAdapter adapter() { - return new LingxingAdapter(transport, json, - new InMemoryTokenStore(), new InMemoryLockProvider(), Clock.systemUTC()); - } - - private ChannelConnection connection() { - return ChannelConnection.of(BASE_URL, ChannelSecret.builder() - .appKey(APP_KEY).appSecret(APP_SECRET).build()); - } - - /** 店铺列表所用的上下文:店铺维度此时还不存在,用占位 omsStoreId。 */ - private ChannelContext shopListContext() { - return ChannelContext.of(placeholderAccount(), connection(), - "smoke-shops-" + System.currentTimeMillis(), Clock.systemUTC()); - } - - private ChannelAccount placeholderAccount() { - return ChannelAccount.builder() - .key(AccountKey.of(ChannelProvider.LINGXING, Platform.AMAZON_SC, "oms-amz-discovery")) - .externalStoreId("discovery") - .platformCode(10001) - .credentialRef("smoke") - .marketplaceZone("America/Los_Angeles") - .currency("USD") - .build(); - } - - private ChannelAccount amazonAccount(String sid) { - return ChannelAccount.builder() - .key(AccountKey.of(ChannelProvider.LINGXING, Platform.AMAZON_SC, "oms-amz-smoke")) - .externalStoreId(sid) - .platformCode(10001) - .credentialRef("smoke") - .marketplaceZone("America/Los_Angeles") - .currency("USD") - .build(); - } - - /** 打印真实请求与响应,签名/字段名不对时靠这个定位。Authorization 只打指纹。 */ - static final class LoggingTransport implements HttpTransport { - - private static final int MAX_BODY = 2000; - - private final HttpTransport delegate; - - LoggingTransport(HttpTransport delegate) { - this.delegate = delegate; - } - - @Override - public HttpResponse execute(HttpRequest request) { - System.out.println("--> " + request.method() + " " + request.url()); - System.out.println(" headers " + mask(request.headers().toString())); - System.out.println(" body " + truncate(request.body())); - HttpResponse response = delegate.execute(request); - System.out.println("<-- " + response.statusCode() + " (" + response.latencyMillis() + " ms) " - + truncate(response.body())); - return response; - } - - private static String mask(String headers) { - return headers.replaceAll("(?i)(bearer\\s+)[^,\\]]+", "$1***"); - } - - private static String truncate(String body) { - if (body == null) { - return "null"; - } - return body.length() <= MAX_BODY ? body : body.substring(0, MAX_BODY) + "...(" + body.length() + " chars)"; - } - } -} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/AmazonScProductLiveTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/AmazonScProductLiveTest.java deleted file mode 100644 index 2e5d9df..0000000 --- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/AmazonScProductLiveTest.java +++ /dev/null @@ -1,229 +0,0 @@ -package common.ecommerce.lingxing.platform.amazon.sc; - -import common.ecommerce.capability.AggregatorCapable.SubChannel; -import common.ecommerce.http.HttpRequest; -import common.ecommerce.http.HttpResponse; -import common.ecommerce.http.HttpTransport; -import common.ecommerce.http.JacksonJsonCodec; -import common.ecommerce.http.OkHttpTransport; -import common.ecommerce.lingxing.LingxingConstants; -import common.ecommerce.lingxing.adapter.LingxingAdapter; -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.product.ProductListing; -import common.ecommerce.model.product.ProductQuery; -import common.ecommerce.model.support.Page; -import common.ecommerce.sdk.ChannelConnection; -import common.ecommerce.sdk.ChannelContext; -import common.ecommerce.spi.ChannelSecret; -import common.ecommerce.testkit.InMemoryLockProvider; -import common.ecommerce.testkit.InMemoryTokenStore; -import org.junit.jupiter.api.Test; - -import java.time.Clock; -import java.time.Duration; -import java.time.Instant; -import java.util.List; - -import static org.junit.jupiter.api.Assertions.assertFalse; -import static org.junit.jupiter.api.Assertions.assertNotNull; - -/** - * 领星 · 亚马逊 SC 真实环境测试:先查店铺列表拿 sid,再用 sid 拉 Listing。 - * - *

跑之前填 APP_KEY / APP_SECRET 即可;SID 留空时会自动从店铺列表取第一个。

- *
- * mvn -pl lingxing -am test -Dtest=AmazonScProductLiveTest
- * 
- * - *

调用前确认出口 IP 已加入领星白名单。本类只用于联调,不要把真实凭证提交到仓库。

- * - *

两个接口的令牌桶容量都是 1,且按「账户 + path」共享,必须串行调用。

- */ -class AmazonScProductLiveTest { - - // ==================== 填写这里 ==================== - /** 领星 ERP 开放接口的 AppID。 */ - private static final String APP_KEY = "ak_MWoHJz2tcIwKF"; - /** 领星 ERP 开放接口的 AppSecret。 */ - private static final String APP_SECRET = "YOUkd5efWJSK71jLvDyz+g=="; - /** - * 亚马逊店铺的领星 sid。 - * 留空则自动调用店铺列表接口,取第一个正常状态的店铺。 - */ - private static final String SID = "13839"; - // ================================================ - - private static final String BASE_URL = LingxingConstants.PRODUCTION_BASE_URL; - - private final JacksonJsonCodec json = new JacksonJsonCodec(); - private final LoggingTransport transport = - new LoggingTransport(new OkHttpTransport("common-ecommerce-smoke")); - - /** - * 店铺列表:一次性返回企业已授权到领星的全部亚马逊 SC 店铺。 - * - *

接口 {@code GET /erp/sc/data/seller/lists},非分页。打印每个店铺的 sid 与名称, - * 同时打印请求与响应原始报文(见 LoggingTransport),便于核对字段名。

- */ - @Test - void listsAmazonShops() { - requireConfigured(); - - List channels = adapter().listSubChannels(shopListContext()); - System.out.println("[shops] subChannels size=" + channels.size()); - for (SubChannel c : channels) { - System.out.println(" platformCode=" + c.platformCode() - + " sid=" + c.externalStoreId() - + " platform=" + c.platform() - + " name=" + c.name()); - } - assertNotNull(channels); - } - - /** 拿第一个正常店铺的 sid,调 Listing 接口。 */ - @Test - void pullsOnePageOfListings() { - requireConfigured(); - - String sid = resolveSid(); - System.out.println("[listings] 使用 sid=" + sid); - - ChannelContext ctx = ChannelContext.of(amazonAccount(sid), connection(), - "smoke-" + System.currentTimeMillis(), Clock.systemUTC()); - - Instant to = Instant.now(); - Instant from = to.minus(Duration.ofDays(7)); - - Page page = adapter().pull(ctx, ProductQuery.builder() - .updatedAfter(from) - .updatedBefore(to) - .pageSize(20) - .build()); - - System.out.println("[listings] window=" + from + " .. " + to - + " items=" + page.size() + " nextCursor=" + page.nextCursor()); - for (ProductListing p : page.items()) { - System.out.println(" sku=" + p.platformSku() - + " title=" + p.title() - + " status=" + p.status() - + " images=" + p.imageUrls().size() - + " updatedAt=" + (p.updatedAt() == null ? null : p.updatedAt().utc())); - } - assertFalse(page.size() > 20, "pageSize 未被平台遵守"); - } - - /** 不带时间窗,确认默认分页与解析也能走通。 */ - @Test - void pullsFirstPageWithoutTimeWindow() { - requireConfigured(); - - String sid = resolveSid(); - ChannelContext ctx = ChannelContext.of(amazonAccount(sid), connection(), - "smoke-" + System.currentTimeMillis(), Clock.systemUTC()); - - Page page = adapter().pull(ctx, ProductQuery.builder().pageSize(10).build()); - - System.out.println("[listings/no-window] sid=" + sid + " items=" + page.size() - + " nextCursor=" + page.nextCursor()); - for (ProductListing p : page.items()) { - System.out.println(" sku=" + p.platformSku() + " status=" + p.status()); - } - // 店铺可能没有商品,空列表也算通过 - assertNotNull(page); - } - - // ---------------------------------------------------------------- helpers - - private static void requireConfigured() { - org.junit.jupiter.api.Assumptions.assumeTrue( - !APP_KEY.startsWith("在这里填") && !APP_SECRET.startsWith("在这里填"), - "请先填写 AmazonScProductLiveTest 顶部的 APP_KEY / APP_SECRET"); - } - - /** 优先用常量里的 SID;留空则从店铺列表取第一个。 */ - private String resolveSid() { - if (SID != null && !SID.trim().isEmpty() && !SID.startsWith("在这里填")) { - return SID.trim(); - } - List channels = adapter().listSubChannels(shopListContext()); - if (channels.isEmpty()) { - throw new AssertionError("店铺列表为空:该企业没有已授权且状态正常的亚马逊 SC 店铺"); - } - return channels.get(0).externalStoreId(); - } - - private LingxingAdapter adapter() { - return new LingxingAdapter(transport, json, - new InMemoryTokenStore(), new InMemoryLockProvider(), Clock.systemUTC()); - } - - private ChannelConnection connection() { - return ChannelConnection.of(BASE_URL, ChannelSecret.builder() - .appKey(APP_KEY).appSecret(APP_SECRET).build()); - } - - /** 店铺列表所用的上下文:店铺维度此时还不存在,用占位 omsStoreId。 */ - private ChannelContext shopListContext() { - return ChannelContext.of(placeholderAccount(), connection(), - "smoke-shops-" + System.currentTimeMillis(), Clock.systemUTC()); - } - - private ChannelAccount placeholderAccount() { - return ChannelAccount.builder() - .key(AccountKey.of(ChannelProvider.LINGXING, Platform.AMAZON_SC, "oms-amz-discovery")) - .externalStoreId("discovery") - .platformCode(10001) - .credentialRef("smoke") - .marketplaceZone("America/Los_Angeles") - .currency("USD") - .build(); - } - - private ChannelAccount amazonAccount(String sid) { - return ChannelAccount.builder() - .key(AccountKey.of(ChannelProvider.LINGXING, Platform.AMAZON_SC, "oms-amz-smoke")) - .externalStoreId(sid) - .platformCode(10001) - .credentialRef("smoke") - .marketplaceZone("America/Los_Angeles") - .currency("USD") - .build(); - } - - /** 打印真实请求与响应,签名/字段名不对时靠这个定位。Authorization 只打指纹。 */ - static final class LoggingTransport implements HttpTransport { - - private static final int MAX_BODY = 2000; - - private final HttpTransport delegate; - - LoggingTransport(HttpTransport delegate) { - this.delegate = delegate; - } - - @Override - public HttpResponse execute(HttpRequest request) { - System.out.println("--> " + request.method() + " " + request.url()); - System.out.println(" headers " + mask(request.headers().toString())); - System.out.println(" body " + truncate(request.body())); - HttpResponse response = delegate.execute(request); - System.out.println("<-- " + response.statusCode() + " (" + response.latencyMillis() + " ms) " - + truncate(response.body())); - return response; - } - - private static String mask(String headers) { - return headers.replaceAll("(?i)(bearer\\s+)[^,\\]]+", "$1***"); - } - - private static String truncate(String body) { - if (body == null) { - return "null"; - } - return body.length() <= MAX_BODY ? body : body.substring(0, MAX_BODY) + "...(" + body.length() + " chars)"; - } - } -} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java new file mode 100644 index 0000000..d109bc3 --- /dev/null +++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java @@ -0,0 +1,75 @@ +package common.ecommerce.lingxing.platform.amazon.sc.product; + +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.model.Platform; +import common.ecommerce.model.product.ProductListing; +import common.ecommerce.model.product.ProductQuery; +import common.ecommerce.model.product.ProductSearchField; +import common.ecommerce.model.product.ProductStatus; +import common.ecommerce.testkit.JsonFixture; +import common.ecommerce.testkit.RecordingTransport; +import common.ecommerce.testkit.Responses; +import org.junit.jupiter.api.Test; + +import static common.ecommerce.lingxing.support.LingxingTestSupport.account; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.call; +import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody; +import static org.junit.jupiter.api.Assertions.assertEquals; + +/** + * 亚马逊 SC 在线商品。 + * + *

搜索字段是字符串(seller_sku / sku),搜索值是数组 + exact_search 开关, + * 与其它平台的数字枚举不同。

+ */ +class AmazonScProductSourceTest { + + private final RecordingTransport transport = RecordingTransport.create() + .route(LingxingApi.LISTING_AMAZON_SC.path(), + r -> Responses.ok(JsonFixture.load("fixtures/lingxing/amazonScListing/success.json"))); + + @Test + void platformSkuSearchUsesStringFieldAndExactSwitch() { + new AmazonScProductSource().products(call(transport, account(Platform.AMAZON_SC, 10001, "1099")), + ProductQuery.builder() + .searchField(ProductSearchField.PLATFORM_SKU) + .searchValue("AMZ-MSKU-1") + .build()); + + String body = lastBody(transport); + assertBodyContains(body, "\"sid\":\"1099\""); + assertBodyContains(body, "\"search_field\":\"seller_sku\""); + // 单值模糊:数组 + exact_search=0 + assertBodyContains(body, "\"search_value\":[\"AMZ-MSKU-1\"]"); + assertBodyContains(body, "\"exact_search\":0"); + } + + @Test + void multiValueSearchUsesExactSwitch() { + new AmazonScProductSource().products(call(transport, account(Platform.AMAZON_SC, 10001, "1099")), + ProductQuery.builder() + .searchField(ProductSearchField.LOCAL_SKU) + .searchValues(java.util.Arrays.asList("A", "B")) + .build()); + + String body = lastBody(transport); + assertBodyContains(body, "\"search_field\":\"sku\""); + assertBodyContains(body, "\"search_value\":[\"A\",\"B\"]"); + assertBodyContains(body, "\"exact_search\":1"); + } + + @Test + void mapsResponse() { + ProductListing p = new AmazonScProductSource().products( + call(transport, account(Platform.AMAZON_SC, 10001, "1099")), + ProductQuery.builder().build()).items().get(0); + + assertEquals(Platform.AMAZON_SC, p.platform()); + assertEquals("AMZ-MSKU-1", p.platformSku()); + assertEquals("Amazon Item", p.title()); + assertEquals(ProductStatus.ACTIVE, p.status()); + assertEquals("USD", p.currency()); + assertEquals("29.99", p.price().amount().toPlainString()); + } +} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java new file mode 100644 index 0000000..b0ed2c8 --- /dev/null +++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java @@ -0,0 +1,60 @@ +package common.ecommerce.lingxing.platform.amazon.vc.product; + +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.model.Platform; +import common.ecommerce.model.product.ProductListing; +import common.ecommerce.model.product.ProductQuery; +import common.ecommerce.model.product.ProductSearchField; +import common.ecommerce.model.product.ProductStatus; +import common.ecommerce.testkit.JsonFixture; +import common.ecommerce.testkit.RecordingTransport; +import common.ecommerce.testkit.Responses; +import org.junit.jupiter.api.Test; + +import static common.ecommerce.lingxing.support.LingxingTestSupport.account; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.call; +import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertThrows; + +/** 亚马逊 VC 在线商品:请求构造 + 响应映射;不支持搜索。 */ +class AmazonVcProductSourceTest { + + private final RecordingTransport transport = RecordingTransport.create() + .route(LingxingApi.LISTING_AMAZON_VC.path(), + r -> Responses.ok(JsonFixture.load("fixtures/lingxing/amazonVcListing/success.json"))); + + @Test + void requestCarriesVcStoreIds() { + new AmazonVcProductSource().products(call(transport, account(Platform.AMAZON_VC, 10035, "1342")), + ProductQuery.builder().pageSize(20).build()); + + assertBodyContains(lastBody(transport), "\"vc_store_ids\":[\"1342\"]"); + assertBodyContains(lastBody(transport), "\"length\":20"); + } + + @Test + void searchUnsupportedFailsLoudly() { + assertThrows(UnsupportedOperationException.class, + () -> new AmazonVcProductSource().products( + call(transport, account(Platform.AMAZON_VC, 10035, "1342")), + ProductQuery.builder() + .searchField(ProductSearchField.PLATFORM_SKU) + .searchValue("VC-MSKU-1") + .build())); + } + + @Test + void mapsResponse() { + ProductListing p = new AmazonVcProductSource().products( + call(transport, account(Platform.AMAZON_VC, 10035, "1342")), + ProductQuery.builder().build()).items().get(0); + + assertEquals(Platform.AMAZON_VC, p.platform()); + assertEquals("VC-MSKU-1", p.platformSku()); + assertEquals("B0BG2CMB5J", p.asin()); + assertEquals(ProductStatus.ACTIVE, p.status()); + assertEquals("USD", p.currency()); + } +} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java new file mode 100644 index 0000000..62e6cd1 --- /dev/null +++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java @@ -0,0 +1,62 @@ +package common.ecommerce.lingxing.platform.ebay.product; + +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.model.Platform; +import common.ecommerce.model.product.ProductListing; +import common.ecommerce.model.product.ProductQuery; +import common.ecommerce.model.product.ProductSearchField; +import common.ecommerce.model.product.ProductStatus; +import common.ecommerce.testkit.JsonFixture; +import common.ecommerce.testkit.RecordingTransport; +import common.ecommerce.testkit.Responses; +import org.junit.jupiter.api.Test; + +import java.time.Instant; + +import static common.ecommerce.lingxing.support.LingxingTestSupport.account; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.call; +import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; + +/** eBay 在线商品:请求构造 + 响应映射。 */ +class EbayProductSourceTest { + + private final RecordingTransport transport = RecordingTransport.create() + .route(LingxingApi.LISTING_EBAY.path(), + r -> Responses.ok(JsonFixture.load("fixtures/lingxing/ebayListing/success.json"))); + + @Test + void requestCarriesStoreAndTimeWindow() { + new EbayProductSource().products(call(transport, account(Platform.EBAY, 10003, "1106")), + ProductQuery.builder() + .updatedAfter(Instant.parse("2026-10-01T00:00:00Z")) + .updatedBefore(Instant.parse("2026-10-08T00:00:00Z")) + .searchField(ProductSearchField.PLATFORM_SKU) + .searchValue("EBAY-MSKU-1") + .build()); + + String body = lastBody(transport); + assertBodyContains(body, "\"store_ids\":[\"1106\"]"); + assertBodyContains(body, "\"listing_time_field\":1"); + assertBodyContains(body, "\"searchField\":1"); + assertBodyContains(body, "\"searchSingleValue\":\"EBAY-MSKU-1\""); + } + + @Test + void mapsResponseAndStatus() { + ProductListing p = new EbayProductSource().products( + call(transport, account(Platform.EBAY, 10003, "1106")), + ProductQuery.builder().build()).items().get(0); + + assertEquals(Platform.EBAY, p.platform()); + assertEquals("EBAY-MSKU-1", p.platformSku()); + assertEquals("123943065211", p.listingId()); + assertEquals(ProductStatus.ACTIVE, p.status()); + assertEquals("在售", p.rawStatus()); + // 接口不返回币种 → 金额为空 + assertNull(p.price()); + assertNull(p.currency()); + } +} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java new file mode 100644 index 0000000..f337302 --- /dev/null +++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java @@ -0,0 +1,56 @@ +package common.ecommerce.lingxing.platform.shein.product; + +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.model.Platform; +import common.ecommerce.model.product.ProductListing; +import common.ecommerce.model.product.ProductQuery; +import common.ecommerce.model.product.ProductSearchField; +import common.ecommerce.model.product.ProductStatus; +import common.ecommerce.testkit.JsonFixture; +import common.ecommerce.testkit.RecordingTransport; +import common.ecommerce.testkit.Responses; +import org.junit.jupiter.api.Test; + +import static common.ecommerce.lingxing.support.LingxingTestSupport.account; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyNotContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.call; +import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody; +import static org.junit.jupiter.api.Assertions.assertEquals; + +/** SHEIN 在线商品:请求构造 + 响应映射。 */ +class SheinProductSourceTest { + + private final RecordingTransport transport = RecordingTransport.create() + .route(LingxingApi.LISTING_SHEIN.path(), + r -> Responses.ok(JsonFixture.load("fixtures/lingxing/sheinListing/success.json"))); + + @Test + void requestCarriesStoreAndSearch() { + new SheinProductSource().products(call(transport, account(Platform.SHEIN, 10028, "1105")), + ProductQuery.builder() + .searchField(ProductSearchField.PLATFORM_SKU) + .searchValue("SHEIN-MSKU-1") + .build()); + + String body = lastBody(transport); + assertBodyContains(body, "\"storeIds\":[\"1105\"]"); + assertBodyContains(body, "\"searchField\":9"); + assertBodyContains(body, "\"searchSingleValue\":\"SHEIN-MSKU-1\""); + // 该接口没有时间窗参数 + assertBodyNotContains(body, "updateStartTime"); + } + + @Test + void mapsResponseWithSalePrice() { + ProductListing p = new SheinProductSource().products( + call(transport, account(Platform.SHEIN, 10028, "1105")), + ProductQuery.builder().build()).items().get(0); + + assertEquals(Platform.SHEIN, p.platform()); + assertEquals("SHEIN-MSKU-1", p.platformSku()); + assertEquals(ProductStatus.ACTIVE, p.status()); + assertEquals("USD", p.currency()); + assertEquals("19.8", p.price().amount().toPlainString()); + } +} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java new file mode 100644 index 0000000..88321a7 --- /dev/null +++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java @@ -0,0 +1,67 @@ +package common.ecommerce.lingxing.platform.temu.product; + +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.model.Platform; +import common.ecommerce.model.product.ProductListing; +import common.ecommerce.model.product.ProductQuery; +import common.ecommerce.model.product.ProductSearchField; +import common.ecommerce.model.product.ProductStatus; +import common.ecommerce.testkit.JsonFixture; +import common.ecommerce.testkit.RecordingTransport; +import common.ecommerce.testkit.Responses; +import org.junit.jupiter.api.Test; + +import java.util.Arrays; + +import static common.ecommerce.lingxing.support.LingxingTestSupport.account; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.call; +import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; + +/** Temu 在线商品:请求构造 + 响应映射。 */ +class TemuProductSourceTest { + + private final RecordingTransport transport = RecordingTransport.create() + .route(LingxingApi.LISTING_TEMU.path(), + r -> Responses.ok(JsonFixture.load("fixtures/lingxing/temuListing/success.json"))); + + @Test + void requestUsesCursorFalseAndPagedBody() { + new TemuProductSource().products(call(transport, account(Platform.TEMU, 10024, "1105")), + ProductQuery.builder().pageSize(30) + .searchField(ProductSearchField.PLATFORM_SKU) + .searchValues(Arrays.asList("A", "B")) + .build()); + + String body = lastBody(transport); + assertBodyContains(body, "\"useCursor\":false"); + assertBodyContains(body, "\"storeIds\":[\"1105\"]"); + assertBodyContains(body, "\"length\":30"); + // Temu 的平台 SKU 是 9 + assertBodyContains(body, "\"searchField\":9"); + assertBodyContains(body, "\"searchValues\":[\"A\",\"B\"]"); + } + + @Test + void localSkuUsesField8() { + new TemuProductSource().products(call(transport, account(Platform.TEMU, 10024, "1105")), + ProductQuery.builder().searchField(ProductSearchField.LOCAL_SKU).searchValue("x").build()); + assertBodyContains(lastBody(transport), "\"searchField\":8"); + } + + @Test + void mapsResponseToUnifiedModel() { + ProductListing p = new TemuProductSource().products( + call(transport, account(Platform.TEMU, 10024, "1105")), + ProductQuery.builder().build()).items().get(0); + + assertEquals(Platform.TEMU, p.platform()); + assertEquals("TEMU-MSKU-1", p.platformSku()); + assertEquals("Temu Item", p.title()); + assertEquals(ProductStatus.ACTIVE, p.status()); + // Temu 商品接口没有独立价格字段,金额为空 + assertNull(p.price()); + } +} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java new file mode 100644 index 0000000..14dd72f --- /dev/null +++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java @@ -0,0 +1,49 @@ +package common.ecommerce.lingxing.platform.tiktok.product; + +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.model.Platform; +import common.ecommerce.model.product.ProductListing; +import common.ecommerce.model.product.ProductQuery; +import common.ecommerce.model.product.ProductStatus; +import common.ecommerce.testkit.JsonFixture; +import common.ecommerce.testkit.RecordingTransport; +import common.ecommerce.testkit.Responses; +import org.junit.jupiter.api.Test; + +import static common.ecommerce.lingxing.support.LingxingTestSupport.account; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.call; +import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody; +import static org.junit.jupiter.api.Assertions.assertEquals; + +/** TikTok 在线商品:请求构造 + 响应映射。 */ +class TiktokProductSourceTest { + + private final RecordingTransport transport = RecordingTransport.create() + .route(LingxingApi.LISTING_TIKTOK.path(), + r -> Responses.ok(JsonFixture.load("fixtures/lingxing/tiktokListing/success.json"))); + + @Test + void requestCarriesStore() { + new TiktokProductSource().products(call(transport, account(Platform.TIKTOK, 10011, "1104")), + ProductQuery.builder().pageSize(20).build()); + + String body = lastBody(transport); + assertBodyContains(body, "\"storeIds\":[\"1104\"]"); + assertBodyContains(body, "\"length\":20"); + } + + @Test + void mapsPlatformStatusString() { + ProductListing p = new TiktokProductSource().products( + call(transport, account(Platform.TIKTOK, 10011, "1104")), + ProductQuery.builder().build()).items().get(0); + + assertEquals(Platform.TIKTOK, p.platform()); + assertEquals("TT-MSKU-1", p.platformSku()); + assertEquals(ProductStatus.ACTIVE, p.status()); + assertEquals("ACTIVATE", p.rawStatus()); + assertEquals("USD", p.currency()); + assertEquals("117.50", p.price().amount().toPlainString()); + } +} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java new file mode 100644 index 0000000..72497e3 --- /dev/null +++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java @@ -0,0 +1,85 @@ +package common.ecommerce.lingxing.platform.walmart.product; + +import common.ecommerce.lingxing.LingxingApi; +import common.ecommerce.model.Platform; +import common.ecommerce.model.product.ProductListing; +import common.ecommerce.model.product.ProductQuery; +import common.ecommerce.model.product.ProductSearchField; +import common.ecommerce.model.product.ProductStatus; +import common.ecommerce.model.support.Page; +import common.ecommerce.testkit.JsonFixture; +import common.ecommerce.testkit.RecordingTransport; +import common.ecommerce.testkit.Responses; +import org.junit.jupiter.api.Test; + +import java.time.Instant; + +import static common.ecommerce.lingxing.support.LingxingTestSupport.ENDPOINT; +import static common.ecommerce.lingxing.support.LingxingTestSupport.account; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains; +import static common.ecommerce.lingxing.support.LingxingTestSupport.assertUrlStartsWith; +import static common.ecommerce.lingxing.support.LingxingTestSupport.call; +import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody; +import static common.ecommerce.lingxing.support.LingxingTestSupport.lastUrl; +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; + +/** 沃尔玛在线商品:请求构造 + 响应映射。 */ +class WalmartProductSourceTest { + + private final RecordingTransport transport = RecordingTransport.create() + .route(LingxingApi.LISTING_WALMART.path(), + r -> Responses.ok(JsonFixture.load("fixtures/lingxing/walmartListing/success.json"))); + + @Test + void requestCarriesStoreTimeWindowAndSearch() { + new WalmartProductSource().products(call(transport, account(Platform.WALMART_SC, 10008, "1108")), + ProductQuery.builder() + .updatedAfter(Instant.parse("2026-10-01T00:00:00Z")) + .updatedBefore(Instant.parse("2026-10-08T00:00:00Z")) + .pageSize(50) + .searchField(ProductSearchField.PLATFORM_SKU) + .searchValue("WM-MSKU-1") + .build()); + + assertUrlStartsWith(lastUrl(transport), ENDPOINT + LingxingApi.LISTING_WALMART.path()); + String body = lastBody(transport); + assertBodyContains(body, "\"store_ids\":[\"1108\"]"); + assertBodyContains(body, "\"offset\":0"); + assertBodyContains(body, "\"length\":50"); + assertBodyContains(body, "\"listing_time_field\":2"); + assertBodyContains(body, "\"listing_start_time\":\"2026-10-01\""); + assertBodyContains(body, "\"searchField\":1"); + assertBodyContains(body, "\"searchSingleValue\":\"WM-MSKU-1\""); + } + + @Test + void localSkuSearchUsesField3() { + new WalmartProductSource().products(call(transport, account(Platform.WALMART_SC, 10008, "1108")), + ProductQuery.builder() + .searchField(ProductSearchField.LOCAL_SKU) + .searchValue("WM-LOCAL-1") + .build()); + + assertBodyContains(lastBody(transport), "\"searchField\":3"); + } + + @Test + void mapsResponseToUnifiedModel() { + Page page = new WalmartProductSource().products( + call(transport, account(Platform.WALMART_SC, 10008, "1108")), + ProductQuery.builder().build()); + + assertEquals(1, page.size()); + ProductListing p = page.items().get(0); + assertEquals(Platform.WALMART_SC, p.platform()); + assertEquals("WM-MSKU-1", p.platformSku()); + assertEquals("Walmart Item", p.title()); + assertEquals(ProductStatus.ACTIVE, p.status()); + assertEquals("PUBLISHED", p.rawStatus()); + assertEquals("USD", p.currency()); + assertEquals("139.90", p.price().amount().toPlainString()); + assertEquals("00723849594300", p.gtin()); + assertNull(page.nextCursor()); + } +} diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java index d6e49b7..a9f1e79 100644 --- a/lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java +++ b/lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java @@ -19,6 +19,7 @@ import common.ecommerce.spi.AccessToken; import common.ecommerce.spi.ChannelSecret; import org.junit.jupiter.api.Assumptions; import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfSystemProperty; import java.time.Clock; import java.util.ArrayList; @@ -30,6 +31,8 @@ import java.util.Map; /** * 只读探针:实测各平台商品列表接口的 {@code searchField} 枚举值含义。 * + *

默认跳过;用 {@code -Dlingxing.probe=true} 显式开启。

+ * *

只做查询,不创建、不修改任何数据。

* *

用法:填好下面四个常量后运行

@@ -41,6 +44,7 @@ import java.util.Map; * 命中时返回的是 {@code msku} 还是 {@code sku}。 * 拿到结果后再去写正式的平台映射表。

*/ +@EnabledIfSystemProperty(named = "lingxing.probe", matches = "true") class SearchFieldProbeTest { // ==================== 填写这里 ==================== diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java index a3091a9..c94977a 100644 --- a/lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java +++ b/lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java @@ -21,6 +21,7 @@ import common.ecommerce.spi.AccessToken; import common.ecommerce.spi.ChannelSecret; import org.junit.jupiter.api.Assumptions; import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfSystemProperty; import java.time.Clock; import java.util.ArrayList; @@ -36,6 +37,8 @@ import java.util.TreeMap; *

用途:文档里没有 AliExpress 的 platform_code, * 这个测试直接从店铺列表接口读出来。

* + *

默认跳过;用 {@code -Dlingxing.probe=true} 显式开启。

+ * *

只做查询,不创建、不修改数据。

* *

用法:填好 APP_KEY / APP_SECRET,然后

@@ -53,6 +56,7 @@ import java.util.TreeMap; * ... * */ +@EnabledIfSystemProperty(named = "lingxing.probe", matches = "true") class ShopListProbeTest { // ==================== 填写这里 ==================== diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java b/lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java new file mode 100644 index 0000000..5b4abde --- /dev/null +++ b/lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java @@ -0,0 +1,122 @@ +package common.ecommerce.lingxing.support; + +import common.ecommerce.http.JacksonJsonCodec; +import common.ecommerce.lingxing.LingxingConstants; +import common.ecommerce.lingxing.auth.LingxingTokenClient; +import common.ecommerce.lingxing.http.LingxingRateLimiter; +import common.ecommerce.lingxing.http.LingxingRequestFactory; +import common.ecommerce.lingxing.platform.LingxingCall; +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.sdk.ChannelConnection; +import common.ecommerce.sdk.ChannelContext; +import common.ecommerce.spi.AccessToken; +import common.ecommerce.spi.ChannelSecret; +import common.ecommerce.testkit.RecordingTransport; + +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; + +/** + * 领星测试的公共样板:固定时钟、固定账户、组装 {@link LingxingCall}。 + * + *

各平台的契约测试只需要关心「请求怎么拼」和「响应怎么映射」, + * 不用重复写 token、签名、限流的装配。

+ */ +public final class LingxingTestSupport { + + /** + * 领星 appId 同时作为签名 AES 密钥,长度必须是 16/24/32 字节, + * 所以测试值固定 16 个字符。 + */ + public static final String APP_KEY = "test-app-id-1234"; + + public static final String APP_SECRET = "test-app-secret"; + + public static final String ENDPOINT = LingxingConstants.PRODUCTION_BASE_URL; + + public static final Clock CLOCK = Clock.fixed(Instant.parse("2026-11-04T00:00:00Z"), ZoneOffset.UTC); + + private static final JacksonJsonCodec JSON = new JacksonJsonCodec(); + + private LingxingTestSupport() { + } + + /** 亚马逊 SC 账户;其它平台用 {@link #account(Platform, int, String)}。 */ + public static ChannelAccount amazonScAccount() { + return account(Platform.AMAZON_SC, 10001, "1099"); + } + + /** + * @param platform 业务平台(与 AccountKey 的 platform 一致) + * @param platformCode 领星 platform_code;为 0 时不设置 + * @param storeId 领星 store_id;为空时不设置 + */ + public static ChannelAccount account(Platform platform, int platformCode, String storeId) { + return ChannelAccount.builder() + .key(AccountKey.of(ChannelProvider.LINGXING, platform, "oms-" + platform.name().toLowerCase())) + .externalStoreId(storeId == null || storeId.trim().isEmpty() ? "probe" : storeId) + .platformCode(platformCode == 0 ? null : platformCode) + .credentialRef("test") + .marketplaceZone("America/Los_Angeles") + .currency("USD") + .build(); + } + + /** + * 组装一次调用的上下文,并先换一次 token。 + * + *

token 请求走 {@link RecordingTransport} 的默认响应,不占业务路由。

+ */ + public static LingxingCall call(RecordingTransport transport, ChannelAccount account) { + ChannelSecret secret = ChannelSecret.builder().appKey(APP_KEY).appSecret(APP_SECRET).build(); + ChannelConnection conn = ChannelConnection.of(ENDPOINT, secret); + ChannelContext ctx = ChannelContext.of(account, conn, "req-1", CLOCK); + AccessToken token = new LingxingTokenClient(transport, JSON, CLOCK) + .fetch(ENDPOINT, APP_KEY, APP_SECRET); + return new LingxingCall(ctx, token, new LingxingRequestFactory(JSON, CLOCK), + new LingxingRateLimiter(), JSON, transport); + } + + /** 取最后一次业务请求的请求体;没有业务请求时报错。 */ + public static String lastBody(RecordingTransport transport) { + common.ecommerce.http.HttpRequest req = transport.lastDataRequest(); + if (req == null) { + throw new AssertionError("no data request was made"); + } + return req.body(); + } + + /** 取最后一次业务请求的 URL。 */ + public static String lastUrl(RecordingTransport transport) { + common.ecommerce.http.HttpRequest req = transport.lastDataRequest(); + if (req == null) { + throw new AssertionError("no data request was made"); + } + return req.url(); + } + + /** 断言 JSON 体包含某片段。 */ + public static void assertBodyContains(String body, String snippet) { + if (!body.contains(snippet)) { + throw new AssertionError("期望请求体包含 " + snippet + ",实际:" + body); + } + } + + /** 断言请求体不包含某片段。 */ + public static void assertBodyNotContains(String body, String snippet) { + if (body.contains(snippet)) { + throw new AssertionError("期望请求体不包含 " + snippet + ",实际:" + body); + } + } + + /** 断言 URL 以某路径开头。 */ + public static void assertUrlStartsWith(String url, String prefix) { + if (!url.startsWith(prefix)) { + throw new AssertionError("期望 URL 以 " + prefix + " 开头,实际:" + url); + } + } +} diff --git a/lingxing/src/test/resources/fixtures/lingxing/aliexpressListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/aliexpressListing/success.json new file mode 100644 index 0000000..ace60ed --- /dev/null +++ b/lingxing/src/test/resources/fixtures/lingxing/aliexpressListing/success.json @@ -0,0 +1,8 @@ +{"code":0,"data":{"count":1,"list":[{ + "id":100001,"productUniqueId":1234567890,"msku":"AE-MSKU-1","sku":"AE-LOCAL-1", + "pname":"品名","title":"AliExpress Item","productId":"32987654321","itemId":"ITEM1", + "status":2,"statusName":"可售","currencyCode":"USD","effectiveSupplyPrice":"59.99", + "price":5999,"storeId":8888,"storeName":"AE 测试店","platformCode":"aliexpress", + "createTime":"2024-01-15 10:30:00","imageUrls":"https://img/ae.jpg", + "supplyPriceList":[{"beginStr":"2024-01-01","currency":"USD","endStr":null,"price":49.99}] +}]}} diff --git a/lingxing/src/test/resources/fixtures/lingxing/amazonScListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/amazonScListing/success.json new file mode 100644 index 0000000..2d4d077 --- /dev/null +++ b/lingxing/src/test/resources/fixtures/lingxing/amazonScListing/success.json @@ -0,0 +1,7 @@ +{"code":0,"message":"success","total":1,"data":[{ + "sid":1099,"seller_sku":"AMZ-MSKU-1","asin":"B0B4WP82XX","parent_asin":"B0B4WP82XX", + "item_name":"Amazon Item","small_image_url":"https://img/amz.jpg","status":1,"is_delete":0, + "currency_code":"USD","price":"29.99","listing_update_date":"2023-06-28 17:44:14", + "listing_id":"0623ZI1F5EF11","local_sku":"AMZ-LOCAL-1","local_name":"品名", + "fulfillment_channel_type":"FBM","marketplace":"美国" +}]} diff --git a/lingxing/src/test/resources/fixtures/lingxing/amazonVcListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/amazonVcListing/success.json new file mode 100644 index 0000000..5a279ba --- /dev/null +++ b/lingxing/src/test/resources/fixtures/lingxing/amazonVcListing/success.json @@ -0,0 +1,6 @@ +{"code":0,"message":"success","total":1,"data":[{ + "vc_store_id":"134225003201380864","small_min_image_url":"https://img/vc.jpg", + "asin":"B0BG2CMB5J","msku":"VC-MSKU-1","item_name":"VC Item","parent_asin":"", + "local_sku":"VC-LOCAL-1","local_name":"品名","status":1,"price":"123", + "price_currency_icon":"$","on_sale_time":"1970-01-01" +}]} diff --git a/lingxing/src/test/resources/fixtures/lingxing/ebayListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/ebayListing/success.json new file mode 100644 index 0000000..ec40250 --- /dev/null +++ b/lingxing/src/test/resources/fixtures/lingxing/ebayListing/success.json @@ -0,0 +1,10 @@ +{"code":0,"message":"success","total":1,"data":[{ + "item_url":"https://www.ebay.com/itm/353943065214","picture_url":"https://img/ebay.jpg", + "item_id":"123943065211","msku":"EBAY-MSKU-1","attribute":"Black/Regular/S", + "title":"Cotton T Shirt","local_name":null,"local_sku":"EBAY-LOCAL-1", + "listing_status":1,"listing_status_name":"在售","store_id":"1106","store_name":"EBA 测试店", + "site_code":"10003-US","site_name":"美国","listing_type":3,"listing_type_name":"多属性", + "price":"0.99","start_price":"0.00","accept_price":"0.00","quantity":1, + "location":"Shenzhen","dispatch_time_max":20, + "listing_start_time":"2022-03-07 14:41:01","listing_end_time":"2022-04-03 14:41:01" +}]} diff --git a/lingxing/src/test/resources/fixtures/lingxing/sheinListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/sheinListing/success.json new file mode 100644 index 0000000..f3de494 --- /dev/null +++ b/lingxing/src/test/resources/fixtures/lingxing/sheinListing/success.json @@ -0,0 +1,7 @@ +{"code":0,"message":"success","total":0,"data":{"count":1,"list":[{ + "id":"145","productUniqueId":"901458096084689408","storeId":"1105","storeName":"SHEIN 测试店", + "platformCode":"10028","mskuId":"m-1","msku":"SHEIN-MSKU-1","pname":"品名","sku":"SHEIN-LOCAL-1", + "pid":"5761","title":"SHEIN Item","cid":"12","bid":"10","status":1, + "imgUrl":"https://img/shein.jpg","skc":"SKC","spu":"SPU","attribute":"白色", + "salePrice":19.8,"saleCurrency":"$","inventoryQuantity":50,"usableInventory":5 +}]}} diff --git a/lingxing/src/test/resources/fixtures/lingxing/targetListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/targetListing/success.json new file mode 100644 index 0000000..876a4f1 --- /dev/null +++ b/lingxing/src/test/resources/fixtures/lingxing/targetListing/success.json @@ -0,0 +1,10 @@ +{"code":0,"message":"success","total":0,"data":{"count":1,"list":[{ + "item_id":"6768632430804","item_url":"","product_unique_id":"9012162617856", + "variant_unique_id":"9019162671616","company_id":"9011","parent_picture_url":"", + "picture_url":"https://img/target.jpg","parent_msku":null,"msku":"TGT-MSKU-1", + "parent_attribute":"Size","attribute":"EU / Blue","title":"Target Item", + "local_sku":"TGT-LOCAL-1","pid":null,"local_name":"本地品名","store_id":"1106", + "store_name":"Target 测试店","price":"27.99","quantity":"17","currency_icon":"$", + "has_variant":false,"listing_start_time":"2021-09-10 15:40:51", + "listing_end_time":"2022-04-12 11:46:56","status":1,"status_name":"active" +}]}} diff --git a/lingxing/src/test/resources/fixtures/lingxing/temuListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/temuListing/success.json new file mode 100644 index 0000000..3673ada --- /dev/null +++ b/lingxing/src/test/resources/fixtures/lingxing/temuListing/success.json @@ -0,0 +1,11 @@ +{"code":0,"message":"success","total":0,"data":{"count":1,"list":[{ + "id":"11","productUniqueId":"901457813888","storeId":"1105","storeName":"TEMU 测试店", + "platformCode":"10024","mskuId":"2712","msku":"TEMU-MSKU-1","pname":"品名","pmsku":"P-1", + "sku":"TEMU-LOCAL-1","pid":"5858","title":"Temu Item","cid":"16","bid":"1", + "status":2,"attribute":"红色","jitMode":2,"catName":"项链","selectStatus":"12", + "virtualQuantity":150,"bname":"品牌","cname":"分类","imgUrl":"https://img/temu.jpg", + "skcId":"2024","skc":"SKC-1","spuId":"2528", + "supplyPriceList":[{"price":77,"currency":"$","beginStr":"2024-08-07","endStr":null}], + "promotionalPriceDataList":[{"activeStatus":"2","activeType":"限时促销","currency":"USD", + "promotionalPrice":"69.00","result":"2","uniqueId":"a-1"}] +}]}} diff --git a/lingxing/src/test/resources/fixtures/lingxing/tiktokListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/tiktokListing/success.json new file mode 100644 index 0000000..2ff347e --- /dev/null +++ b/lingxing/src/test/resources/fixtures/lingxing/tiktokListing/success.json @@ -0,0 +1,7 @@ +{"code":0,"message":"success","total":0,"data":{"count":1,"list":[{ + "id":"6","productUniqueId":"901457808378","storeId":"1104","storeName":"TikTok 测试店", + "platformCode":"10011","mskuId":"10002","msku":"TT-MSKU-1","pname":"品名","sku":"TT-LOCAL-1", + "pid":"5793","title":"TikTok Item","cid":"8","bid":"8","imgUrl":"https://img/tt.jpg", + "spu":"1729","spuId":"1729","platformStatus":"ACTIVATE","categoryName":"分类", + "usableInventory":101,"siteCode":"US","salesPrice":"117.50","currency":"$" +}]}} diff --git a/lingxing/src/test/resources/fixtures/lingxing/walmartListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/walmartListing/success.json new file mode 100644 index 0000000..bc974db --- /dev/null +++ b/lingxing/src/test/resources/fixtures/lingxing/walmartListing/success.json @@ -0,0 +1,10 @@ +{"code":0,"message":"success","total":1,"data":{"list":[{ + "item_id":"wal-1","item_url":"https://www.walmart.com/ip/1","picture_url":"https://img/1.jpg", + "msku":"WM-MSKU-1","title":"Walmart Item","local_name":"本地品名","local_sku":"WM-LOCAL-1", + "status_name":"PUBLISHED","store_id":"1108","store_name":"WMT 测试店", + "currency_icon":"$","price":"139.90","available_quantity":12,"wfs_available_quantity":32, + "gtin":"00723849594300","upc":"723849594300","brand":"FBsport", + "fulfillment_type":2,"fulfillment_type_name":"Seller Fulfilled", + "listing_start_time":"2021-03-25 00:00:00","listing_end_time":"2022-02-23 00:00:00", + "variant_unique_id":"901209431054963712" +}]}} diff --git a/testkit/src/main/java/common/ecommerce/testkit/FakeDirectAdapter.java b/testkit/src/main/java/common/ecommerce/testkit/FakeDirectAdapter.java index 1b618f7..147cc48 100644 --- a/testkit/src/main/java/common/ecommerce/testkit/FakeDirectAdapter.java +++ b/testkit/src/main/java/common/ecommerce/testkit/FakeDirectAdapter.java @@ -1,10 +1,14 @@ package common.ecommerce.testkit; +import common.ecommerce.capability.AfterSaleCapable; import common.ecommerce.capability.ProductCapable; import common.ecommerce.capability.SalesOrderCapable; import common.ecommerce.error.ChannelException; import common.ecommerce.model.account.AccountKey; import common.ecommerce.model.Capability; +import common.ecommerce.model.aftersale.AfterSale; +import common.ecommerce.model.aftersale.AfterSaleQuery; +import common.ecommerce.model.aftersale.AfterSaleType; import common.ecommerce.model.account.ChannelAccount; import common.ecommerce.model.ChannelProvider; import common.ecommerce.model.support.Money; @@ -44,7 +48,7 @@ import java.util.Set; * .build(); * */ -public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapable { +public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapable, AfterSaleCapable { /** 游标格式:{@code item:序号},仅用于测试分页。 */ private static final String CURSOR_PREFIX = "item:"; @@ -54,6 +58,7 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl private final EnumSet capabilities; private final List orders; private final List products; + private final List afterSales; private final int pageSize; private final List orderQueries = new ArrayList(); private final List productQueries = new ArrayList(); @@ -65,6 +70,7 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl this.capabilities = b.capabilities; this.orders = b.orders; this.products = b.products; + this.afterSales = b.afterSales; this.pageSize = b.pageSize; } @@ -150,6 +156,12 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl return null; } + @Override + public Page pull(ChannelContext ctx, AfterSaleQuery query) { + requireCapability(Capability.RETURNS); + return slice(afterSales, query.cursor()); + } + /** 模拟一次写操作,如标发;带 IdempotencyGuard 的测试用它确认平台只被真正调用一次。 */ public String markShipped(String packageId, String trackingNumber) { writeCalls.add(packageId + ':' + trackingNumber); @@ -229,9 +241,11 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl private String adapterId = "fake-direct"; private Platform platform = Platform.WALMART_SC; - private EnumSet capabilities = EnumSet.of(Capability.SALES_ORDER, Capability.PRODUCT); + private EnumSet capabilities = EnumSet.of(Capability.SALES_ORDER, Capability.PRODUCT, + Capability.RETURNS); private List orders = new ArrayList(); private List products = new ArrayList(); + private List afterSales = new ArrayList(); private int pageSize = 100; public Builder adapterId(String adapterId) { @@ -276,6 +290,27 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl return this; } + /** 生成 count 条售后行,类型在退款/退货/换货之间轮转。 */ + public Builder afterSales(int count) { + this.afterSales = new ArrayList(count); + AfterSaleType[] types = AfterSaleType.values(); + for (int i = 1; i <= count; i++) { + AfterSaleType type = types[(i - 1) % 3]; + this.afterSales.add(AfterSale.builder() + .platform(platform) + .omsStoreId("oms-test-001") + .afterSaleId("AS-" + i) + .channelOrderId("FAKE-" + i) + .type(type) + .rawType(type.name()) + .quantity(1) + .platformSku("SKU-" + i) + .sourceProvider(ChannelProvider.DIRECT) + .build()); + } + return this; + } + public Builder pageSize(int pageSize) { if (pageSize <= 0) { throw new IllegalArgumentException("pageSize must be positive"); diff --git a/testkit/src/main/java/common/ecommerce/testkit/JsonFixture.java b/testkit/src/main/java/common/ecommerce/testkit/JsonFixture.java new file mode 100644 index 0000000..6f82274 --- /dev/null +++ b/testkit/src/main/java/common/ecommerce/testkit/JsonFixture.java @@ -0,0 +1,38 @@ +package common.ecommerce.testkit; + +import java.io.ByteArrayOutputStream; +import java.io.InputStream; + +/** + * 夹具加载:从 classpath 读一个 UTF-8 文本文件。 + * + *
+ * String json = JsonFixture.load("fixtures/lingxing/orderList/success.json");
+ * 
+ * + *

路径相对 classpath 根;找不到直接抛异常,不返回空串。

+ */ +public final class JsonFixture { + + private JsonFixture() { + } + + public static String load(String path) { + String normalized = path.startsWith("/") ? path.substring(1) : path; + InputStream in = JsonFixture.class.getClassLoader().getResourceAsStream(normalized); + if (in == null) { + throw new IllegalStateException("fixture not found: " + normalized); + } + try (InputStream stream = in) { + ByteArrayOutputStream out = new ByteArrayOutputStream(); + byte[] buf = new byte[4096]; + int n; + while ((n = stream.read(buf)) >= 0) { + out.write(buf, 0, n); + } + return new String(out.toByteArray(), "UTF-8"); + } catch (Exception e) { + throw new IllegalStateException("read fixture failed: " + normalized, e); + } + } +} diff --git a/testkit/src/main/java/common/ecommerce/testkit/RecordingTransport.java b/testkit/src/main/java/common/ecommerce/testkit/RecordingTransport.java new file mode 100644 index 0000000..02f6ecc --- /dev/null +++ b/testkit/src/main/java/common/ecommerce/testkit/RecordingTransport.java @@ -0,0 +1,108 @@ +package common.ecommerce.testkit; + +import common.ecommerce.http.HttpRequest; +import common.ecommerce.http.HttpResponse; +import common.ecommerce.http.HttpTransport; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.LinkedHashMap; +import java.util.List; +import java.util.Map; +import java.util.function.Function; + +/** + * 录制型传输层:记录每一次请求,按 URL 子串返回编排好的响应。 + * + *

与真实的令牌流程配合:{@code /oauth/access-token} 默认返回一个最小成功响应, + * 其它请求走 {@link #route(String, String, Function)} 注册的响应。 + * 这样一次调用链里的「先换 token、再拉数据」两次请求都能断言到。

+ * + *

没有匹配路由时抛 {@link IllegalStateException},不静默返回空响应—— + * 免得测试断言了一个根本不存在的请求。

+ */ +public final class RecordingTransport implements HttpTransport { + + private static final String TOKEN_PATH = "/oauth/access-token"; + + private static final String DEFAULT_TOKEN_BODY = + "{\"code\":\"200\",\"msg\":\"OK\",\"data\":{\"access_token\":\"test-token\"," + + "\"refresh_token\":\"test-refresh\",\"expires_in\":7199}}"; + + private final List recorded = new ArrayList(); + private final List routes = new ArrayList(); + private String tokenBody = DEFAULT_TOKEN_BODY; + + public static RecordingTransport create() { + return new RecordingTransport(); + } + + /** 覆盖令牌接口的响应体(默认是一个最小成功响应)。 */ + public RecordingTransport tokenResponse(String body) { + this.tokenBody = body; + return this; + } + + /** 按 URL 子串 + 方法匹配;方法传 null 表示不限制。 */ + public RecordingTransport route(String urlContains, String method, Function responder) { + routes.add(new Route(urlContains, method, responder)); + return this; + } + + public RecordingTransport route(String urlContains, Function responder) { + return route(urlContains, null, responder); + } + + @Override + public HttpResponse execute(HttpRequest request) { + recorded.add(request); + if (request.url().contains(TOKEN_PATH)) { + return HttpResponse.of(200, Collections.emptyMap(), tokenBody, 1); + } + for (Route r : routes) { + if (request.url().contains(r.urlContains) + && (r.method == null || r.method.equalsIgnoreCase(request.method()))) { + return r.responder.apply(request); + } + } + throw new IllegalStateException("no route for " + request.method() + " " + request.url()); + } + + public List recorded() { + return Collections.unmodifiableList(recorded); + } + + /** 除令牌请求外的业务请求,按发生顺序。 */ + public List dataRequests() { + List out = new ArrayList(); + for (HttpRequest r : recorded) { + if (!r.url().contains(TOKEN_PATH)) { + out.add(r); + } + } + return out; + } + + /** 最后一次业务请求;没有时返回 null。 */ + public HttpRequest lastDataRequest() { + List data = dataRequests(); + return data.isEmpty() ? null : data.get(data.size() - 1); + } + + public void clear() { + recorded.clear(); + } + + private static final class Route { + + private final String urlContains; + private final String method; + private final Function responder; + + private Route(String urlContains, String method, Function responder) { + this.urlContains = urlContains; + this.method = method; + this.responder = responder; + } + } +} diff --git a/testkit/src/main/java/common/ecommerce/testkit/Responses.java b/testkit/src/main/java/common/ecommerce/testkit/Responses.java new file mode 100644 index 0000000..db5d5b8 --- /dev/null +++ b/testkit/src/main/java/common/ecommerce/testkit/Responses.java @@ -0,0 +1,34 @@ +package common.ecommerce.testkit; + +import common.ecommerce.http.HttpResponse; + +import java.util.Collections; + +/** + * 测试用的快捷响应构造。 + * + *

注意与 {@code common.ecommerce.http.Responses} 区分:那个是「状态码 → 异常」的映射, + * 这个是「直接造一个响应对象」。

+ */ +public final class Responses { + + private Responses() { + } + + public static HttpResponse ok(String body) { + return HttpResponse.of(200, Collections.emptyMap(), body, 1); + } + + public static HttpResponse status(int code, String body) { + return HttpResponse.of(code, Collections.emptyMap(), body, 1); + } + + public static HttpResponse withHeaders(int code, java.util.Map headers, String body) { + return HttpResponse.of(code, headers, body, 1); + } + + public static HttpResponse rateLimited(String retryAfterSeconds) { + return HttpResponse.of(429, + Collections.singletonMap("Retry-After", retryAfterSeconds), "", 1); + } +} diff --git a/testkit/src/test/java/common/ecommerce/testkit/SdkFacadeCallTest.java b/testkit/src/test/java/common/ecommerce/testkit/SdkFacadeCallTest.java new file mode 100644 index 0000000..ffdbcc8 --- /dev/null +++ b/testkit/src/test/java/common/ecommerce/testkit/SdkFacadeCallTest.java @@ -0,0 +1,181 @@ +package common.ecommerce.testkit; + +import common.ecommerce.capability.CapabilityReport; +import common.ecommerce.error.ChannelException; +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.aftersale.AfterSale; +import common.ecommerce.model.aftersale.AfterSaleQuery; +import common.ecommerce.model.aftersale.AfterSaleType; +import common.ecommerce.model.order.SalesOrder; +import common.ecommerce.model.order.SalesOrderQuery; +import common.ecommerce.model.product.ProductListing; +import common.ecommerce.model.product.ProductQuery; +import common.ecommerce.model.product.ProductStatus; +import common.ecommerce.model.support.Page; +import common.ecommerce.sdk.ChannelConnection; +import common.ecommerce.sdk.ChannelSdk; +import common.ecommerce.spi.ChannelSecret; +import org.junit.jupiter.api.BeforeEach; +import org.junit.jupiter.api.Test; + +import java.time.LocalDate; +import java.time.ZoneOffset; +import java.time.Instant; +import java.time.Clock; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * 从 ChannelSdk 门面调用的完整示例,覆盖商品与售后两条主链路。 + * + *

用 {@link FakeDirectAdapter} 代替真实平台:它实现了同样的能力接口, + * 因此这里验证的是门面契约——参数怎么传、能检查什么、失败时抛什么。

+ */ +class SdkFacadeCallTest { + + private static final AccountKey KEY = + AccountKey.of(ChannelProvider.DIRECT, Platform.WALMART_SC, "oms-test-001"); + + private static final ChannelConnection CONNECTION = ChannelConnection.of( + "https://api.example.com", + ChannelSecret.builder().appKey("test-app-id-1234").appSecret("test-secret").build()); + + private ChannelSdk sdk; + + @BeforeEach + void setUp() { + ChannelAccount account = FakeDirectAdapter.account(Platform.WALMART_SC, "oms-test-001"); + sdk = ChannelSdk.builder() + .accountRepository(new InMemoryAccounts().put(account)) + .clock(Clock.fixed(Instant.parse("2026-11-04T00:00:00Z"), ZoneOffset.UTC)) + .register(FakeDirectAdapter.builder() + .orders(3) + .products(3) + .afterSales(3) + .pageSize(2) + .build()) + .build(); + } + + // ---------------------------------------------------------------- 商品 + + @Test + void pullProductsThroughFacade() { + Page page = sdk.products(KEY, CONNECTION).pull( + ProductQuery.builder().pageSize(2).build()); + + assertEquals(2, page.size()); + ProductListing p = page.items().get(0); + assertEquals(Platform.WALMART_SC, p.platform()); + assertEquals("SKU-1", p.platformSku()); + assertEquals(ProductStatus.ACTIVE, p.status()); + assertEquals("oms-test-001", p.omsStoreId()); + assertEquals(ChannelProvider.DIRECT, p.sourceProvider()); + assertTrue(page.nextCursor() != null, "3 条数据 pageSize=2,应有下一页"); + } + + @Test + void productPagingByCursor() { + ProductQuery query = ProductQuery.builder().pageSize(2).build(); + Page first = sdk.products(KEY, CONNECTION).pull(query); + Page second = sdk.products(KEY, CONNECTION).pull( + query.toBuilder().cursor(first.nextCursor()).build()); + + assertEquals(1, second.size()); + assertEquals("SKU-3", second.items().get(0).platformSku()); + assertNull(second.nextCursor()); + } + + @Test + void productQueryRejectsSearchWithoutField() { + assertThrows(IllegalArgumentException.class, + () -> ProductQuery.builder().searchValue("SKU-1").build()); + } + + @Test + void productQueryRejectsFuzzyAndExactTogether() { + assertThrows(IllegalArgumentException.class, + () -> ProductQuery.builder() + .searchField(common.ecommerce.model.product.ProductSearchField.PLATFORM_SKU) + .searchValue("A") + .searchValues(java.util.Arrays.asList("B")) + .build()); + } + + // ---------------------------------------------------------------- 售后 + + @Test + void pullAfterSalesThroughFacade() { + Page page = sdk.afterSales(KEY, CONNECTION).pull( + AfterSaleQuery.builder() + .startDate(LocalDate.parse("2026-10-01")) + .endDate(LocalDate.parse("2026-11-01")) + .pageSize(2) + .build()); + + assertEquals(2, page.size()); + AfterSale first = page.items().get(0); + assertEquals(Platform.WALMART_SC, first.platform()); + assertEquals("AS-1", first.afterSaleId()); + assertEquals("FAKE-1", first.channelOrderId()); + assertEquals(AfterSaleType.REFUND, first.type()); + assertTrue(page.nextCursor() != null); + } + + @Test + void afterSaleQueryRequiresTimeWindow() { + assertThrows(NullPointerException.class, + () -> AfterSaleQuery.builder().endDate(LocalDate.parse("2026-11-01")).build()); + } + + @Test + void afterSaleQueryRejectsInvertedWindow() { + assertThrows(IllegalArgumentException.class, + () -> AfterSaleQuery.builder() + .startDate(LocalDate.parse("2026-11-01")) + .endDate(LocalDate.parse("2026-10-01")) + .build()); + } + + @Test + void capabilityReportReflectsAdapter() { + CapabilityReport caps = sdk.capabilities(KEY); + assertTrue(caps.supports(Capability.SALES_ORDER)); + assertTrue(caps.supports(Capability.PRODUCT)); + assertTrue(caps.supports(Capability.RETURNS)); + assertEquals(false, caps.supports(Capability.BILLING)); + } + + // ---------------------------------------------------------------- 错误路径 + + @Test + void unsupportedCapabilityThrowsOnCall() { + // FakeDirectAdapter 没有实现结算能力:取视图不报错,调用时报错 + assertThrows(ChannelException.UnsupportedCapabilityException.class, + () -> sdk.settlements(KEY, CONNECTION).pull( + common.ecommerce.model.settlement.SettlementQuery.builder().build())); + } + + @Test + void unknownAccountFailsBeforeAnyNetworkCall() { + AccountKey other = AccountKey.of(ChannelProvider.DIRECT, Platform.WALMART_SC, "oms-unknown"); + IllegalStateException ex = assertThrows(IllegalStateException.class, + () -> sdk.products(other, CONNECTION)); + assertTrue(ex.getMessage().contains("channel account not configured"), ex.getMessage()); + } + + @Test + void ordersStillWorkAlongsideNewCapabilities() { + Page page = sdk.salesOrders(KEY, CONNECTION).pull( + SalesOrderQuery.builder().updatedAfter(Instant.EPOCH).pageSize(2).build()); + assertEquals(2, page.size()); + assertEquals("FAKE-1", page.items().get(0).channelOrderId()); + } +}