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.
179 lines
8.1 KiB
179 lines
8.1 KiB
|
2 weeks ago
|
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 之类要按失败处理,不能当成成功去解析 data。 */
|
||
|
|
@Test
|
||
|
|
void nonOneCodeIsFailure() {
|
||
|
|
RecordingTransport transport = RecordingTransport.create()
|
||
|
|
.route("/api/v2/orderShipment/track/TRK123", req -> Responses.ok(
|
||
|
|
"{\"code\":200,\"message\":\"ok\",\"data\":{\"trackingCode\":\"TRK123\"}}"));
|
||
|
|
YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec());
|
||
|
|
|
||
|
|
RuntimeException ex = assertThrows(RuntimeException.class,
|
||
|
|
() -> adapter.trackShipment(ctx(), "TRK123"));
|
||
|
|
assertTrue(ex.getMessage().contains("code=200"), 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));
|
||
|
|
}
|
||
|
|
}
|