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

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