Browse Source

test: 每个平台补 listing / 售后契约测试,新增 SDK 门面调用测试

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 <noreply@anthropic.com>
feature/supplier-lingxing
chenchuchuan 2 weeks ago
parent
commit
c9d60153c7
  1. 6
      lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java
  2. 8
      lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java
  3. 182
      lingxing/src/test/java/common/ecommerce/lingxing/ProductCallExampleTest.java
  4. 212
      lingxing/src/test/java/common/ecommerce/lingxing/SdkCallGuideTest.java
  5. 204
      lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java
  6. 76
      lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java
  7. 229
      lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/AmazonScProductLiveTest.java
  8. 229
      lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/AmazonScProductLiveTest.java
  9. 75
      lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java
  10. 60
      lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java
  11. 62
      lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java
  12. 56
      lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java
  13. 67
      lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java
  14. 49
      lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java
  15. 85
      lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java
  16. 4
      lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java
  17. 4
      lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java
  18. 122
      lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java
  19. 8
      lingxing/src/test/resources/fixtures/lingxing/aliexpressListing/success.json
  20. 7
      lingxing/src/test/resources/fixtures/lingxing/amazonScListing/success.json
  21. 6
      lingxing/src/test/resources/fixtures/lingxing/amazonVcListing/success.json
  22. 10
      lingxing/src/test/resources/fixtures/lingxing/ebayListing/success.json
  23. 7
      lingxing/src/test/resources/fixtures/lingxing/sheinListing/success.json
  24. 10
      lingxing/src/test/resources/fixtures/lingxing/targetListing/success.json
  25. 11
      lingxing/src/test/resources/fixtures/lingxing/temuListing/success.json
  26. 7
      lingxing/src/test/resources/fixtures/lingxing/tiktokListing/success.json
  27. 10
      lingxing/src/test/resources/fixtures/lingxing/walmartListing/success.json
  28. 39
      testkit/src/main/java/common/ecommerce/testkit/FakeDirectAdapter.java
  29. 38
      testkit/src/main/java/common/ecommerce/testkit/JsonFixture.java
  30. 108
      testkit/src/main/java/common/ecommerce/testkit/RecordingTransport.java
  31. 34
      testkit/src/main/java/common/ecommerce/testkit/Responses.java
  32. 181
      testkit/src/test/java/common/ecommerce/testkit/SdkFacadeCallTest.java

6
lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java

@ -54,6 +54,12 @@ public final class AmazonVcProductSource implements LingxingProductSource { @@ -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");

8
lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java

@ -55,10 +55,10 @@ public final class TargetProductSource implements LingxingProductSource { @@ -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 搜索:平台不支持的维度直接报错,不静默忽略

182
lingxing/src/test/java/common/ecommerce/lingxing/ProductCallExampleTest.java

@ -1,182 +0,0 @@ @@ -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 拉商品的完整示例。
*
* <p>这是<b>用法文档</b>,不是契约测试。传输层返回一页固定的领星 Listing 响应,
* 目的是让你看清:三段配置分别是什么、拼出来的请求长什么样、结果如何映射成统一模型。</p>
*/
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<ProductListing> 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<common.ecommerce.http.HttpRequest> requests =
new java.util.ArrayList<common.ecommerce.http.HttpRequest>();
@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.<String, String>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.<String, String>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);
}
}
}

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

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

204
lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java

@ -1,134 +1,134 @@ @@ -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;
/**
* 领星售后列表接口的请求构造测试。
*
* <p>传输层返回录制报文后直接断言请求体,不联网。</p>
*/
/** 领星售后订单列表:请求构造 + 响应映射 + 边界校验。 */
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<AfterSale> 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<AfterSale> 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<HttpRequest> requests = new ArrayList<HttpRequest>();
@Test
void mapsRowsIntoUnifiedModel() {
Page<AfterSale> 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.<String, String>emptyMap(),
"{\"code\":\"200\",\"msg\":\"OK\",\"data\":{\"access_token\":\"tok\","
+ "\"refresh_token\":\"ref\",\"expires_in\":7199}}", 1);
}
try {
return HttpResponse.of(200, Collections.<String, String>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());
}
}

76
lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java

@ -0,0 +1,76 @@ @@ -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 在线商品。
*
* <p>覆盖两处踩过的坑:接口不接受 storeIds;本地 SKU 的搜索编码是 5 而不是文档写的 3。</p>
*/
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());
}
}

229
lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/AmazonScProductLiveTest.java

@ -1,229 +0,0 @@ @@ -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。
*
* <p><b>跑之前填 APP_KEY / APP_SECRET 即可</b>;SID 留空时会自动从店铺列表取第一个。</p>
* <pre>
* mvn -pl lingxing -am test -Dtest=AmazonScProductLiveTest
* </pre>
*
* <p>调用前确认出口 IP 已加入领星白名单。本类只用于联调,不要把真实凭证提交到仓库。</p>
*
* <p>两个接口的令牌桶容量都是 1,且按「账户 + path」共享,必须串行调用。</p>
*/
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 店铺。
*
* <p>接口 {@code GET /erp/sc/data/seller/lists},非分页。打印每个店铺的 sid 与名称,
* 同时打印请求与响应原始报文(见 LoggingTransport),便于核对字段名。</p>
*/
@Test
void listsAmazonShops() {
requireConfigured();
List<SubChannel> 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<ProductListing> 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<ProductListing> 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<SubChannel> 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)";
}
}
}

229
lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/AmazonScProductLiveTest.java

@ -1,229 +0,0 @@ @@ -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。
*
* <p><b>跑之前填 APP_KEY / APP_SECRET 即可</b>;SID 留空时会自动从店铺列表取第一个。</p>
* <pre>
* mvn -pl lingxing -am test -Dtest=AmazonScProductLiveTest
* </pre>
*
* <p>调用前确认出口 IP 已加入领星白名单。本类只用于联调,不要把真实凭证提交到仓库。</p>
*
* <p>两个接口的令牌桶容量都是 1,且按「账户 + path」共享,必须串行调用。</p>
*/
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 店铺。
*
* <p>接口 {@code GET /erp/sc/data/seller/lists},非分页。打印每个店铺的 sid 与名称,
* 同时打印请求与响应原始报文(见 LoggingTransport),便于核对字段名。</p>
*/
@Test
void listsAmazonShops() {
requireConfigured();
List<SubChannel> 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<ProductListing> 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<ProductListing> 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<SubChannel> 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)";
}
}
}

75
lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java

@ -0,0 +1,75 @@ @@ -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 在线商品。
*
* <p>搜索字段是<b>字符串</b>(seller_sku / sku),搜索值是数组 + exact_search 开关,
* 与其它平台的数字枚举不同。</p>
*/
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());
}
}

60
lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java

@ -0,0 +1,60 @@ @@ -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());
}
}

62
lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java

@ -0,0 +1,62 @@ @@ -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());
}
}

56
lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java

@ -0,0 +1,56 @@ @@ -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());
}
}

67
lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java

@ -0,0 +1,67 @@ @@ -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());
}
}

49
lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java

@ -0,0 +1,49 @@ @@ -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());
}
}

85
lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java

@ -0,0 +1,85 @@ @@ -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<ProductListing> 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());
}
}

4
lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java

@ -19,6 +19,7 @@ import common.ecommerce.spi.AccessToken; @@ -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; @@ -30,6 +31,8 @@ import java.util.Map;
/**
* 只读探针:实测各平台商品列表接口的 {@code searchField} 枚举值含义。
*
* <p>默认跳过;用 {@code -Dlingxing.probe=true} 显式开启。</p>
*
* <p><b>只做查询</b>,不创建、不修改任何数据。</p>
*
* <p>用法:填好下面四个常量后运行</p>
@ -41,6 +44,7 @@ import java.util.Map; @@ -41,6 +44,7 @@ import java.util.Map;
* 命中时返回的是 {@code msku} 还是 {@code sku}。
* 拿到结果后再去写正式的平台映射表。</p>
*/
@EnabledIfSystemProperty(named = "lingxing.probe", matches = "true")
class SearchFieldProbeTest {
// ==================== 填写这里 ====================

4
lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java

@ -21,6 +21,7 @@ import common.ecommerce.spi.AccessToken; @@ -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; @@ -36,6 +37,8 @@ import java.util.TreeMap;
* <p><b>用途</b>:文档里没有 AliExpress 的 platform_code,
* 这个测试直接从店铺列表接口读出来。</p>
*
* <p>默认跳过;用 {@code -Dlingxing.probe=true} 显式开启。</p>
*
* <p><b>只做查询</b>,不创建、不修改数据。</p>
*
* <p>用法:填好 APP_KEY / APP_SECRET,然后</p>
@ -53,6 +56,7 @@ import java.util.TreeMap; @@ -53,6 +56,7 @@ import java.util.TreeMap;
* ...
* </pre>
*/
@EnabledIfSystemProperty(named = "lingxing.probe", matches = "true")
class ShopListProbeTest {
// ==================== 填写这里 ====================

122
lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java

@ -0,0 +1,122 @@ @@ -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}。
*
* <p>各平台的契约测试只需要关心「请求怎么拼」和「响应怎么映射」,
* 不用重复写 token、签名、限流的装配。</p>
*/
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。
*
* <p>token 请求走 {@link RecordingTransport} 的默认响应,不占业务路由。</p>
*/
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);
}
}
}

8
lingxing/src/test/resources/fixtures/lingxing/aliexpressListing/success.json

@ -0,0 +1,8 @@ @@ -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}]
}]}}

7
lingxing/src/test/resources/fixtures/lingxing/amazonScListing/success.json

@ -0,0 +1,7 @@ @@ -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":"美国"
}]}

6
lingxing/src/test/resources/fixtures/lingxing/amazonVcListing/success.json

@ -0,0 +1,6 @@ @@ -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"
}]}

10
lingxing/src/test/resources/fixtures/lingxing/ebayListing/success.json

@ -0,0 +1,10 @@ @@ -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"
}]}

7
lingxing/src/test/resources/fixtures/lingxing/sheinListing/success.json

@ -0,0 +1,7 @@ @@ -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
}]}}

10
lingxing/src/test/resources/fixtures/lingxing/targetListing/success.json

@ -0,0 +1,10 @@ @@ -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"
}]}}

11
lingxing/src/test/resources/fixtures/lingxing/temuListing/success.json

@ -0,0 +1,11 @@ @@ -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"}]
}]}}

7
lingxing/src/test/resources/fixtures/lingxing/tiktokListing/success.json

@ -0,0 +1,7 @@ @@ -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":"$"
}]}}

10
lingxing/src/test/resources/fixtures/lingxing/walmartListing/success.json

@ -0,0 +1,10 @@ @@ -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"
}]}}

39
testkit/src/main/java/common/ecommerce/testkit/FakeDirectAdapter.java

@ -1,10 +1,14 @@ @@ -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; @@ -44,7 +48,7 @@ import java.util.Set;
* .build();
* </pre>
*/
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 @@ -54,6 +58,7 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl
private final EnumSet<Capability> capabilities;
private final List<SalesOrder> orders;
private final List<ProductListing> products;
private final List<AfterSale> afterSales;
private final int pageSize;
private final List<SalesOrderQuery> orderQueries = new ArrayList<SalesOrderQuery>();
private final List<ProductQuery> productQueries = new ArrayList<ProductQuery>();
@ -65,6 +70,7 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl @@ -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 @@ -150,6 +156,12 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl
return null;
}
@Override
public Page<AfterSale> 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 @@ -229,9 +241,11 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl
private String adapterId = "fake-direct";
private Platform platform = Platform.WALMART_SC;
private EnumSet<Capability> capabilities = EnumSet.of(Capability.SALES_ORDER, Capability.PRODUCT);
private EnumSet<Capability> capabilities = EnumSet.of(Capability.SALES_ORDER, Capability.PRODUCT,
Capability.RETURNS);
private List<SalesOrder> orders = new ArrayList<SalesOrder>();
private List<ProductListing> products = new ArrayList<ProductListing>();
private List<AfterSale> afterSales = new ArrayList<AfterSale>();
private int pageSize = 100;
public Builder adapterId(String adapterId) {
@ -276,6 +290,27 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl @@ -276,6 +290,27 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl
return this;
}
/** 生成 count 条售后行,类型在退款/退货/换货之间轮转。 */
public Builder afterSales(int count) {
this.afterSales = new ArrayList<AfterSale>(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");

38
testkit/src/main/java/common/ecommerce/testkit/JsonFixture.java

@ -0,0 +1,38 @@ @@ -0,0 +1,38 @@
package common.ecommerce.testkit;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
/**
* 夹具加载:从 classpath 读一个 UTF-8 文本文件。
*
* <pre>
* String json = JsonFixture.load("fixtures/lingxing/orderList/success.json");
* </pre>
*
* <p>路径相对 classpath 根;找不到直接抛异常,不返回空串。</p>
*/
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);
}
}
}

108
testkit/src/main/java/common/ecommerce/testkit/RecordingTransport.java

@ -0,0 +1,108 @@ @@ -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 子串返回编排好的响应。
*
* <p>与真实的令牌流程配合:{@code /oauth/access-token} 默认返回一个最小成功响应,
* 其它请求走 {@link #route(String, String, Function)} 注册的响应。
* 这样一次调用链里的「先换 token、再拉数据」两次请求都能断言到。</p>
*
* <p>没有匹配路由时抛 {@link IllegalStateException},不静默返回空响应——
* 免得测试断言了一个根本不存在的请求。</p>
*/
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<HttpRequest> recorded = new ArrayList<HttpRequest>();
private final List<Route> routes = new ArrayList<Route>();
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<HttpRequest, HttpResponse> responder) {
routes.add(new Route(urlContains, method, responder));
return this;
}
public RecordingTransport route(String urlContains, Function<HttpRequest, HttpResponse> 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.<String, String>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<HttpRequest> recorded() {
return Collections.unmodifiableList(recorded);
}
/** 除令牌请求外的业务请求,按发生顺序。 */
public List<HttpRequest> dataRequests() {
List<HttpRequest> out = new ArrayList<HttpRequest>();
for (HttpRequest r : recorded) {
if (!r.url().contains(TOKEN_PATH)) {
out.add(r);
}
}
return out;
}
/** 最后一次业务请求;没有时返回 null。 */
public HttpRequest lastDataRequest() {
List<HttpRequest> 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<HttpRequest, HttpResponse> responder;
private Route(String urlContains, String method, Function<HttpRequest, HttpResponse> responder) {
this.urlContains = urlContains;
this.method = method;
this.responder = responder;
}
}
}

34
testkit/src/main/java/common/ecommerce/testkit/Responses.java

@ -0,0 +1,34 @@ @@ -0,0 +1,34 @@
package common.ecommerce.testkit;
import common.ecommerce.http.HttpResponse;
import java.util.Collections;
/**
* 测试用的快捷响应构造。
*
* <p>注意与 {@code common.ecommerce.http.Responses} 区分:那个是「状态码 → 异常」的映射,
* 这个是「直接造一个响应对象」。</p>
*/
public final class Responses {
private Responses() {
}
public static HttpResponse ok(String body) {
return HttpResponse.of(200, Collections.<String, String>emptyMap(), body, 1);
}
public static HttpResponse status(int code, String body) {
return HttpResponse.of(code, Collections.<String, String>emptyMap(), body, 1);
}
public static HttpResponse withHeaders(int code, java.util.Map<String, String> 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);
}
}

181
testkit/src/test/java/common/ecommerce/testkit/SdkFacadeCallTest.java

@ -0,0 +1,181 @@ @@ -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 门面调用的完整示例,覆盖商品与售后两条主链路。
*
* <p>用 {@link FakeDirectAdapter} 代替真实平台:它实现了同样的能力接口,
* 因此这里验证的是<b>门面契约</b>——参数怎么传、能检查什么、失败时抛什么。</p>
*/
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<ProductListing> 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<ProductListing> first = sdk.products(KEY, CONNECTION).pull(query);
Page<ProductListing> 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<AfterSale> 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<SalesOrder> 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());
}
}
Loading…
Cancel
Save