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这不是契约测试,而是用法说明:每一段代码对应操作手册里的一节。 - * 网络层用 {@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传输层返回录制报文后直接断言请求体,不联网。
- */ +/** 领星售后订单列表:请求构造 + 响应映射 + 边界校验。 */ 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覆盖两处踩过的坑:接口不接受 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跑之前填 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搜索字段是字符串(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默认跳过;用 {@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
+ * 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注意与 {@code common.ecommerce.http.Responses} 区分:那个是「状态码 → 异常」的映射, + * 这个是「直接造一个响应对象」。
+ */ +public final class Responses { + + private Responses() { + } + + public static HttpResponse ok(String body) { + return HttpResponse.of(200, Collections.用 {@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