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文档未给出 {@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(); } }