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.
217 lines
8.6 KiB
217 lines
8.6 KiB
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})映射。 |
|
* |
|
* <p>重点:请求体是纯字符串数组、上网/妥投时间是带时区的字符串、 |
|
* 「未匹配到轨迹」按空结果处理。</p> |
|
*/ |
|
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<String> 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.<String>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<TrackEvent> 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")); |
|
} |
|
}
|
|
|