Browse Source
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
32 changed files with 1246 additions and 960 deletions
@ -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); |
||||
} |
||||
} |
||||
} |
||||
@ -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; |
||||
} |
||||
} |
||||
} |
||||
@ -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()); |
||||
} |
||||
} |
||||
@ -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)"; |
||||
} |
||||
} |
||||
} |
||||
@ -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)"; |
||||
} |
||||
} |
||||
} |
||||
@ -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()); |
||||
} |
||||
} |
||||
@ -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()); |
||||
} |
||||
} |
||||
@ -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()); |
||||
} |
||||
} |
||||
@ -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()); |
||||
} |
||||
} |
||||
@ -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()); |
||||
} |
||||
} |
||||
@ -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()); |
||||
} |
||||
} |
||||
@ -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()); |
||||
} |
||||
} |
||||
@ -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); |
||||
} |
||||
} |
||||
} |
||||
@ -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}] |
||||
}]}} |
||||
@ -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":"美国" |
||||
}]} |
||||
@ -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" |
||||
}]} |
||||
@ -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" |
||||
}]} |
||||
@ -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 |
||||
}]}} |
||||
@ -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" |
||||
}]}} |
||||
@ -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"}] |
||||
}]}} |
||||
@ -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":"$" |
||||
}]}} |
||||
@ -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" |
||||
}]}} |
||||
@ -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); |
||||
} |
||||
} |
||||
} |
||||
@ -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; |
||||
} |
||||
} |
||||
} |
||||
@ -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); |
||||
} |
||||
} |
||||
@ -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…
Reference in new issue