package common.ecommerce.edayun.adapter; import common.ecommerce.edayun.dto.EdayunTrackDtos; 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.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 org.junit.jupiter.api.Test; import java.time.Clock; import java.time.Instant; import java.time.ZoneOffset; import java.util.Arrays; 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; /** * 物流轨迹({@code /webApi/track/getTrackInfoList})映射。 * *

重点:请求体是纯字符串数组、上网/妥投时间是带时区的字符串、 * 「未匹配到轨迹」按空结果处理。

*/ class EdayunTrackTest { private static final Clock CLOCK = Clock.fixed(Instant.parse("2026-11-16T00:00:00Z"), ZoneOffset.UTC); private static WarehouseContext ctx() { return WarehouseContext.of("EDY-WH", WarehouseProvider.EDAYUN, "2", WarehouseConnection.of("https://test.example/openapi", ChannelSecret.builder().appKey("k").appSecret("s") .clientId("c").clientSecret("cs").build()), "req-track", CLOCK); } private static RecordingTransport stub(String body) { return RecordingTransport.create() .route(common.ecommerce.edayun.EdayunConstants.PATH_TOKEN, req -> Responses.ok( "{\"access_token\":\"T1\",\"token_type\":\"bearer\"}")) .route(common.ecommerce.edayun.EdayunConstants.PATH_TRACK, req -> Responses.ok(body)); } // ------------------------------------------------------------ 请求 /** 请求体是纯字符串数组,不是包装对象。 */ @Test void requestBodyIsPlainArray() { List body = EdayunTrackMapper.toRequest(Arrays.asList("1Z111", " 1Z222 ")); assertEquals(Arrays.asList("1Z111", "1Z222"), body); assertTrue(new JacksonJsonCodec().toJson(body).startsWith("[")); } @Test void blankTrackingNumbersRejected() { assertThrows(IllegalArgumentException.class, () -> EdayunTrackMapper.toRequest(null)); assertThrows(IllegalArgumentException.class, () -> EdayunTrackMapper.toRequest(java.util.Collections.emptyList())); assertThrows(IllegalArgumentException.class, () -> EdayunTrackMapper.toRequest(Arrays.asList(" ", ""))); } // ------------------------------------------------------------ 响应 private static EdayunTrackDtos.Track track() { EdayunTrackDtos.TrackDetail detail = new EdayunTrackDtos.TrackDetail(); detail.trackingNo = "LF-1741871641090"; detail.status = 1; detail.recentDescribe = "上网"; detail.recentDescribeTime = 1741145821000L; detail.eventStatus = "IN_TRANSIT"; EdayunTrackDtos.Track track = new EdayunTrackDtos.Track(); track.trackId = 123L; track.trackingNo = "LF-1741871641090"; track.status = 1; track.carrierName = "fedex"; track.startCountryName = "中国"; track.endCountryName = "美国"; track.receiver = "123"; track.trackDetaillVoList = java.util.Collections.singletonList(detail); track.onlineTime = "2025-08-19 08:17:00"; track.deliveredTime = "2025-08-20 10:00:00"; track.timeZone = "GMT-04:00"; return track; } @Test void mapsTrackingInfo() { TrackingInfo info = EdayunTrackMapper.toTrackingInfo(track()); assertEquals("LF-1741871641090", info.trackingNumber()); assertEquals("fedex", info.carrier()); assertEquals("1", info.status()); assertEquals("123", info.signedBy()); // 上网 / 妥投时间按 GMT-04:00 解释 assertEquals(Instant.parse("2025-08-19T12:17:00Z"), info.firstOnlineAt()); assertEquals(Instant.parse("2025-08-20T14:00:00Z"), info.deliveredAt()); assertEquals(1, info.events().size()); } /** 节点状态优先用 eventStatus,缺失才退回数字码。 */ @Test void eventStatusFallsBackToCode() { EdayunTrackDtos.Track t = track(); t.trackDetaillVoList.get(0).eventStatus = null; assertEquals("1", EdayunTrackMapper.toTrackEvents(t).get(0).status()); t.trackDetaillVoList.get(0).eventStatus = "DELIVERED"; assertEquals("DELIVERED", EdayunTrackMapper.toTrackEvents(t).get(0).status()); } @Test void mapsEvents() { List events = EdayunTrackMapper.toTrackEvents(track()); assertEquals(1, events.size()); TrackEvent e = events.get(0); assertEquals("LF-1741871641090", e.trackingNumber()); assertEquals("fedex", e.carrier()); assertEquals("上网", e.description()); assertEquals(Instant.ofEpochMilli(1741145821000L), e.occurredAt()); } /** 时间字符串解析失败留 null,不抛异常。 */ @Test void unparsableTimesStayNull() { EdayunTrackDtos.Track t = track(); t.onlineTime = "not-a-time"; t.deliveredTime = null; TrackingInfo info = EdayunTrackMapper.toTrackingInfo(t); assertNull(info.firstOnlineAt()); assertNull(info.deliveredAt()); } /** 时区偏移解析:GMT±HH:mm、UTC±HH:mm、空值。 */ @Test void zoneParsing() { assertEquals(ZoneOffset.of("-04:00"), EdayunTrackMapper.zoneOf("GMT-04:00")); assertEquals(ZoneOffset.of("+08:00"), EdayunTrackMapper.zoneOf("UTC+08:00")); assertEquals(ZoneOffset.of("+08:00"), EdayunTrackMapper.zoneOf("+08:00")); assertEquals(ZoneOffset.UTC, EdayunTrackMapper.zoneOf(null)); assertEquals(ZoneOffset.UTC, EdayunTrackMapper.zoneOf("bogus")); } /** 一次查多个跟踪号时按单号精确匹配。 */ @Test void findMatchesByTrackingNumber() { EdayunTrackDtos.Track other = track(); other.trackingNo = "OTHER-1"; EdayunTrackDtos.GetTrackResponse resp = new EdayunTrackDtos.GetTrackResponse(); resp.code = 200; resp.data = Arrays.asList(other, track()); assertEquals("LF-1741871641090", EdayunTrackMapper.find(resp, "lf-1741871641090").trackingNo); assertNull(EdayunTrackMapper.find(resp, "NOPE")); assertNull(EdayunTrackMapper.find(null, "X")); } // ------------------------------------------------------------ 门面 @Test void adapterTracksShipment() { RecordingTransport transport = stub("{\"code\":200,\"msg\":\"ok\",\"data\":[{" + "\"trackingNo\":\"LF-1\",\"status\":1,\"carrierName\":\"fedex\"," + "\"onlineTime\":\"2025-08-19 08:17:00\",\"deliveredTime\":null," + "\"timeZone\":\"GMT+08:00\",\"trackDetaillVoList\":[" + "{\"recentDescribe\":\"上网\",\"recentDescribeTime\":1741145821000}]}]}"); TrackingInfo info = new EdayunAdapter(transport, new JacksonJsonCodec()) .trackShipment(ctx(), "LF-1"); assertEquals("LF-1", info.trackingNumber()); assertEquals(Instant.parse("2025-08-19T00:17:00Z"), info.firstOnlineAt()); assertNull(info.deliveredAt()); // 请求体是纯数组 assertEquals("[\"LF-1\"]", transport.lastDataRequest().body()); } /** * 「未匹配到轨迹」是「还没轨迹」,不是调用失败:返回空列表 / null,不抛异常。 */ @Test void noTrackFoundYieldsEmpty() { RecordingTransport transport = stub( "{\"code\":500,\"msg\":\"未匹配到轨迹\",\"data\":null}"); assertTrue(new EdayunAdapter(transport, new JacksonJsonCodec()) .track(ctx(), "NOPE").isEmpty()); assertNull(new EdayunAdapter(transport, new JacksonJsonCodec()) .trackShipment(ctx(), "NOPE")); } /** 其它业务错误仍要抛异常。 */ @Test void otherErrorsStillThrow() { RecordingTransport transport = stub("{\"code\":500,\"msg\":\"系统异常\"}"); assertThrows(RuntimeException.class, () -> new EdayunAdapter(transport, new JacksonJsonCodec()).track(ctx(), "X")); } }