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

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