From 6e7c15ee3fcca4d7c578f8ca284f1511406ce3e7 Mon Sep 17 00:00:00 2001 From: lml <1297555865@qq.com> Date: Thu, 5 Nov 2026 09:49:41 +0800 Subject: [PATCH] =?UTF-8?q?fix(lingxing):=20=E5=85=BC=E5=AE=B9=E8=AE=A2?= =?UTF-8?q?=E5=8D=95=E6=A0=87=E7=AD=BE=E5=AD=97=E7=AC=A6=E4=B8=B2=E5=BD=A2?= =?UTF-8?q?=E6=80=81=E5=B9=B6=E8=AE=A9=E5=BA=97=E9=93=BA=E8=BF=94=E5=9B=9E?= =?UTF-8?q?=E7=9C=9F=E5=AE=9E=E5=B9=B3=E5=8F=B0=E5=90=8D?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit - LingxingOrderTagDto 增加兼容反序列化器:order_tag 是对象, pending_order_tag / exception_order_tag 可能是纯字符串(如 ["未分配物流"]) - 字符串形态只填 tagName,tagNo / tagType 留空;对象形态保持原映射 - 反序列化器挂在字段 contentUsing 上,避免类级注册导致回读递归 - SubChannel.attributes 带上领星 platform_name - 声明为 Platform.CUSTOM 的子平台按响应 platform_code 反推,不再统一显示 CUSTOM --- .../ecommerce/lingxing/dto/LingxingOrderDto.java | 8 ++- .../lingxing/dto/LingxingOrderTagDto.java | 57 ++++++++++++++++++++-- .../shop/MultiPlatformShopSource.java | 37 +++++++++++--- 3 files changed, 90 insertions(+), 12 deletions(-) diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderDto.java index f30a315..bc082df 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderDto.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderDto.java @@ -2,6 +2,7 @@ package common.ecommerce.lingxing.dto; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.databind.annotation.JsonDeserialize; import lombok.Getter; import lombok.Setter; @@ -190,14 +191,17 @@ public class LingxingOrderDto { /** 订单标签 + 处理类型。 */ @JsonProperty("order_tag") + @JsonDeserialize(contentUsing = LingxingOrderTagDto.Deserializer.class) private List orderTag = new ArrayList(); - /** 异常类型标签。 */ + /** 异常类型标签;可能是对象,也可能只是字符串。 */ @JsonProperty("exception_order_tag") + @JsonDeserialize(contentUsing = LingxingOrderTagDto.Deserializer.class) private List exceptionOrderTag = new ArrayList(); - /** 待办类型标签。 */ + /** 待办类型标签;可能是对象,也可能只是字符串(如 {@code ["未分配物流"]})。 */ @JsonProperty("pending_order_tag") + @JsonDeserialize(contentUsing = LingxingOrderTagDto.Deserializer.class) private List pendingOrderTag = new ArrayList(); /** 平台单信息;合并单一个系统单号可能对应多条。 */ diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderTagDto.java b/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderTagDto.java index 2acce25..a57b43d 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderTagDto.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderTagDto.java @@ -2,31 +2,82 @@ package common.ecommerce.lingxing.dto; import com.fasterxml.jackson.annotation.JsonIgnoreProperties; import com.fasterxml.jackson.annotation.JsonProperty; +import com.fasterxml.jackson.core.JsonParser; +import com.fasterxml.jackson.core.JsonToken; +import com.fasterxml.jackson.databind.DeserializationContext; +import com.fasterxml.jackson.databind.JsonDeserializer; +import com.fasterxml.jackson.databind.JsonNode; import lombok.Getter; import lombok.Setter; +import java.io.IOException; + /** * 领星订单标签({@code order_tag[]} / {@code exception_order_tag[]} / * {@code pending_order_tag[]})。 + * + *

同一类字段领星有两种返回形态:

+ *
    + *
  • {@code order_tag[]} 是对象: + * {@code {"tag_name":"商品未配对","tag_no":"3-8","tag_type":"系统处理类型"}}
  • + *
  • {@code pending_order_tag[]} / {@code exception_order_tag[]} 可能是纯字符串: + * {@code ["未分配物流"]}
  • + *
+ * + *

对应字段用 {@link Deserializer} 兼容两种形态,字符串只填 {@link #tagName}。

*/ @Getter @Setter @JsonIgnoreProperties(ignoreUnknown = true) public class LingxingOrderTagDto { - /** 标签名称,如「商品未配对」。 */ + /** 标签名称,如「商品未配对」「未分配物流」。 */ @JsonProperty("tag_name") private String tagName; - /** 标签编号,如 {@code 3-8}。 */ + /** 标签编号,如 {@code 3-8};字符串形态没有这个字段。 */ @JsonProperty("tag_no") private String tagNo; /** * 标签类型:1 自定义处理类型、2 自定义订单标签、3 系统处理类型、4 系统订单标签。 * - *

文档类型是 string;示例响应里直接返回中文名(如「系统处理类型」)。

+ *

文档类型是 string;示例响应里直接返回中文名(如「系统处理类型」)。 + * 字符串形态没有这个字段。

*/ @JsonProperty("tag_type") private String tagType; + + /** + * 同时接受「对象」与「纯字符串」两种标签形态。 + * + *

注册方式是在 {@link LingxingOrderDto} 的列表字段上用 + * {@code @JsonDeserialize(contentUsing = LingxingOrderTagDto.Deserializer.class)}, + * 不放在类上,避免 {@link #deserialize} 里回读对象时递归。

+ */ + public static final class Deserializer extends JsonDeserializer { + + @Override + public LingxingOrderTagDto deserialize(JsonParser p, DeserializationContext ctxt) + throws IOException { + if (p.hasToken(JsonToken.VALUE_STRING)) { + return fromName(p.getText()); + } + JsonNode node = p.readValueAsTree(); + if (node == null || node.isNull()) { + return null; + } + if (node.isTextual()) { + return fromName(node.asText()); + } + // 对象形态交回标准绑定,tag_no / tag_type 照常映射 + return p.getCodec().treeToValue(node, LingxingOrderTagDto.class); + } + + private static LingxingOrderTagDto fromName(String name) { + LingxingOrderTagDto tag = new LingxingOrderTagDto(); + tag.setTagName(name); + return tag; + } + } } diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/shop/MultiPlatformShopSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/shop/MultiPlatformShopSource.java index e89f95f..2480c6b 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/shop/MultiPlatformShopSource.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/shop/MultiPlatformShopSource.java @@ -32,6 +32,11 @@ import java.util.Map; * 这些平台无法由平台码反推业务平台,所以每个子平台构造时显式传入自己的 * {@link Platform}:店铺列表仍按账户的 {@code platformCode} 查询, * 返回的子渠道则标注为传入的业务平台,不依赖平台码猜。

+ * + *

例外是声明为 {@link Platform#CUSTOM} 的子平台:它本身就表示「不知道真实平台」 + * (典型场景是没有平台码、只按 {@code store_id} 查询),此时按响应里的 + * {@code platform_code} 反推,让店铺至少能显示成 MIRAKL / WALMART_SC 等真实平台, + * 而不是清一色的 CUSTOM。反推不出来的(如 10009 自定义平台)仍回落 CUSTOM。

*/ public final class MultiPlatformShopSource implements LingxingShopSource { @@ -83,11 +88,13 @@ public final class MultiPlatformShopSource implements LingxingShopSource { continue; } Integer code = shop.getPlatformCode(); - out.add(new SubChannel( - code == null ? 0 : code, - shop.getStoreId(), - resolvePlatform(code), - shop.getStoreName())); + out.add(SubChannel.builder() + .platformCode(code == null ? 0 : code) + .externalStoreId(shop.getStoreId()) + .platform(resolvePlatform(code)) + .name(shop.getStoreName()) + .attributes(attributesOf(shop)) + .build()); } offset += shops.size(); @@ -101,9 +108,25 @@ public final class MultiPlatformShopSource implements LingxingShopSource { return Collections.unmodifiableList(out); } - /** 优先用子平台声明的业务平台;没有声明时才按平台码反推。 */ + /** + * 领星原始字段放进 {@link SubChannel#attributes()},避免往 core 模型里加领星专有字段。 + * + *

{@code platform_name} 是领星给的平台可读名称(如 {@code Walmart}), + * 没有平台码时它比 {@code platform_code} 更值得展示。

+ */ + private static Map attributesOf(MultiPlatformShopDto shop) { + Map attrs = new LinkedHashMap(); + if (shop.getPlatformName() != null) { + attrs.put("platform_name", shop.getPlatformName()); + } + return attrs; + } + + /** 优先用子平台声明的业务平台;声明为 {@link Platform#CUSTOM} 时按平台码反推。 */ private Platform resolvePlatform(Integer platformCode) { - if (platform != null) { + // 声明的业务平台优先;CUSTOM 表示「不知道该平台的真实身份」(无平台码场景), + // 这时按响应里的 platform_code 反推,比把 Target/Walmart 等店铺统一标成 CUSTOM 有用。 + if (platform != null && platform != Platform.CUSTOM) { return platform; } Platform mapped = LingxingConstants.toPlatform(platformCode);