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.
218 lines
8.6 KiB
218 lines
8.6 KiB
|
4 days ago
|
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"));
|
||
|
|
}
|
||
|
|
}
|