package common.ecommerce.yqn.adapter; import common.ecommerce.yqn.dto.YqnTrackingDtos; 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; /** * 运去哪物流轨迹映射(API 189)。 * *

状态值一律保持运去哪原话,不做归一:承运商的节点状态词汇差异大, * 「派送失败 / 退回中」这类区分归一会丢信息。

*/ public final class YqnTrackingMapper { /** 仓方给的节点时间没带时区,按目的地习惯优先解析;解析不出再看其它格式。 */ private static final DateTimeFormatter[] DATETIME_FORMATS = { DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss"), DateTimeFormatter.ISO_LOCAL_DATE_TIME, }; private YqnTrackingMapper() { } /** 响应 → 运单级轨迹。 */ public static TrackingInfo toTrackingInfo(YqnTrackingDtos.ShipmentTrack track, String requestedTrackingNo, ZoneId zone) { String trackingNo = hasText(track.trackingCode) ? track.trackingCode.trim() : requestedTrackingNo; YqnTrackingDtos.ShipmentTrack.CarrierDetail carrierDetail = track.carrierDetail; TrackingInfo.Builder builder = TrackingInfo.builder() .trackingNumber(trackingNo) .carrier(track.carrier) .carrierService(carrierDetail == null ? null : carrierDetail.service) .status(track.status) .statusDetail(track.statusDetail) .estimatedDeliveryAt(parseTime(track.estDeliveryDate, zone)) .signedBy(track.signedBy) .publicUrl(track.publicUrl) .guaranteedDeliveryDate(carrierDetail == null ? null : carrierDetail.guaranteedDeliveryDate) .originLocation(carrierDetail == null ? null : carrierDetail.originLocation) .destinationLocation(carrierDetail == null ? null : carrierDetail.destinationLocation); addParcel(builder, track.parcel); List details = track.trackingDetails; if (details != null) { for (YqnTrackingDtos.ShipmentTrack.TrackDetail detail : details) { builder.event(toTrackEvent(detail, trackingNo, track.carrier, zone)); } } return builder.build(); } /** * 包裹实重实尺:运去哪固定给 oz / inch,统一换算成 g / cm 后再落模型, * 避免宿主拿到不同仓的包裹尺寸还要各自换算。 */ private static void addParcel(TrackingInfo.Builder builder, YqnTrackingDtos.ShipmentTrack.Parcel parcel) { if (parcel == null) { return; } builder.parcelWeightGrams(ouncesToGrams(parcel.weight)) .parcelLengthCm(inchesToCm(parcel.length)) .parcelWidthCm(inchesToCm(parcel.width)) .parcelHeightCm(inchesToCm(parcel.height)); } private static Double ouncesToGrams(Double ounces) { return ounces == null ? null : ounces * 28.349523125; } private static Double inchesToCm(Double inches) { return inches == null ? null : inches * 2.54; } /** 只取节点明细。 */ public static List toTrackEvents(YqnTrackingDtos.ShipmentTrack track, String requestedTrackingNo, ZoneId zone) { return toTrackingInfo(track, requestedTrackingNo, zone).events(); } private static TrackEvent toTrackEvent(YqnTrackingDtos.ShipmentTrack.TrackDetail detail, String trackingNo, String carrier, ZoneId zone) { return TrackEvent.builder() .trackingNumber(trackingNo) .carrier(carrier) .status(detail.status) .description(hasText(detail.message) ? detail.message : detail.statusDetail) .location(locationOf(detail.trackingLocation)) .occurredAt(parseTime(detail.datetime, zone)) .build(); } /** 位置拼成一行,如 {@code New York, NY, US, 10001};全空返回 null。 */ private static String locationOf(YqnTrackingDtos.ShipmentTrack.TrackingLocation loc) { if (loc == null) { return null; } List parts = new ArrayList(4); addIfText(parts, loc.city); addIfText(parts, loc.state); addIfText(parts, loc.country); addIfText(parts, loc.zip); return parts.isEmpty() ? null : join(parts); } private static void addIfText(List parts, String v) { if (hasText(v)) { parts.add(v.trim()); } } private static String join(List parts) { StringBuilder sb = new StringBuilder(); for (int i = 0; i < parts.size(); i++) { if (i > 0) { sb.append(", "); } sb.append(parts.get(i)); } return sb.toString(); } /** * 解析仓方时间;失败返回 null,不因时间格式阻断轨迹展示。 * *

文档未给出 {@code datetime} 的格式,因此按「带时区 ISO → 常见本地格式」依次尝试; * 都不带时区时按调用方给的 {@code zone} 解释。

*/ static Instant parseTime(String value, ZoneId zone) { if (!hasText(value)) { return null; } String v = value.trim(); try { return Instant.parse(v); } catch (DateTimeParseException ignored) { // 试本地格式 } try { return java.time.OffsetDateTime.parse(v).toInstant(); } catch (DateTimeParseException ignored) { // 试本地格式 } for (DateTimeFormatter fmt : DATETIME_FORMATS) { try { return LocalDateTime.parse(v, fmt).atZone(zone == null ? ZoneOffset.UTC : zone).toInstant(); } catch (DateTimeParseException ignored) { // 下一个格式 } } try { return java.time.LocalDate.parse(v).atStartOfDay(zone == null ? ZoneOffset.UTC : zone).toInstant(); } catch (DateTimeParseException ignored) { return null; } } private static boolean hasText(String v) { return v != null && !v.trim().isEmpty(); } }