|
|
|
|
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)。
|
|
|
|
|
*
|
|
|
|
|
* <p>状态值一律保持运去哪原话,不做归一:承运商的节点状态词汇差异大,
|
|
|
|
|
* 「派送失败 / 退回中」这类区分归一会丢信息。</p>
|
|
|
|
|
*/
|
|
|
|
|
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);
|
|
|
|
|
|
|
|
|
|
List<YqnTrackingDtos.ShipmentTrack.TrackDetail> details = track.trackingDetails;
|
|
|
|
|
if (details != null) {
|
|
|
|
|
for (YqnTrackingDtos.ShipmentTrack.TrackDetail detail : details) {
|
|
|
|
|
builder.event(toTrackEvent(detail, trackingNo, track.carrier, zone));
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
return builder.build();
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
/** 只取节点明细。 */
|
|
|
|
|
public static List<TrackEvent> 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<String> parts = new ArrayList<String>(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<String> parts, String v) {
|
|
|
|
|
if (hasText(v)) {
|
|
|
|
|
parts.add(v.trim());
|
|
|
|
|
}
|
|
|
|
|
}
|
|
|
|
|
|
|
|
|
|
private static String join(List<String> 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,不因时间格式阻断轨迹展示。
|
|
|
|
|
*
|
|
|
|
|
* <p>文档未给出 {@code datetime} 的格式,因此按「带时区 ISO → 常见本地格式」依次尝试;
|
|
|
|
|
* 都不带时区时按调用方给的 {@code zone} 解释。</p>
|
|
|
|
|
*/
|
|
|
|
|
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();
|
|
|
|
|
}
|
|
|
|
|
}
|