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})。 * *

请求体是纯字符串数组,没有包装对象。文档示例 * {@code [{"": ["aa","bb"]}]} 是自动生成的占位,真机只有纯数组能通。

* *

时间字段口径混杂:{@code onlineTime} / {@code deliveredTime} 是 * 带时区偏移的字符串,而节点时间 {@code recentDescribeTime} 是毫秒。 * 字符串时间要按响应里的 {@code timeZone}(如 {@code GMT-04:00})解释。

*/ public final class EdayunTrackMapper { private static final DateTimeFormatter TIME = DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"); private EdayunTrackMapper() { } /** 跟踪号 → 请求体(纯字符串数组)。 */ public static List toRequest(List trackingNumbers) { if (trackingNumbers == null || trackingNumbers.isEmpty()) { throw new IllegalArgumentException( "edayun track query needs at least one tracking number"); } List out = new ArrayList(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}。 * *

文档说「主要关注上网时间跟妥投时间」,所以这两个单独落到 * {@link TrackingInfo#firstOnlineAt()} / {@link TrackingInfo#deliveredAt()}, * 而不是混在节点里。字符串时间按响应里的 {@code timeZone} 解释,解析失败留 null。

*/ 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} 只要节点,不含上网 / 妥投这两条汇总时间。 * *

与 {@link #toTrackingInfo} 分开,是因为统一模型把节点列表和运单汇总 * 视为两个层次;上网 / 妥投是汇总信息,不塞进节点里。

*/ public static List toTrackEvents(EdayunTrackDtos.Track track) { if (track == null || track.trackDetaillVoList == null) { return java.util.Collections.emptyList(); } List out = new ArrayList(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; } /** * 从响应里按跟踪号取一条轨迹。 * *

接口一次可查多个跟踪号;{@code track} / {@code trackShipment} 都是单个口径, * 所以按跟踪号精确匹配。找不到返回 null,不抛异常——运单可能刚生成还没轨迹。

*/ 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}。 * *

认不出返回 UTC——不猜成仓所在时区(那是另一个概念)。

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