You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

194 lines
8.8 KiB

package common.ecommerce.yqn.adapter;
import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.shared.spi.ChannelSecret;
import common.ecommerce.shared.testkit.RecordingTransport;
import common.ecommerce.shared.testkit.Responses;
import common.ecommerce.warehouse.enums.WarehouseCapability;
import common.ecommerce.warehouse.enums.WarehouseProvider;
import common.ecommerce.warehouse.model.TrackEvent;
import common.ecommerce.warehouse.model.TrackingInfo;
import common.ecommerce.warehouse.sdk.WarehouseConnection;
import common.ecommerce.warehouse.sdk.WarehouseContext;
import common.ecommerce.warehouse.sdk.WarehouseAdapter;
import java.util.EnumSet;
import common.ecommerce.yqn.YqnConstants;
import org.junit.jupiter.api.Test;
import java.time.Clock;
import java.time.Instant;
import java.time.ZoneOffset;
import java.util.List;
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;
/**
* 物流轨迹(API 189)契约测试。
*
* <p>注意这个接口在<b>另一个主机</b>,且成功码是 {@code 1} 而不是 {@code 200}。</p>
*/
class YqnTrackingTest {
private static final Clock CLOCK = Clock.fixed(Instant.parse("2026-11-10T00:00:00Z"), ZoneOffset.UTC);
private static ChannelSecret secret() {
return ChannelSecret.builder().appSecret("key-1").build();
}
/** 主基址 + 辅助基址。 */
private static WarehouseContext ctx() {
return WarehouseContext.of("YQN-RF_NY_US", WarehouseProvider.YQN, "RF_NY_US",
WarehouseConnection.of(YqnConstants.PR_BASE_URL, YqnConstants.AUX_BASE_URL_PR, secret()),
"req-track", CLOCK);
}
/** 只有主基址。 */
private static WarehouseContext ctxWithoutAux() {
return WarehouseContext.of("YQN-RF_NY_US", WarehouseProvider.YQN, "RF_NY_US",
WarehouseConnection.of(YqnConstants.PR_BASE_URL, secret()), "req-track", CLOCK);
}
private static final String OK_BODY =
"{\"code\":1,\"message\":\"success\",\"data\":{"
+ "\"id\":9527,\"carrier\":\"FEDEX\",\"trackingCode\":\"TRK123\","
+ "\"status\":\"DELIVERED\",\"statusDetail\":\"已签收\","
+ "\"estDeliveryDate\":\"2026-11-12T10:00:00Z\","
+ "\"signedBy\":\"J SMITH\",\"publicUrl\":\"https://track.example/TRK123\","
+ "\"trackingDetails\":["
+ "{\"status\":\"IN_TRANSIT\",\"message\":\"已离开分拨中心\","
+ "\"datetime\":\"2026-11-09 08:30:00\",\"timeZone\":\"America/New_York\","
+ "\"trackingLocation\":{\"city\":\"Newark\",\"state\":\"NJ\","
+ "\"country\":\"US\",\"zip\":\"07102\"}},"
+ "{\"status\":\"DELIVERED\",\"message\":\"delivered\","
+ "\"datetime\":\"2026-11-10T15:20:00Z\",\"signedBy\":null}],"
+ "\"carrierDetail\":{\"service\":\"FedEx_FEDEX_GROUND\"}}}";
@Test
void callsAuxiliaryHostNotWarehouseHost() {
RecordingTransport transport = RecordingTransport.create()
.route("/api/v2/orderShipment/track/TRK123", req -> Responses.ok(OK_BODY));
new YqnAdapter(transport, new JacksonJsonCodec()).trackShipment(ctx(), "TRK123");
String url = transport.lastDataRequest().url();
assertTrue(url.startsWith(YqnConstants.AUX_BASE_URL_PR), url);
assertTrue(url.contains("/api/v2/orderShipment/track/TRK123"), url);
}
@Test
void missingAuxEndpointIsRejectedNotSilentlyRetargeted() {
RecordingTransport transport = RecordingTransport.create();
YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec());
assertThrows(common.ecommerce.warehouse.error.WarehouseUnsupportedCapabilityException.class,
() -> adapter.trackShipment(ctxWithoutAux(), "TRK123"));
assertTrue(transport.recorded().isEmpty(), "不应该发出任何请求");
}
@Test
void mapsShipmentLevelFields() {
RecordingTransport transport = RecordingTransport.create()
.route("/api/v2/orderShipment/track/TRK123", req -> Responses.ok(OK_BODY));
YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec());
TrackingInfo info = adapter.trackShipment(ctx(), "TRK123");
assertEquals("TRK123", info.trackingNumber());
assertEquals("FEDEX", info.carrier());
assertEquals("FedEx_FEDEX_GROUND", info.carrierService());
assertEquals("DELIVERED", info.status());
assertEquals("已签收", info.statusDetail());
assertEquals(Instant.parse("2026-11-12T10:00:00Z"), info.estimatedDeliveryAt());
assertEquals("J SMITH", info.signedBy());
assertEquals("https://track.example/TRK123", info.publicUrl());
assertEquals(2, info.events().size());
}
@Test
void mapsTrackingDetailsAndLocation() {
RecordingTransport transport = RecordingTransport.create()
.route("/api/v2/orderShipment/track/TRK123", req -> Responses.ok(OK_BODY));
YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec());
TrackingInfo info = adapter.trackShipment(ctx(), "TRK123");
TrackEvent first = info.events().get(0);
assertEquals("IN_TRANSIT", first.status());
assertEquals("已离开分拨中心", first.description());
assertEquals("Newark, NJ, US, 07102", first.location());
assertEquals("TRK123", first.trackingNumber());
assertEquals("FEDEX", first.carrier());
// 带时区的直接解析;本地格式按调用时区解释
assertEquals(Instant.parse("2026-11-10T15:20:00Z"), info.events().get(1).occurredAt());
TrackEvent second = info.events().get(1);
assertEquals("DELIVERED", second.status());
assertNull(second.location());
}
@Test
void trackReturnsSameEventsAsTrackShipment() {
RecordingTransport transport = RecordingTransport.create()
.route("/api/v2/orderShipment/track/TRK123", req -> Responses.ok(OK_BODY));
YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec());
List<TrackEvent> events = adapter.track(ctx(), "TRK123");
assertEquals(2, events.size());
assertEquals("IN_TRANSIT", events.get(0).status());
}
/**
* 成功码兼容 1 与 200:文档示例是 1,但同站其它接口是 200,示例值又是自动生成的
* 占位符,两种都接受;真失败码必须拒绝。
*/
@Test
void acceptsBothOneAndTwoHundred() {
for (String code : new String[] {"1", "200"}) {
RecordingTransport transport = RecordingTransport.create()
.route("/api/v2/orderShipment/track/TRK123", req -> Responses.ok(
"{\"code\":" + code + ",\"message\":\"ok\","
+ "\"data\":{\"trackingCode\":\"TRK123\",\"carrier\":\"FEDEX\"}}"));
TrackingInfo info = new YqnAdapter(transport, new JacksonJsonCodec())
.trackShipment(ctx(), "TRK123");
assertEquals("TRK123", info.trackingNumber());
}
}
@Test
void failedCodeIsRejected() {
RecordingTransport transport = RecordingTransport.create()
.route("/api/v2/orderShipment/track/TRK123", req -> Responses.ok(
"{\"code\":500,\"message\":\"boom\",\"data\":{}}"));
YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec());
RuntimeException ex = assertThrows(RuntimeException.class,
() -> adapter.trackShipment(ctx(), "TRK123"));
assertTrue(ex.getMessage().contains("code=500"), ex.getMessage());
}
@Test
void missingCodeIsFailure() {
RecordingTransport transport = RecordingTransport.create()
.route("/api/v2/orderShipment/track/TRK123", req -> Responses.ok(
"{\"message\":\"oops\"}"));
YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec());
assertThrows(RuntimeException.class, () -> adapter.trackShipment(ctx(), "TRK123"));
}
@Test
void declaresTrackingCapability() {
YqnAdapter adapter = new YqnAdapter(RecordingTransport.create(), new JacksonJsonCodec());
assertTrue(adapter.capabilities().contains(WarehouseCapability.TRACKING));
}
@Test
void blankTrackingNumberRejected() {
YqnAdapter adapter = new YqnAdapter(RecordingTransport.create(), new JacksonJsonCodec());
assertThrows(IllegalArgumentException.class, () -> adapter.trackShipment(ctx(), " "));
assertThrows(IllegalArgumentException.class, () -> adapter.trackShipment(ctx(), null));
}
}