Browse Source

test(observability): 覆盖门面日志与领星调用链路

- 新增 CallObserverTest:成功/失败记录、观察者异常隔离、默认 NOOP、UTC 与本地时间转换
- 新增 LingxingCallObserverTest:用 RecordingTransport 走真实 LingxingAdapter,
  覆盖成功、限流失败、无平台码三种场景
feature/supplier-lingxing
lml 2 weeks ago
parent
commit
98330ca87c
  1. 157
      core/src/test/java/common/ecommerce/sdk/CallObserverTest.java
  2. 183
      lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingCallObserverTest.java

157
core/src/test/java/common/ecommerce/sdk/CallObserverTest.java

@ -0,0 +1,157 @@
package common.ecommerce.sdk;
import common.ecommerce.audit.CallObserver;
import common.ecommerce.audit.CallOutcome;
import common.ecommerce.audit.CallRecord;
import common.ecommerce.error.ChannelException;
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.SalesOrder;
import common.ecommerce.model.order.SalesOrderQuery;
import common.ecommerce.model.product.ProductQuery;
import common.ecommerce.model.support.Page;
import common.ecommerce.spi.ChannelSecret;
import org.junit.jupiter.api.Test;
import java.time.Instant;
import java.time.ZoneOffset;
import java.util.ArrayList;
import java.util.List;
import static java.time.Clock.fixed;
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;
/**
* 门面调用日志({@link CallObserver})的契约测试。
*
* <p>不碰网络:用 {@link ChannelSdkTest.FakeDirectAdapter} 与内存账户仓库,
* 验证「一次调用产生一条记录」「失败也记录」「观察者报错不影响业务」。</p>
*/
class CallObserverTest {
/** 账户的 provider 必须与注册的适配器一致,否则解析不到适配器。 */
private static final AccountKey KEY =
AccountKey.of(ChannelProvider.DIRECT, Platform.WALMART_SC, "oms-wm-001");
private static final ChannelConnection CONNECTION = ChannelConnection.of(
"https://api.example.com",
ChannelSecret.builder().appKey("ak").appSecret("sk").build());
/** 把回调记录收集到内存里,便于断言。 */
private static final class CollectingObserver implements CallObserver {
private final List<CallRecord> records = new ArrayList<>();
@Override
public void onCall(CallRecord record) {
records.add(record);
}
}
private static ChannelAccount account() {
return ChannelAccount.builder()
.key(KEY)
.externalStoreId("wm-seller-01")
.credentialRef("kms://test/wm")
.marketplaceZone("America/Chicago")
.currency("USD")
.build();
}
private static ChannelSdk sdk(CallObserver observer) {
return ChannelSdk.builder()
.accountRepository(new ChannelSdkTest.FixedAccounts(account()))
.clock(fixed(Instant.parse("2026-11-05T00:00:00Z"), ZoneOffset.UTC))
.register(new ChannelSdkTest.FakeDirectAdapter())
.callObserver(observer)
.build();
}
@Test
void recordsSuccessfulCall() {
CollectingObserver observer = new CollectingObserver();
ChannelSdk sdk = sdk(observer);
Page<SalesOrder> page = sdk.salesOrders(KEY, CONNECTION).pull(
SalesOrderQuery.builder()
.updatedAfter(Instant.parse("2026-10-01T00:00:00Z"))
.pageSize(20)
.build());
assertNotNull(page);
assertEquals(1, observer.records.size(), "一次调用只产生一条记录");
CallRecord record = observer.records.get(0);
assertEquals("salesOrders.pull", record.operation());
assertEquals(CallOutcome.SUCCESS, record.outcome());
assertEquals(ChannelProvider.DIRECT, record.provider());
assertEquals(Platform.WALMART_SC, record.platform());
assertEquals("oms-wm-001", record.omsStoreId());
assertEquals("wm-seller-01", record.externalStoreId());
assertEquals(0, record.resultCount(), "FakeDirectAdapter 返回空页");
assertNotNull(record.requestId(), "requestId 用于串起 HTTP 日志");
assertEquals(20, record.params().get("pageSize"));
assertFalse(record.failed());
assertEquals(0L, record.durationMillis(), "固定时钟下耗时为 0");
// Instant 本身永远是 UTC(toString 带 Z);本地时间要用带 ZoneId 的重载
assertEquals("2026-11-05T00:00:00Z", record.occurredAt().toString());
assertEquals("2026-11-05T08:00+08:00",
record.occurredAt(java.time.ZoneId.of("Asia/Shanghai"))
.toOffsetDateTime().toString());
}
@Test
void recordsFailedCallAndRethrows() {
CollectingObserver observer = new CollectingObserver();
ChannelSdk sdk = sdk(observer);
// FakeDirectAdapter 没有商品能力:能力检查在门面里失败
assertThrows(ChannelException.UnsupportedCapabilityException.class,
() -> sdk.products(KEY, CONNECTION).pull(ProductQuery.builder().build()));
assertEquals(1, observer.records.size());
CallRecord record = observer.records.get(0);
assertEquals("products.pull", record.operation());
assertEquals(CallOutcome.FAILURE, record.outcome());
assertTrue(record.failed());
assertTrue(record.errorType().contains("UnsupportedCapabilityException"),
record.errorType());
assertNotNull(record.errorMessage());
}
@Test
void observerFailureDoesNotBreakBusinessCall() {
CallObserver broken = new CallObserver() {
@Override
public void onCall(CallRecord record) {
throw new IllegalStateException("observer down");
}
};
ChannelSdk sdk = sdk(broken);
// 观察者抛异常被吞掉,业务结果照常返回
Page<SalesOrder> page = sdk.salesOrders(KEY, CONNECTION).pull(
SalesOrderQuery.builder().updatedAfter(Instant.EPOCH).build());
assertNotNull(page);
}
@Test
void defaultObserverIsNoop() {
// 不注入 callObserver 时不应该有任何副作用,也不应该 NPE
ChannelSdk sdk = ChannelSdk.builder()
.accountRepository(new ChannelSdkTest.FixedAccounts(account()))
.register(new ChannelSdkTest.FakeDirectAdapter())
.build();
Page<SalesOrder> page = sdk.salesOrders(KEY, CONNECTION).pull(
SalesOrderQuery.builder().updatedAfter(Instant.EPOCH).build());
assertEquals(0, page.size());
}
}

183
lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingCallObserverTest.java

@ -0,0 +1,183 @@
package common.ecommerce.lingxing.adapter;
import common.ecommerce.audit.CallObserver;
import common.ecommerce.audit.CallOutcome;
import common.ecommerce.audit.CallRecord;
import common.ecommerce.error.ChannelException;
import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.lingxing.support.LingxingTestSupport;
import common.ecommerce.model.ChannelProvider;
import common.ecommerce.model.Platform;
import common.ecommerce.model.account.ChannelAccount;
import common.ecommerce.model.order.SalesOrder;
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.InMemoryLockProvider;
import common.ecommerce.testkit.InMemoryTokenStore;
import common.ecommerce.testkit.RecordingTransport;
import common.ecommerce.testkit.Responses;
import org.junit.jupiter.api.Test;
import java.time.Instant;
import java.util.ArrayList;
import java.util.List;
import java.util.Objects;
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>用 {@link RecordingTransport} 替掉网络,走真实的 {@link LingxingAdapter},
* 验证操作日志记录的是领星账户的真实链路:provider=LINGXING、platform=领取子平台、
* store_id=领星 store_id。</p>
*/
class LingxingCallObserverTest {
private static final String ORDER_JSON =
"{"
+ "\"code\":0,\"message\":\"操作成功\","
+ "\"data\":{\"total\":1,\"list\":[{"
+ "\"global_order_no\":\"GO-1\","
+ "\"store_id\":\"store-1\","
+ "\"amount_currency\":\"USD\","
+ "\"status\":6,"
+ "\"global_purchase_time\":1759363200,"
+ "\"item_info\":[{"
+ "\"global_item_no\":\"GI-1\",\"msku\":\"SKU-1\",\"quantity\":2,"
+ "\"unit_price_amount\":\"9.99\",\"tax_amount\":\"0.00\","
+ "\"discount_amount\":\"0.00\"}],"
+ "\"platform_info\":[{"
+ "\"platform_code\":\"10008\",\"platform_order_no\":\"PO-1\","
+ "\"platform_order_name\":\"PO-1\","
+ "\"store_Country_code\":\"US\",\"purchase_time\":1759363200}],"
+ "\"transaction_info\":[{\"order_total_amount\":\"19.98\"}]"
+ "}]}"
+ "}";
private static final String RATE_LIMITED_JSON =
"{\"code\":3001008,\"message\":\"请求过于频繁\"}";
/** 收集回调记录,避免依赖 SLF4J 绑定。 */
private static final class CollectingObserver implements CallObserver {
private final List<CallRecord> records = new ArrayList<CallRecord>();
@Override
public void onCall(CallRecord record) {
records.add(record);
}
}
private static ChannelConnection connection() {
return ChannelConnection.of(
LingxingTestSupport.ENDPOINT,
ChannelSecret.builder()
.appKey(LingxingTestSupport.APP_KEY)
.appSecret(LingxingTestSupport.APP_SECRET)
.build());
}
private static ChannelSdk sdk(RecordingTransport transport, ChannelAccount account,
CallObserver observer) {
LingxingAdapter adapter = new LingxingAdapter(
transport, new JacksonJsonCodec(),
new InMemoryTokenStore(), new InMemoryLockProvider(),
LingxingTestSupport.CLOCK);
return ChannelSdk.builder()
.accountRepository(new InMemoryAccounts().put(account))
.clock(LingxingTestSupport.CLOCK)
.register(adapter)
.callObserver(observer)
.build();
}
private static SalesOrderQuery query() {
return SalesOrderQuery.builder()
.updatedAfter(Instant.parse("2026-10-01T00:00:00Z"))
.updatedBefore(Instant.parse("2026-10-08T00:00:00Z"))
.pageSize(20)
.build();
}
@Test
void recordsSuccessfulLingxingCall() {
RecordingTransport transport = RecordingTransport.create()
.route(LingxingApi.ORDER_LIST.path(), r -> Responses.ok(ORDER_JSON));
ChannelAccount account = LingxingTestSupport.account(Platform.WALMART_SC, 10008, "store-1");
CollectingObserver observer = new CollectingObserver();
Page<SalesOrder> page = sdk(transport, account, observer)
.salesOrders(account.key(), connection()).pull(query());
assertEquals(1, page.size());
assertEquals("PO-1", page.items().get(0).channelOrderId());
assertEquals(1, observer.records.size());
CallRecord record = observer.records.get(0);
assertEquals("salesOrders.pull", record.operation());
assertEquals(CallOutcome.SUCCESS, record.outcome());
assertEquals(ChannelProvider.LINGXING, record.provider());
assertEquals(Platform.WALMART_SC, record.platform());
assertEquals(account.omsStoreId(), record.omsStoreId());
assertEquals("store-1", record.externalStoreId());
assertEquals(1, record.resultCount());
assertNotNull(record.requestId());
assertEquals(20, record.params().get("pageSize"));
assertFalse(record.failed());
// 领星请求确实带了账户的 platform_code + store_id
String body = transport.lastDataRequest().body();
assertTrue(body.contains("\"platform_code\":[10008]"), body);
assertTrue(body.contains("\"store_id\":[\"store-1\"]"), body);
}
@Test
void recordsFailureWhenLingxingReturnsBusinessError() {
RecordingTransport transport = RecordingTransport.create()
.route(LingxingApi.ORDER_LIST.path(), r -> Responses.ok(RATE_LIMITED_JSON));
ChannelAccount account = LingxingTestSupport.account(Platform.WALMART_SC, 10008, "store-1");
CollectingObserver observer = new CollectingObserver();
assertThrows(ChannelException.class,
() -> sdk(transport, account, observer)
.salesOrders(account.key(), connection()).pull(query()));
assertEquals(1, observer.records.size());
CallRecord record = observer.records.get(0);
assertEquals("salesOrders.pull", record.operation());
assertEquals(CallOutcome.FAILURE, record.outcome());
assertTrue(record.errorType().contains("RateLimitException"), record.errorType());
assertTrue(record.errorMessage().contains("3001008"), record.errorMessage());
}
@Test
void recordsCallWhenAccountHasNoPlatformCode() {
RecordingTransport transport = RecordingTransport.create()
.route(LingxingApi.ORDER_LIST.path(), r -> Responses.ok(ORDER_JSON));
// platformCode = 0 表示不设置,对应没有平台码的长尾平台
ChannelAccount account = LingxingTestSupport.account(Platform.WALMART_SC, 0, "store-1");
CollectingObserver observer = new CollectingObserver();
Page<SalesOrder> page = sdk(transport, account, observer)
.salesOrders(account.key(), connection()).pull(query());
assertEquals(1, page.size());
assertEquals(1, observer.records.size());
assertEquals(CallOutcome.SUCCESS, observer.records.get(0).outcome());
String body = Objects.requireNonNull(transport.lastDataRequest()).body();
assertFalse(body.contains("platform_code"), "没有平台码时不应发送该字段");
assertTrue(body.contains("\"store_id\":[\"store-1\"]"), body);
}
}
Loading…
Cancel
Save