Browse Source
SDK 层(core):
- 新增 ProductSearchField:PLATFORM_SKU / LOCAL_SKU,只定义跨平台语义一致的维度
- ProductQuery 增加 searchField / searchValue(单值模糊)/ searchValues(多值精确)
- 有搜索值但没 searchField 直接抛异常
- 单值与多值互斥,同时设置直接抛异常
- 新增 hasSearch() 与 toBuilder()
领星层(lingxing):
- LingxingProductSearchMapper:语义 → 平台枚举值
沃尔玛/eBay 1 / 3
AliExpress 1 / 5 (实测;文档写 3 但查不到)
Temu/SHEIN/TikTok 9 / 8
Shopify/Target 1 / 本地 SKU 待核对
亚马逊 SC "seller_sku" / "sku"(字符串)
- LingxingProductSearchBody:三种请求形态
camelCase(沃尔玛/eBay/Temu/SHEIN/TikTok/AliExpress)
snake_case(Shopify/Target)
amazonSc:search_value 数组 + exact_search 开关
- 八个商品 Source 接入;平台不支持的维度抛 ValidationException,不静默忽略
亚马逊 VC 不支持搜索(接入时会因 Mapper 抛异常而显式失败)。
Co-Authored-By: Claude <noreply@anthropic.com>
feature/supplier-lingxing
12 changed files with 476 additions and 14 deletions
@ -0,0 +1,23 @@
@@ -0,0 +1,23 @@
|
||||
package common.ecommerce.model.product; |
||||
|
||||
/** |
||||
* 商品搜索维度。 |
||||
* |
||||
* <p>只定义<b>跨平台语义一致</b>的维度;各平台自己的数字编码由适配器映射, |
||||
* 调用方不感知。见各适配器里的 {@code ProductSearchMapper}。</p> |
||||
* |
||||
* <ul> |
||||
* <li>{@link #PLATFORM_SKU}:平台侧 SKU。领星 {@code msku}、亚马逊 {@code seller_sku}、 |
||||
* 沃尔玛 {@code sku}。也是 {@link ProductListing#platformSku()} 的来源。</li> |
||||
* <li>{@link #LOCAL_SKU}:本地 SKU。领星配对时填的 {@code sku} / {@code local_sku}; |
||||
* 直连平台没有这个概念。</li> |
||||
* </ul> |
||||
*/ |
||||
public enum ProductSearchField { |
||||
|
||||
/** 平台侧 SKU。 */ |
||||
PLATFORM_SKU, |
||||
|
||||
/** 本地 SKU(领星特有)。 */ |
||||
LOCAL_SKU |
||||
} |
||||
@ -0,0 +1,80 @@
@@ -0,0 +1,80 @@
|
||||
package common.ecommerce.lingxing.platform.multiplatform.product; |
||||
|
||||
import common.ecommerce.model.product.ProductQuery; |
||||
|
||||
import java.util.List; |
||||
|
||||
/** |
||||
* 把统一的 SKU 搜索条件拼进领星请求体。 |
||||
* |
||||
* <p>各平台字段名与形态不同:</p> |
||||
* <ul> |
||||
* <li>沃尔玛 / eBay / Temu / SHEIN / TikTok / AliExpress:{@code searchField}(数字) |
||||
* + {@code searchSingleValue}(单值模糊)+ {@code searchValues}(多值精确)</li> |
||||
* <li>Shopify / Target:{@code search_field} + {@code search_single_value} + {@code search_values}</li> |
||||
* <li>亚马逊 SC:{@code search_field}(字符串)+ {@code search_value}(数组)+ {@code exact_search}</li> |
||||
* </ul> |
||||
*/ |
||||
public final class LingxingProductSearchBody { |
||||
|
||||
private LingxingProductSearchBody() { |
||||
} |
||||
|
||||
/** |
||||
* camelCase 形态:searchField / searchSingleValue / searchValues。 |
||||
* |
||||
* <p>用于 Temu、SHEIN、TikTok、AliExpress、沃尔玛、eBay。</p> |
||||
*/ |
||||
public static void camelCase(java.util.Map<String, Object> body, ProductQuery query, Object fieldValue) { |
||||
if (query == null || !query.hasSearch()) { |
||||
return; |
||||
} |
||||
body.put("searchField", fieldValue); |
||||
applyValue(body, query, "searchSingleValue", "searchValues"); |
||||
} |
||||
|
||||
/** |
||||
* snake_case 形态:search_field / search_single_value / search_values。 |
||||
* |
||||
* <p>用于 Shopify、Target。</p> |
||||
*/ |
||||
public static void snakeCase(java.util.Map<String, Object> body, ProductQuery query, Object fieldValue) { |
||||
if (query == null || !query.hasSearch()) { |
||||
return; |
||||
} |
||||
body.put("search_field", fieldValue); |
||||
applyValue(body, query, "search_single_value", "search_values"); |
||||
} |
||||
|
||||
/** |
||||
* 亚马逊 SC 形态:search_field(字符串)+ search_value(数组)+ exact_search。 |
||||
* |
||||
* <p>单值模糊时转成单元素数组并设 {@code exact_search=0}; |
||||
* 多值时设 {@code exact_search=1}。</p> |
||||
*/ |
||||
public static void amazonSc(java.util.Map<String, Object> body, ProductQuery query, Object fieldValue) { |
||||
if (query == null || !query.hasSearch()) { |
||||
return; |
||||
} |
||||
body.put("search_field", fieldValue); |
||||
List<String> values = query.searchValues(); |
||||
if (values.isEmpty()) { |
||||
body.put("search_value", java.util.Collections.singletonList(query.searchValue())); |
||||
body.put("exact_search", 0); |
||||
} else { |
||||
body.put("search_value", values); |
||||
body.put("exact_search", 1); |
||||
} |
||||
} |
||||
|
||||
/** 单值模糊与多值精确二选一,已在 ProductQuery 构造时校验。 */ |
||||
private static void applyValue(java.util.Map<String, Object> body, ProductQuery query, |
||||
String singleKey, String multiKey) { |
||||
List<String> values = query.searchValues(); |
||||
if (values.isEmpty()) { |
||||
body.put(singleKey, query.searchValue()); |
||||
} else { |
||||
body.put(multiKey, values); |
||||
} |
||||
} |
||||
} |
||||
@ -0,0 +1,81 @@
@@ -0,0 +1,81 @@
|
||||
package common.ecommerce.lingxing.platform.multiplatform.product; |
||||
|
||||
import common.ecommerce.model.product.ProductSearchField; |
||||
|
||||
/** |
||||
* 领星侧各平台的「搜索维度 → 平台枚举值」映射。 |
||||
* |
||||
* <p>同一个语义在不同平台下的取值完全不同:</p> |
||||
* <pre> |
||||
* 平台 SKU 本地 SKU |
||||
* 沃尔玛 1 3 |
||||
* eBay 1 3 |
||||
* AliExpress 1 5 ← 实测:文档写 3,但 3 查不到 |
||||
* Temu 9 8 |
||||
* SHEIN 9 8 |
||||
* TikTok 9 8 |
||||
* Shopify/Target 1 待核对(样本 local_sku 为空) |
||||
* 亚马逊 SC "seller_sku" "sku" ← 字符串,不是数字 |
||||
* 亚马逊 VC 不支持搜索 |
||||
* </pre> |
||||
* |
||||
* <p>取值来源:领星文档(2026-10 摘录)+ AliExpress 实测(2026-11)。 |
||||
* 未实测的平台按文档写,联调时用 {@code SearchFieldProbeTest} 逐个核对。</p> |
||||
* |
||||
* <p>用「按平台命名的方法」而不是「按 platform_code 查表」:每个 Source 只服务一个平台, |
||||
* 直接调自己那一个方法即可;AliExpress 的 platform_code 尚未确认,也不影响调用。 |
||||
* 返回值类型不统一(数字 / 字符串),由各 Source 直接塞进请求体。</p> |
||||
*/ |
||||
public final class LingxingProductSearchMapper { |
||||
|
||||
private LingxingProductSearchMapper() { |
||||
} |
||||
|
||||
/** 沃尔玛:1 = MSKU,3 = SKU。 */ |
||||
public static Object walmart(ProductSearchField field) { |
||||
return field == ProductSearchField.PLATFORM_SKU ? 1 : 3; |
||||
} |
||||
|
||||
/** eBay:1 = msku,3 = sku。 */ |
||||
public static Object ebay(ProductSearchField field) { |
||||
return field == ProductSearchField.PLATFORM_SKU ? 1 : 3; |
||||
} |
||||
|
||||
/** AliExpress:1 = msku,5 = 本地 SKU(实测;文档写 3 但查不到)。 */ |
||||
public static Object aliexpress(ProductSearchField field) { |
||||
return field == ProductSearchField.PLATFORM_SKU ? 1 : 5; |
||||
} |
||||
|
||||
/** Temu:9 = MSKU,8 = SKU。 */ |
||||
public static Object temu(ProductSearchField field) { |
||||
return field == ProductSearchField.PLATFORM_SKU ? 9 : 8; |
||||
} |
||||
|
||||
/** SHEIN:9 = MSKU,8 = SKU。 */ |
||||
public static Object shein(ProductSearchField field) { |
||||
return field == ProductSearchField.PLATFORM_SKU ? 9 : 8; |
||||
} |
||||
|
||||
/** TikTok:9 = MSKU,8 = SKU。 */ |
||||
public static Object tiktok(ProductSearchField field) { |
||||
return field == ProductSearchField.PLATFORM_SKU ? 9 : 8; |
||||
} |
||||
|
||||
/** |
||||
* Shopify / Target:1 = msku。 |
||||
* |
||||
* <p>本地 SKU 的编码文档未给出,实测样本 {@code local_sku} 也为空, |
||||
* 暂时返回 null 表示不支持;联调时用探针确认后再补。</p> |
||||
*/ |
||||
public static Object shopify(ProductSearchField field) { |
||||
if (field == ProductSearchField.PLATFORM_SKU) { |
||||
return 1; |
||||
} |
||||
throw new UnsupportedOperationException("shopify/target listing does not support local sku search yet"); |
||||
} |
||||
|
||||
/** 亚马逊 SC:字符串 "seller_sku" / "sku"。 */ |
||||
public static Object amazonSc(ProductSearchField field) { |
||||
return field == ProductSearchField.PLATFORM_SKU ? "seller_sku" : "sku"; |
||||
} |
||||
} |
||||
Loading…
Reference in new issue