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.
178 lines
7.3 KiB
178 lines
7.3 KiB
|
5 days ago
|
package common.ecommerce.edayun.adapter;
|
||
|
|
|
||
|
|
import common.ecommerce.edayun.dto.EdayunTrackDtos;
|
||
|
|
import common.ecommerce.warehouse.model.TrackEvent;
|
||
|
|
import common.ecommerce.warehouse.model.TrackingInfo;
|
||
|
|
|
||
|
|
import java.time.Instant;
|
||
|
|
import java.time.LocalDateTime;
|
||
|
|
import java.time.ZoneId;
|
||
|
|
import java.time.ZoneOffset;
|
||
|
|
import java.time.format.DateTimeFormatter;
|
||
|
|
import java.time.format.DateTimeParseException;
|
||
|
|
import java.util.ArrayList;
|
||
|
|
import java.util.List;
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 易达云物流轨迹映射({@code POST /webApi/track/getTrackInfoList})。
|
||
|
|
*
|
||
|
|
* <p><b>请求体是纯字符串数组</b>,没有包装对象。文档示例
|
||
|
|
* {@code [{"": ["aa","bb"]}]} 是自动生成的占位,真机只有纯数组能通。</p>
|
||
|
|
*
|
||
|
|
* <p>时间字段口径混杂:{@code onlineTime} / {@code deliveredTime} 是
|
||
|
|
* <b>带时区偏移的字符串</b>,而节点时间 {@code recentDescribeTime} 是毫秒。
|
||
|
|
* 字符串时间要按响应里的 {@code timeZone}(如 {@code GMT-04:00})解释。</p>
|
||
|
|
*/
|
||
|
|
public final class EdayunTrackMapper {
|
||
|
|
|
||
|
|
private static final DateTimeFormatter TIME = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss");
|
||
|
|
|
||
|
|
private EdayunTrackMapper() {
|
||
|
|
}
|
||
|
|
|
||
|
|
/** 跟踪号 → 请求体(纯字符串数组)。 */
|
||
|
|
public static List<String> toRequest(List<String> trackingNumbers) {
|
||
|
|
if (trackingNumbers == null || trackingNumbers.isEmpty()) {
|
||
|
|
throw new IllegalArgumentException(
|
||
|
|
"edayun track query needs at least one tracking number");
|
||
|
|
}
|
||
|
|
List<String> out = new ArrayList<String>(trackingNumbers.size());
|
||
|
|
for (String tn : trackingNumbers) {
|
||
|
|
if (tn != null && !tn.trim().isEmpty()) {
|
||
|
|
out.add(tn.trim());
|
||
|
|
}
|
||
|
|
}
|
||
|
|
if (out.isEmpty()) {
|
||
|
|
throw new IllegalArgumentException(
|
||
|
|
"edayun track query needs at least one non-blank tracking number");
|
||
|
|
}
|
||
|
|
return out;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 一条轨迹 → {@link TrackingInfo}。
|
||
|
|
*
|
||
|
|
* <p>文档说「主要关注上网时间跟妥投时间」,所以这两个单独落到
|
||
|
|
* {@link TrackingInfo#firstOnlineAt()} / {@link TrackingInfo#deliveredAt()},
|
||
|
|
* 而不是混在节点里。字符串时间按响应里的 {@code timeZone} 解释,解析失败留 null。</p>
|
||
|
|
*/
|
||
|
|
public static TrackingInfo toTrackingInfo(EdayunTrackDtos.Track track) {
|
||
|
|
if (track == null || track.trackingNo == null || track.trackingNo.trim().isEmpty()) {
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
ZoneId zone = zoneOf(track.timeZone);
|
||
|
|
TrackingInfo.Builder builder = TrackingInfo.builder()
|
||
|
|
.trackingNumber(track.trackingNo.trim())
|
||
|
|
.carrier(track.carrierName)
|
||
|
|
// 仓方状态是数字码,码表没给;保留原值而不是猜成某个字符串
|
||
|
|
.status(track.status == null ? null : String.valueOf(track.status))
|
||
|
|
.signedBy(track.receiver)
|
||
|
|
.firstOnlineAt(parseLocal(track.onlineTime, zone))
|
||
|
|
.deliveredAt(parseLocal(track.deliveredTime, zone));
|
||
|
|
|
||
|
|
if (track.trackDetaillVoList != null) {
|
||
|
|
for (EdayunTrackDtos.TrackDetail detail : track.trackDetaillVoList) {
|
||
|
|
if (detail == null) {
|
||
|
|
continue;
|
||
|
|
}
|
||
|
|
builder.event(TrackEvent.builder()
|
||
|
|
.trackingNumber(track.trackingNo.trim())
|
||
|
|
.carrier(track.carrierName)
|
||
|
|
.status(detail.eventStatus != null ? detail.eventStatus
|
||
|
|
: (detail.status == null ? null : String.valueOf(detail.status)))
|
||
|
|
.description(detail.recentDescribe)
|
||
|
|
.occurredAt(instantOf(detail.recentDescribeTime))
|
||
|
|
.build());
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return builder.build();
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 节点列表:{@code track} 只要节点,不含上网 / 妥投这两条汇总时间。
|
||
|
|
*
|
||
|
|
* <p>与 {@link #toTrackingInfo} 分开,是因为统一模型把节点列表和运单汇总
|
||
|
|
* 视为两个层次;上网 / 妥投是汇总信息,不塞进节点里。</p>
|
||
|
|
*/
|
||
|
|
public static List<TrackEvent> toTrackEvents(EdayunTrackDtos.Track track) {
|
||
|
|
if (track == null || track.trackDetaillVoList == null) {
|
||
|
|
return java.util.Collections.emptyList();
|
||
|
|
}
|
||
|
|
List<TrackEvent> out = new ArrayList<TrackEvent>(track.trackDetaillVoList.size());
|
||
|
|
for (EdayunTrackDtos.TrackDetail detail : track.trackDetaillVoList) {
|
||
|
|
if (detail == null) {
|
||
|
|
continue;
|
||
|
|
}
|
||
|
|
out.add(TrackEvent.builder()
|
||
|
|
.trackingNumber(track.trackingNo)
|
||
|
|
.carrier(track.carrierName)
|
||
|
|
.status(detail.eventStatus != null ? detail.eventStatus
|
||
|
|
: (detail.status == null ? null : String.valueOf(detail.status)))
|
||
|
|
.description(detail.recentDescribe)
|
||
|
|
.occurredAt(instantOf(detail.recentDescribeTime))
|
||
|
|
.build());
|
||
|
|
}
|
||
|
|
return out;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 从响应里按跟踪号取一条轨迹。
|
||
|
|
*
|
||
|
|
* <p>接口一次可查多个跟踪号;{@code track} / {@code trackShipment} 都是单个口径,
|
||
|
|
* 所以按跟踪号精确匹配。找不到返回 null,不抛异常——运单可能刚生成还没轨迹。</p>
|
||
|
|
*/
|
||
|
|
public static EdayunTrackDtos.Track find(EdayunTrackDtos.GetTrackResponse response,
|
||
|
|
String trackingNumber) {
|
||
|
|
if (response == null || response.data == null || trackingNumber == null) {
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
String target = trackingNumber.trim();
|
||
|
|
for (EdayunTrackDtos.Track track : response.data) {
|
||
|
|
if (track != null && track.trackingNo != null
|
||
|
|
&& target.equalsIgnoreCase(track.trackingNo.trim())) {
|
||
|
|
return track;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
|
||
|
|
/**
|
||
|
|
* 解析时区偏移,如 {@code GMT-04:00} / {@code GMT+08:00}。
|
||
|
|
*
|
||
|
|
* <p>认不出返回 UTC——不猜成仓所在时区(那是另一个概念)。</p>
|
||
|
|
*/
|
||
|
|
static ZoneId zoneOf(String gmtOffset) {
|
||
|
|
if (gmtOffset == null || gmtOffset.trim().isEmpty()) {
|
||
|
|
return ZoneOffset.UTC;
|
||
|
|
}
|
||
|
|
String v = gmtOffset.trim().toUpperCase(java.util.Locale.ROOT);
|
||
|
|
if (v.startsWith("GMT")) {
|
||
|
|
v = v.substring(3);
|
||
|
|
} else if (v.startsWith("UTC")) {
|
||
|
|
v = v.substring(3);
|
||
|
|
}
|
||
|
|
try {
|
||
|
|
return ZoneOffset.of(v.isEmpty() ? "Z" : v);
|
||
|
|
} catch (java.time.DateTimeException e) {
|
||
|
|
return ZoneOffset.UTC;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
/** 字符串时间({@code yyyy-MM-dd HH:mm:ss})→ Instant;解析失败返回 null。 */
|
||
|
|
static Instant parseLocal(String value, ZoneId zone) {
|
||
|
|
if (value == null || value.trim().isEmpty()) {
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
try {
|
||
|
|
return LocalDateTime.parse(value.trim(), TIME)
|
||
|
|
.atZone(zone == null ? ZoneOffset.UTC : zone).toInstant();
|
||
|
|
} catch (DateTimeParseException e) {
|
||
|
|
return null;
|
||
|
|
}
|
||
|
|
}
|
||
|
|
|
||
|
|
private static Instant instantOf(Long millis) {
|
||
|
|
return millis == null || millis <= 0 ? null : Instant.ofEpochMilli(millis);
|
||
|
|
}
|
||
|
|
}
|