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
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)); |
|
} |
|
}
|
|
|