Browse Source

fix(lingxing): 兼容订单标签字符串形态并让店铺返回真实平台名

- LingxingOrderTagDto 增加兼容反序列化器:order_tag 是对象,
  pending_order_tag / exception_order_tag 可能是纯字符串(如 ["未分配物流"])
- 字符串形态只填 tagName,tagNo / tagType 留空;对象形态保持原映射
- 反序列化器挂在字段 contentUsing 上,避免类级注册导致回读递归
- SubChannel.attributes 带上领星 platform_name
- 声明为 Platform.CUSTOM 的子平台按响应 platform_code 反推,不再统一显示 CUSTOM
feature/supplier-lingxing
lml 2 weeks ago
parent
commit
6e7c15ee3f
  1. 8
      lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderDto.java
  2. 57
      lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderTagDto.java
  3. 37
      lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/shop/MultiPlatformShopSource.java

8
lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderDto.java

@ -2,6 +2,7 @@ package common.ecommerce.lingxing.dto; @@ -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 { @@ -190,14 +191,17 @@ public class LingxingOrderDto {
/** 订单标签 + 处理类型。 */
@JsonProperty("order_tag")
@JsonDeserialize(contentUsing = LingxingOrderTagDto.Deserializer.class)
private List<LingxingOrderTagDto> orderTag = new ArrayList<LingxingOrderTagDto>();
/** 异常类型标签。 */
/** 异常类型标签;可能是对象,也可能只是字符串。 */
@JsonProperty("exception_order_tag")
@JsonDeserialize(contentUsing = LingxingOrderTagDto.Deserializer.class)
private List<LingxingOrderTagDto> exceptionOrderTag = new ArrayList<LingxingOrderTagDto>();
/** 待办类型标签。 */
/** 待办类型标签;可能是对象,也可能只是字符串(如 {@code ["未分配物流"]})。 */
@JsonProperty("pending_order_tag")
@JsonDeserialize(contentUsing = LingxingOrderTagDto.Deserializer.class)
private List<LingxingOrderTagDto> pendingOrderTag = new ArrayList<LingxingOrderTagDto>();
/** 平台单信息;合并单一个系统单号可能对应多条。 */

57
lingxing/src/main/java/common/ecommerce/lingxing/dto/LingxingOrderTagDto.java

@ -2,31 +2,82 @@ package common.ecommerce.lingxing.dto; @@ -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[]})。
*
* <p>同一类字段领星有两种返回形态:</p>
* <ul>
* <li>{@code order_tag[]} 是对象:
* {@code {"tag_name":"商品未配对","tag_no":"3-8","tag_type":"系统处理类型"}}</li>
* <li>{@code pending_order_tag[]} / {@code exception_order_tag[]} 可能是纯字符串:
* {@code ["未分配物流"]}</li>
* </ul>
*
* <p>对应字段用 {@link Deserializer} 兼容两种形态,字符串只填 {@link #tagName}。</p>
*/
@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 系统订单标签。
*
* <p>文档类型是 string;示例响应里直接返回中文名(如「系统处理类型」)。</p>
* <p>文档类型是 string;示例响应里直接返回中文名(如「系统处理类型」)。
* 字符串形态没有这个字段。</p>
*/
@JsonProperty("tag_type")
private String tagType;
/**
* 同时接受「对象」与「纯字符串」两种标签形态。
*
* <p>注册方式是在 {@link LingxingOrderDto} 的列表字段上用
* {@code @JsonDeserialize(contentUsing = LingxingOrderTagDto.Deserializer.class)},
* 不放在类上,避免 {@link #deserialize} 里回读对象时递归。</p>
*/
public static final class Deserializer extends JsonDeserializer<LingxingOrderTagDto> {
@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;
}
}
}

37
lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/shop/MultiPlatformShopSource.java

@ -32,6 +32,11 @@ import java.util.Map; @@ -32,6 +32,11 @@ import java.util.Map;
* 这些平台无法由平台码反推业务平台,所以每个子平台构造时显式传入自己的
* {@link Platform}:店铺列表仍按<b>账户</b>的 {@code platformCode} 查询,
* 返回的子渠道则标注为传入的业务平台,不依赖平台码猜。</p>
*
* <p>例外是声明为 {@link Platform#CUSTOM} 的子平台:它本身就表示「不知道真实平台」
* (典型场景是没有平台码、只按 {@code store_id} 查询),此时按响应里的
* {@code platform_code} 反推,让店铺至少能显示成 MIRAKL / WALMART_SC 等真实平台,
* 而不是清一色的 CUSTOM。反推不出来的(如 10009 自定义平台)仍回落 CUSTOM。</p>
*/
public final class MultiPlatformShopSource implements LingxingShopSource {
@ -83,11 +88,13 @@ 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 { @@ -101,9 +108,25 @@ public final class MultiPlatformShopSource implements LingxingShopSource {
return Collections.unmodifiableList(out);
}
/** 优先用子平台声明的业务平台;没有声明时才按平台码反推。 */
/**
* 领星原始字段放进 {@link SubChannel#attributes()},避免往 core 模型里加领星专有字段。
*
* <p>{@code platform_name} 是领星给的平台可读名称(如 {@code Walmart}),
* 没有平台码时它比 {@code platform_code} 更值得展示。</p>
*/
private static Map<String, Object> attributesOf(MultiPlatformShopDto shop) {
Map<String, Object> attrs = new LinkedHashMap<String, Object>();
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);

Loading…
Cancel
Save