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);