package common.ecommerce.hengjian.adapter; import com.fasterxml.jackson.databind.JsonNode; import common.ecommerce.hengjian.HengjianConstants; import common.ecommerce.hengjian.dto.HengjianCarrierGroupDtos; import common.ecommerce.hengjian.dto.HengjianProductSaveDtos; import common.ecommerce.hengjian.dto.HengjianWarehouseDtos; import common.ecommerce.hengjian.http.HengjianEnvelope; import common.ecommerce.hengjian.http.HengjianRateLimiter; import common.ecommerce.hengjian.http.HengjianRequestFactory; import common.ecommerce.http.HttpRequest; import common.ecommerce.http.HttpResponse; import common.ecommerce.http.HttpTransport; import common.ecommerce.http.JacksonJsonCodec; import common.ecommerce.warehouse.capability.LogisticsProductCapable; import common.ecommerce.warehouse.capability.WarehouseDirectoryCapable; import common.ecommerce.warehouse.capability.WarehouseProduct; import common.ecommerce.warehouse.capability.WarehouseProductCapable; import common.ecommerce.warehouse.enums.WarehouseCapability; import common.ecommerce.warehouse.enums.WarehouseProvider; import common.ecommerce.warehouse.error.WarehouseException; import common.ecommerce.warehouse.model.LogisticsProduct; import common.ecommerce.warehouse.model.WarehouseFacility; import common.ecommerce.warehouse.sdk.WarehouseContext; import java.util.ArrayList; import java.util.EnumSet; import java.util.Iterator; import java.util.LinkedHashMap; import java.util.List; import java.util.Map; /** * 恒健适配器。 * *
已接入:仓库目录、承运商 / 物流产品、按仓的物流渠道(只读), * 以及商品创建 / 编辑({@code /v1/product/save},保存语义)。
* *出库 / 库存 / 入库 / 退货等接口尚未接入,能力位不声明: * 门面调用会显式抛 {@code WarehouseUnsupportedCapabilityException},不返回空集合。
* *适配器只持有协议与基础设施,不持有端点与凭据——两者随每次调用经 * {@code WarehouseConnection} 传入。
*/ public final class HengjianAdapter implements WarehouseDirectoryCapable, LogisticsProductCapable, WarehouseProductCapable { private static final String OP_WAREHOUSE_LIST = "warehouse.directory.warehouses"; private static final String OP_CARRIERS = "warehouse.directory.carriers"; private static final String OP_LOGISTICS_PRODUCTS = "warehouse.logistics.products"; private static final String OP_PRODUCT_SAVE = "warehouse.product.create"; /** 保存语义没有 create / update 之分,仓方也不回是哪种。 */ private static final String SAVED = "SAVED"; private final HttpTransport transport; private final JacksonJsonCodec json; private final HengjianRequestFactory requestFactory; private final HengjianRateLimiter rateLimiter; public HengjianAdapter(HttpTransport transport, JacksonJsonCodec json) { this.transport = transport; this.json = json; this.requestFactory = new HengjianRequestFactory(json); this.rateLimiter = new HengjianRateLimiter(); } @Override public String adapterId() { return HengjianConstants.ADAPTER_ID; } @Override public WarehouseProvider provider() { return WarehouseProvider.HENGJIAN; } @Override public EnumSet接口是保存语义:同一 SKU 再调即更新,所以不区分 create 与 update, * 也不像信仓那样先查一次再决定调哪个接口。
* *响应只有 {@code code / message},没有 data,因此结果里的 * {@code status} 固定为 {@code SAVED}、{@code rawStatus} 取仓方的 message—— * 仓方并不告诉我们这次是新建还是更新,不能替它编。
* * @throws IllegalArgumentException 恒健要求但统一模型未给的非空字段缺失(本地拒绝) */ @Override public ProductResult createOrUpdate(WarehouseContext ctx, WarehouseProduct product) { HengjianProductSaveDtos.SaveProductRequest body = HengjianProductMapper.toRequest(product); String raw = execute(ctx, HengjianConstants.PATH_PRODUCT_SAVE, body, OP_PRODUCT_SAVE); return ProductResult.of(body.sku, SAVED, json.stringAt(raw, "message")); } // ------------------------------------------------------------------ 仓库目录 /** * 当前组织下的全部仓库({@code POST /v2/warehouse/getWarehouse},无参数)。 * *返回的 {@code warehouseCode} 可直接用于下单、库存查询等接口。
*/ @Override public List返回物流产品代码(如 {@code UPS2DAM_HL}),可直接作为下单的 {@code carrierCode}。 * 按出现顺序去重。
*/ @Override public List恒健这个接口没有仓维度,拿到的是组织级清单;{@code warehouseCode} * 仅用于写进结果字段,便于调用方区分来源。需要「某仓支持哪些渠道」用 * {@link #productsOfWarehouse}。
*/ @Override public List返回形状与 {@link #products} 不同:{@code data} 是以仓代码为键的对象, * 不是数组;只取请求的那个仓,混进别的仓的渠道会让「仓不支持该渠道」 * 变成仓方报错。
*/ public List