diff --git a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/BarcodePrintCapable.java b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/BarcodePrintCapable.java new file mode 100644 index 0000000..dd9c006 --- /dev/null +++ b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/capability/BarcodePrintCapable.java @@ -0,0 +1,27 @@ +package common.ecommerce.warehouse.capability; + +import common.ecommerce.warehouse.model.BarcodePrintCommand; +import common.ecommerce.warehouse.model.WarehouseLabel; +import common.ecommerce.warehouse.sdk.WarehouseAdapter; +import common.ecommerce.warehouse.sdk.WarehouseContext; + +/** + * 商品条码打印能力:按 SKU 打条码贴纸,不依赖任何单据。 + * + *

与 {@link InboundCapable#printSkuLabel} 不是一回事:那个是入库计划单的贴标 + * (绑定入库单号、有 14 种小纸尺寸、仓方异步生成);这个是按 SKU 打条码, + * 仓库 / 门店自己贴标用,仓方同步返回文件地址。

+ * + *

只读语义(不改业务状态),但会生成文件;重复调用只是再生成一份。

+ */ +public interface BarcodePrintCapable extends WarehouseAdapter { + + /** + * 打印 SKU 条码。 + * + * @return 已生成的文件(地址或 base64);仓方未返回文件时抛出异常,不返回 null + * @throws common.ecommerce.warehouse.error.WarehouseUnsupportedCapabilityException + * 该仓不声明 {@code BARCODE_PRINT} + */ + WarehouseLabel printBarcodes(WarehouseContext ctx, BarcodePrintCommand cmd); +} diff --git a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/BarcodePaperSize.java b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/BarcodePaperSize.java new file mode 100644 index 0000000..261d8cc --- /dev/null +++ b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/BarcodePaperSize.java @@ -0,0 +1,37 @@ +package common.ecommerce.warehouse.enums; + +/** + * SKU 条码打印的纸张尺寸。 + * + *

易达云 {@code printBarcode} 的 {@code pageSize}:0 7×3cm / 1 10×6cm / + * 2 6×4cm / 3 A4。只有这 4 档,与入库贴标用的 + * {@link SkuLabelSizeType}(14 种小尺寸)不是一套,不能互换。

+ */ +public enum BarcodePaperSize { + + /** 0:70mm × 30mm。 */ + SIZE_70_30(0, "7×3cm"), + /** 1:100mm × 60mm。 */ + SIZE_100_60(1, "10×6cm"), + /** 2:60mm × 40mm。 */ + SIZE_60_40(2, "6×4cm"), + /** 3:A4。 */ + A4(3, "A4"); + + private final int code; + private final String label; + + BarcodePaperSize(int code, String label) { + this.code = code; + this.label = label; + } + + /** 仓方码值。 */ + public int code() { + return code; + } + + public String label() { + return label; + } +} diff --git a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/WarehouseCapability.java b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/WarehouseCapability.java index 21fdec7..078e7e7 100644 --- a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/WarehouseCapability.java +++ b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/enums/WarehouseCapability.java @@ -57,7 +57,9 @@ public enum WarehouseCapability { /** 最优渠道推荐(按 SKU + 邮编由仓择优) */ CHANNEL_RECOMMEND(240, "最优渠道推荐"), /** 物流异动单:召回 / 换址 / 在途异常(对已交运的运单发起处理) */ - TRACKING_CHANGE(250, "物流异动单"); + TRACKING_CHANGE(250, "物流异动单"), + /** 商品条码打印(不依赖单据,按 SKU 打条码) */ + BARCODE_PRINT(260, "商品条码打印"); private final int code; private final String label; diff --git a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/BarcodePrintCommand.java b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/BarcodePrintCommand.java new file mode 100644 index 0000000..8b40386 --- /dev/null +++ b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/model/BarcodePrintCommand.java @@ -0,0 +1,126 @@ +package common.ecommerce.warehouse.model; + +import common.ecommerce.warehouse.enums.BarcodePaperSize; + +import java.util.ArrayList; +import java.util.Collections; +import java.util.List; + +/** + * SKU 条码打印命令(打商品条码,不是入库单的 SKU 贴标)。 + * + *

与 {@link SkuLabelCommand} 的区别:那个是入库计划单的贴标(绑定 + * 入库单号、14 种小纸尺寸);这个是按 SKU 打条码,不依赖任何单据, + * 仓库 / 门店自己贴标用。

+ * + *

仓方同步返回文件地址(不是异步任务),所以返回的是 + * {@link WarehouseLabel} 而不是 {@link LabelPrintTask}。

+ */ +public final class BarcodePrintCommand { + + /** 一次最多打多少种 SKU。 */ + public static final int MAX_SKUS = 50; + + private final BarcodePaperSize paperSize; + /** 备注,如 {@code Made in China}。 */ + private final String remark; + /** 是否打印 SKU 名称。 */ + private final boolean printSkuName; + private final List items; + + private BarcodePrintCommand(Builder b) { + if (b.paperSize == null) { + throw new IllegalArgumentException("paperSize is required"); + } + this.paperSize = b.paperSize; + this.remark = b.remark; + this.printSkuName = b.printSkuName; + if (b.items.isEmpty()) { + throw new IllegalArgumentException("items must not be empty"); + } + if (b.items.size() > MAX_SKUS) { + throw new IllegalArgumentException( + "at most " + MAX_SKUS + " skus per print, got " + b.items.size()); + } + this.items = Collections.unmodifiableList(new ArrayList(b.items)); + } + + public static Builder builder() { + return new Builder(); + } + + public BarcodePaperSize paperSize() { + return paperSize; + } + + /** 备注;null 表示不打印。 */ + public String remark() { + return remark; + } + + /** 是否打印 SKU 名称。 */ + public boolean printSkuName() { + return printSkuName; + } + + public List items() { + return items; + } + + /** 一个 SKU 及其打印份数。 */ + public static final class BarcodeItem { + + private final String providerSku; + private final int copies; + + public BarcodeItem(String providerSku, int copies) { + if (providerSku == null || providerSku.trim().isEmpty()) { + throw new IllegalArgumentException("providerSku must not be blank"); + } + if (copies <= 0) { + throw new IllegalArgumentException("copies must be positive"); + } + this.providerSku = providerSku.trim(); + this.copies = copies; + } + + public String providerSku() { + return providerSku; + } + + public int copies() { + return copies; + } + } + + public static final class Builder { + private BarcodePaperSize paperSize; + private String remark; + private boolean printSkuName; + private final List items = new ArrayList(); + + public Builder paperSize(BarcodePaperSize v) { + this.paperSize = v; + return this; + } + + public Builder remark(String v) { + this.remark = v; + return this; + } + + public Builder printSkuName(boolean v) { + this.printSkuName = v; + return this; + } + + public Builder item(String providerSku, int copies) { + this.items.add(new BarcodeItem(providerSku, copies)); + return this; + } + + public BarcodePrintCommand build() { + return new BarcodePrintCommand(this); + } + } +} diff --git a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/sdk/WarehouseOperations.java b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/sdk/WarehouseOperations.java index c5d803b..e3534eb 100644 --- a/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/sdk/WarehouseOperations.java +++ b/warehouse-sdk-core/src/main/java/common/ecommerce/warehouse/sdk/WarehouseOperations.java @@ -4,6 +4,7 @@ import common.ecommerce.shared.audit.CallObserver; import common.ecommerce.shared.audit.CallSupport; import common.ecommerce.shared.idempotency.IdempotencyGuard; import common.ecommerce.shared.support.Page; +import common.ecommerce.warehouse.capability.BarcodePrintCapable; import common.ecommerce.warehouse.capability.BolCapable; import common.ecommerce.warehouse.capability.DestructionCapable; import common.ecommerce.warehouse.capability.InboundCapable; @@ -24,6 +25,7 @@ import common.ecommerce.warehouse.enums.InventorySyncStrategy; import common.ecommerce.warehouse.enums.WarehouseCapability; import common.ecommerce.warehouse.enums.WarehouseProvider; import common.ecommerce.warehouse.error.WarehouseUnsupportedCapabilityException; +import common.ecommerce.warehouse.model.BarcodePrintCommand; import common.ecommerce.warehouse.model.BillingDocument; import common.ecommerce.warehouse.model.BoxLabelCommand; import common.ecommerce.warehouse.model.ChannelRecommendQuery; @@ -48,6 +50,7 @@ import common.ecommerce.warehouse.model.TrackEvent; import common.ecommerce.warehouse.model.TrackingInfo; import common.ecommerce.warehouse.model.TransferCommand; import common.ecommerce.warehouse.model.TransferOrder; +import common.ecommerce.warehouse.model.WarehouseLabel; import common.ecommerce.warehouse.model.WarehouseReturn; import common.ecommerce.warehouse.spi.WarehouseAccount; @@ -340,6 +343,21 @@ public final class WarehouseOperations { () -> ((BolCapable) adapter).orderBols(ctx, providerOrderNo)); } + /** + * 打印 SKU 条码(不依赖单据)。 + * + *

与 {@code inbound().printSkuLabel()} 不同:那个绑定入库计划单, + * 这个只按 SKU 打。仓方同步返回文件地址,所以不走幂等守卫—— + * 重复调用只是再生成一份,不改业务状态。

+ */ + public WarehouseLabel printBarcodes(BarcodePrintCommand cmd) { + require(WarehouseCapability.BARCODE_PRINT, BarcodePrintCapable.class); + return CallSupport.observe(observer, ctx, "warehouse.barcode.print", + CallSupport.params("paperSize", cmd.paperSize(), + "skuCount", cmd.items().size()), + r -> CallSupport.NO_COUNT, + () -> ((BarcodePrintCapable) adapter).printBarcodes(ctx, cmd)); + } /** 费用视图。 */ public FeeView fees() { diff --git a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunAdapter.java b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunAdapter.java index 8c705dc..807e543 100644 --- a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunAdapter.java +++ b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunAdapter.java @@ -3,6 +3,7 @@ package common.ecommerce.edayun.adapter; import common.ecommerce.edayun.EdayunConstants; import common.ecommerce.edayun.auth.EdayunTokenClient; import common.ecommerce.edayun.dto.EdayunAccountFlowDtos; +import common.ecommerce.edayun.dto.EdayunBarcodeDtos; import common.ecommerce.edayun.dto.EdayunBolDtos; import common.ecommerce.edayun.dto.EdayunCancelDtos; import common.ecommerce.edayun.dto.EdayunCancelReturnDtos; @@ -33,6 +34,7 @@ import common.ecommerce.shared.spi.ChannelSecret; import common.ecommerce.shared.spi.LockProvider; import common.ecommerce.shared.spi.TokenStore; import common.ecommerce.shared.support.Page; +import common.ecommerce.warehouse.capability.BarcodePrintCapable; import common.ecommerce.warehouse.capability.BolCapable; import common.ecommerce.warehouse.capability.InboundCapable; import common.ecommerce.warehouse.capability.InventoryCapable; @@ -51,6 +53,7 @@ import common.ecommerce.warehouse.enums.WarehouseCapability; import common.ecommerce.warehouse.enums.WarehouseProvider; import common.ecommerce.warehouse.error.WarehouseException; import common.ecommerce.warehouse.error.WarehouseUnsupportedCapabilityException; +import common.ecommerce.warehouse.model.BarcodePrintCommand; import common.ecommerce.warehouse.model.BillingDocument; import common.ecommerce.warehouse.model.BolDocument; import common.ecommerce.warehouse.model.CancelCommand; @@ -75,6 +78,7 @@ import common.ecommerce.warehouse.model.ReturnProcessCommand; import common.ecommerce.warehouse.model.ReturnQuery; import common.ecommerce.warehouse.model.TrackEvent; import common.ecommerce.warehouse.model.TrackingInfo; +import common.ecommerce.warehouse.model.WarehouseLabel; import common.ecommerce.warehouse.model.WarehouseReturn; import common.ecommerce.warehouse.sdk.WarehouseAdapter; import common.ecommerce.warehouse.sdk.WarehouseContext; @@ -95,7 +99,8 @@ import java.util.List; */ public final class EdayunAdapter implements WarehouseAdapter, WarehouseProductCapable, OutboundCapable, WarehouseFeeCapable, WarehouseFeeEstimateCapable, InventoryCapable, - InboundCapable, WarehouseReturnCapable, BolCapable, LogisticsProductCapable, TrackingCapable { + InboundCapable, WarehouseReturnCapable, BolCapable, LogisticsProductCapable, + TrackingCapable, BarcodePrintCapable { /** 物流产品查询的适用业务:1 店铺订单(默认口径)。 */ private static final int APPLICABLE_BUSINESS_STORE_ORDER = 1; @@ -152,7 +157,8 @@ public final class EdayunAdapter implements WarehouseAdapter, WarehouseProductCa WarehouseCapability.FEE_SETTLEMENT, WarehouseCapability.FEE_ESTIMATE, WarehouseCapability.INVENTORY_QUERY, WarehouseCapability.INBOUND, WarehouseCapability.RETURN, WarehouseCapability.BOL, - WarehouseCapability.LOGISTICS_PRODUCT, WarehouseCapability.TRACKING); + WarehouseCapability.LOGISTICS_PRODUCT, WarehouseCapability.TRACKING, + WarehouseCapability.BARCODE_PRINT); } /** @@ -963,6 +969,45 @@ public final class EdayunAdapter implements WarehouseAdapter, WarehouseProductCa return msg != null && (msg.contains("未匹配到轨迹") || msg.contains("跟踪号为空")); } + // ------------------------------------------------------------------ 条码打印 + + /** + * 打印 SKU 条码({@code POST /webApi/skuInfo/v2/printBarcode})。 + * + *

与入库贴标({@code inbound().printSkuLabel})不同:这个只按 SKU 打, + * 不绑单据,且仓方同步返回 PDF 地址。

+ * + *

真机实测的仓方校验:{@code productInfos} 为空报「产品信息不能为空」, + * 缺 {@code pageSize} 报「纸张尺寸不能为空」,{@code pageSize} 非 0~3 报 + * 「内部服务器错误」,{@code num=0} 同样「内部服务器错误」,超过 50 个 SKU + * 报「最多打印50个SKU」。本地已提前挡住后两者。

+ */ + @Override + public WarehouseLabel printBarcodes(WarehouseContext ctx, BarcodePrintCommand cmd) { + EdayunBarcodeDtos.PrintBarcodeRequest body = EdayunBarcodeMapper.toRequest(cmd); + String bodyJson = json.toJson(body); + + HttpResponse resp = send(ctx, EdayunConstants.PATH_BARCODE_PRINT, bodyJson, + "warehouse.barcode.print"); + EdayunBarcodeDtos.PrintBarcodeResponse parsed = + json.fromJson(resp.body(), EdayunBarcodeDtos.PrintBarcodeResponse.class); + requireSuccess(ctx, parsed == null ? null : parsed.code, + parsed == null ? null : parsed.msg, resp, "warehouse.barcode.print"); + + if (parsed.data == null || parsed.data.trim().isEmpty()) { + throw WarehouseException.builder() + .message("edayun printBarcode returned no file url") + .operation("warehouse.barcode.print") + .warehouseCode(ctx.warehouseCode()) + .provider(provider().name()) + .requestId(ctx.requestId()) + .rawResponse(safeRelay(resp.body())) + .retryable(false) + .build(); + } + return EdayunBarcodeMapper.toLabel(parsed.data.trim(), cmd); + } + // ------------------------------------------------------------------ internals /** 发业务请求(自动取 token、算签名)。 */ private HttpResponse send(WarehouseContext ctx, String path, String bodyJson, String operation) { diff --git a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunBarcodeMapper.java b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunBarcodeMapper.java new file mode 100644 index 0000000..6d395ab --- /dev/null +++ b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/adapter/EdayunBarcodeMapper.java @@ -0,0 +1,70 @@ +package common.ecommerce.edayun.adapter; + +import common.ecommerce.edayun.dto.EdayunBarcodeDtos; +import common.ecommerce.warehouse.model.BarcodePrintCommand; +import common.ecommerce.warehouse.model.WarehouseLabel; + +import java.util.ArrayList; +import java.util.List; + +/** + * 易达云条码打印映射({@code POST /webApi/skuInfo/v2/printBarcode})。 + * + *

响应 {@code data} 是文件地址字符串——同步生成,不像入库箱标那样只有任务号。

+ */ +public final class EdayunBarcodeMapper { + + /** 单次最多打印的 SKU 数(文档:最大 50 个)。 */ + static final int MAX_SKUS = 50; + + private EdayunBarcodeMapper() { + } + + /** + * 统一命令 → 打印请求。 + * + * @throws IllegalArgumentException SKU 数超限(本地先挡,省一次失败请求) + */ + public static EdayunBarcodeDtos.PrintBarcodeRequest toRequest(BarcodePrintCommand cmd) { + EdayunBarcodeDtos.PrintBarcodeRequest req = new EdayunBarcodeDtos.PrintBarcodeRequest(); + req.pageSize = cmd.paperSize().code(); + req.remark = cmd.remark(); + // 只有 true 才下发:false 是仓方默认,不下发省得干扰它自己的默认值 + req.isPrintSkuName = cmd.printSkuName() ? Boolean.TRUE : null; + req.productInfos = toItems(cmd.items()); + return req; + } + + private static List toItems( + List items) { + if (items.size() > MAX_SKUS) { + throw new IllegalArgumentException( + "edayun prints at most " + MAX_SKUS + " skus at once, got " + items.size() + + "; split into multiple calls"); + } + List out = + new ArrayList(items.size()); + for (BarcodePrintCommand.BarcodeItem item : items) { + EdayunBarcodeDtos.ProductInfo info = new EdayunBarcodeDtos.ProductInfo(); + info.skuCode = item.providerSku(); + info.num = item.copies(); + out.add(info); + } + return out; + } + + /** + * 响应 → 面单对象。 + * + *

文件地址可能为空——仓方生成失败时仍可能回 {@code code=200}。调用方应在 + * 调用前确认 {@code data} 非空,适配器已做该检查。

+ */ + public static WarehouseLabel toLabel(String fileUrl, BarcodePrintCommand cmd) { + return WarehouseLabel.builder() + // 仓库不返回文件 id,用 SKU 数 + 纸张尺寸拼一个可追溯的编号 + .labelId("barcode-" + cmd.paperSize().name() + "-" + cmd.items().size()) + .format("PDF") + .url(fileUrl) + .build(); + } +} diff --git a/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunBarcodeDtos.java b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunBarcodeDtos.java new file mode 100644 index 0000000..ea7ab16 --- /dev/null +++ b/warehouse-sdk-edayun/src/main/java/common/ecommerce/edayun/dto/EdayunBarcodeDtos.java @@ -0,0 +1,52 @@ +package common.ecommerce.edayun.dto; + +import com.fasterxml.jackson.annotation.JsonInclude; + +import java.util.List; + +/** + * 易达云报文结构:打印条码({@code POST /webApi/skuInfo/v2/printBarcode})。 + * + *

一个文件对应一个接口。响应 {@code data} 是文件地址字符串, + * 不是对象——与入库箱标那种「异步任务号」不同,这里同步给文件。

+ */ +public final class EdayunBarcodeDtos { + + private EdayunBarcodeDtos() { + } + + /** 打印请求。 */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public static final class PrintBarcodeRequest { + + /** 备注,如 {@code Made in China};≤64。 */ + public String remark; + /** 是否打印 SKU 名称。 */ + public Boolean isPrintSkuName; + + /** 纸张尺寸:0 7×3cm / 1 10×6cm / 2 6×4cm / 3 A4。必填。 */ + public Integer pageSize; + + /** 产品信息,最大 50 个 SKU。必填。 */ + public List productInfos; + } + + /** 一个 SKU。 */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public static final class ProductInfo { + public String skuCode; + /** 打印份数;必须 > 0。 */ + public Integer num; + } + + /** 打印响应。 */ + @JsonInclude(JsonInclude.Include.NON_NULL) + public static final class PrintBarcodeResponse { + public Integer code; + public String msg; + /** 条码文件地址(PDF)。 */ + public String data; + /** 文档标为 object,实际是字符串 {@code "null"};保留 Object 避免解析失败。 */ + public Object traceId; + } +} diff --git a/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/adapter/EdayunBarcodeTest.java b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/adapter/EdayunBarcodeTest.java new file mode 100644 index 0000000..4eea93a --- /dev/null +++ b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/adapter/EdayunBarcodeTest.java @@ -0,0 +1,166 @@ +package common.ecommerce.edayun.adapter; + +import common.ecommerce.edayun.dto.EdayunBarcodeDtos; +import common.ecommerce.http.JacksonJsonCodec; +import common.ecommerce.shared.spi.ChannelSecret; +import common.ecommerce.shared.testkit.RecordingTransport; +import common.ecommerce.shared.testkit.Responses; +import common.ecommerce.warehouse.enums.BarcodePaperSize; +import common.ecommerce.warehouse.enums.WarehouseProvider; +import common.ecommerce.warehouse.model.BarcodePrintCommand; +import common.ecommerce.warehouse.model.WarehouseLabel; +import common.ecommerce.warehouse.sdk.WarehouseConnection; +import common.ecommerce.warehouse.sdk.WarehouseContext; +import org.junit.jupiter.api.Test; + +import java.time.Clock; +import java.time.Instant; +import java.time.ZoneOffset; + +import static org.junit.jupiter.api.Assertions.assertEquals; +import static org.junit.jupiter.api.Assertions.assertNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * 打印条码({@code /webApi/skuInfo/v2/printBarcode})映射。 + * + *

重点:响应 data 是文件地址、同步返回(不是任务号)、50 个 SKU 上限。

+ */ +class EdayunBarcodeTest { + + private static final Clock CLOCK = Clock.fixed(Instant.parse("2026-11-16T00:00:00Z"), ZoneOffset.UTC); + + private static WarehouseContext ctx() { + return WarehouseContext.of("EDY-WH", WarehouseProvider.EDAYUN, "2", + WarehouseConnection.of("https://test.example/openapi", + ChannelSecret.builder().appKey("k").appSecret("s") + .clientId("c").clientSecret("cs").build()), + "req-barcode", CLOCK); + } + + private static RecordingTransport stub(String body) { + return RecordingTransport.create() + .route(common.ecommerce.edayun.EdayunConstants.PATH_TOKEN, req -> Responses.ok( + "{\"access_token\":\"T1\",\"token_type\":\"bearer\"}")) + .route(common.ecommerce.edayun.EdayunConstants.PATH_BARCODE_PRINT, + req -> Responses.ok(body)); + } + + private static BarcodePrintCommand command() { + return BarcodePrintCommand.builder() + .paperSize(BarcodePaperSize.SIZE_70_30) + .remark("Made in China") + .printSkuName(false) + .item("ybtest", 2) + .build(); + } + + // ------------------------------------------------------------ 请求 + + @Test + void mapsRequest() { + EdayunBarcodeDtos.PrintBarcodeRequest req = EdayunBarcodeMapper.toRequest(command()); + + assertEquals(Integer.valueOf(0), req.pageSize); + assertEquals("Made in China", req.remark); + assertEquals(1, req.productInfos.size()); + assertEquals("ybtest", req.productInfos.get(0).skuCode); + assertEquals(Integer.valueOf(2), req.productInfos.get(0).num); + } + + /** isPrintSkuName 只在 true 时下发,false 交给仓方默认。 */ + @Test + void printSkuNameOnlySentWhenTrue() { + assertNull(EdayunBarcodeMapper.toRequest(command()).isPrintSkuName); + + BarcodePrintCommand withName = BarcodePrintCommand.builder() + .paperSize(BarcodePaperSize.A4) + .printSkuName(true) + .item("sku", 1) + .build(); + assertEquals(Boolean.TRUE, EdayunBarcodeMapper.toRequest(withName).isPrintSkuName); + } + + @Test + void paperSizesMap() { + assertEquals(0, BarcodePaperSize.SIZE_70_30.code()); + assertEquals(1, BarcodePaperSize.SIZE_100_60.code()); + assertEquals(2, BarcodePaperSize.SIZE_60_40.code()); + assertEquals(3, BarcodePaperSize.A4.code()); + } + + /** 超过 50 个 SKU 本地就挡,不发请求(仓方也会报「最多打印50个SKU」)。 */ + @Test + void moreThan50SkusRejectedLocally() { + BarcodePrintCommand.Builder b = BarcodePrintCommand.builder() + .paperSize(BarcodePaperSize.A4); + for (int i = 0; i < 51; i++) { + b.item("SKU-" + i, 1); + } + + IllegalArgumentException ex = assertThrows(IllegalArgumentException.class, + () -> EdayunBarcodeMapper.toRequest(b.build())); + + assertTrue(ex.getMessage().contains("at most 50"), ex.getMessage()); + } + + /** 空 SKU 列表与非法份数在命令构造期就被拒。 */ + @Test + void invalidCommandRejectedAtConstruction() { + assertThrows(IllegalArgumentException.class, + () -> BarcodePrintCommand.builder().paperSize(BarcodePaperSize.A4).build()); + assertThrows(IllegalArgumentException.class, + () -> BarcodePrintCommand.builder().paperSize(BarcodePaperSize.A4) + .item("sku", 0)); + assertThrows(IllegalArgumentException.class, + () -> BarcodePrintCommand.builder().paperSize(BarcodePaperSize.A4) + .item(" ", 1)); + // 缺纸张尺寸 + assertThrows(IllegalArgumentException.class, + () -> BarcodePrintCommand.builder().item("sku", 1).build()); + } + + // ------------------------------------------------------------ 响应 + + /** data 是文件地址字符串,直接落 WarehouseLabel.url。 */ + @Test + void responseDataIsFileUrl() { + RecordingTransport transport = stub("{\"code\":200,\"msg\":\"操作成功\"," + + "\"data\":\"https://oss.edayun.com/barcode1.pdf\",\"traceId\":null}"); + + WarehouseLabel label = new EdayunAdapter(transport, new JacksonJsonCodec()) + .printBarcodes(ctx(), command()); + + assertEquals("https://oss.edayun.com/barcode1.pdf", label.url()); + assertEquals("PDF", label.format()); + assertNull(label.contentBase64()); + assertTrue(transport.lastDataRequest().body().contains("\"skuCode\":\"ybtest\"")); + } + + /** code=200 但 data 为空 → 抛异常,不能返回没有文件的对象。 */ + @Test + void blankDataFails() { + RecordingTransport transport = stub( + "{\"code\":200,\"msg\":\"操作成功\",\"data\":\" \"}"); + + assertThrows(RuntimeException.class, + () -> new EdayunAdapter(transport, new JacksonJsonCodec()) + .printBarcodes(ctx(), command())); + } + + /** 仓方业务错误(如 SKU 不存在)要抛异常并带出原因。 */ + @Test + void businessErrorFails() { + RecordingTransport transport = stub( + "{\"code\":500,\"msg\":\"sku=NO-SUCH信息不存在\",\"data\":null}"); + + try { + new EdayunAdapter(transport, new JacksonJsonCodec()) + .printBarcodes(ctx(), command()); + org.junit.jupiter.api.Assertions.fail("should have thrown"); + } catch (RuntimeException e) { + assertTrue(e.getMessage().contains("SKU") || e.getMessage().contains("sku"), e.getMessage()); + } + } +} diff --git a/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/probe/EdayunBarcodeProbeTest.java b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/probe/EdayunBarcodeProbeTest.java new file mode 100644 index 0000000..9434e35 --- /dev/null +++ b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/probe/EdayunBarcodeProbeTest.java @@ -0,0 +1,104 @@ +package common.ecommerce.edayun.probe; + +import common.ecommerce.edayun.EdayunConstants; +import common.ecommerce.edayun.adapter.EdayunAdapter; +import common.ecommerce.edayun.adapter.EdayunBarcodeMapper; +import common.ecommerce.edayun.dto.EdayunBarcodeDtos; +import common.ecommerce.http.JacksonJsonCodec; +import common.ecommerce.http.OkHttpTransport; +import common.ecommerce.shared.error.ChannelException; +import common.ecommerce.shared.spi.ChannelSecret; +import common.ecommerce.warehouse.enums.BarcodePaperSize; +import common.ecommerce.warehouse.enums.WarehouseProvider; +import common.ecommerce.warehouse.model.BarcodePrintCommand; +import common.ecommerce.warehouse.model.WarehouseLabel; +import common.ecommerce.warehouse.sdk.WarehouseConnection; +import common.ecommerce.warehouse.sdk.WarehouseContext; +import org.junit.jupiter.api.Assumptions; +import org.junit.jupiter.api.Test; +import org.junit.jupiter.api.condition.EnabledIfSystemProperty; + +import java.time.Clock; +import java.util.UUID; + +/** + * 打印条码联调探针:只读(生成 PDF,不改仓侧业务数据)。 + * + *
+ * # 只看报文(不联网)
+ * mvn -pl warehouse-sdk-edayun -DfailIfNoTests=false \
+ *     -Dedayun.probe.barcode=true -Dtest=EdayunBarcodeProbeTest test
+ *
+ * # 真跑
+ * ... -Dedayun.probe.barcode=true -Dedayun.probe.call=true \
+ *     -Dedayun.probe.clientId=... -Dedayun.probe.clientSecret=... \
+ *     -Dedayun.probe.appKey=... -Dedayun.probe.appSecret=... \
+ *     [-Dedayun.probe.sku=ybtest]
+ * 
+ */ +@EnabledIfSystemProperty(named = "edayun.probe.barcode", matches = "true") +class EdayunBarcodeProbeTest { + + private static final String BASE_URL = opt("edayun.probe.baseUrl", EdayunConstants.PR_BASE_URL); + private static final String CLIENT_ID = System.getProperty("edayun.probe.clientId", ""); + private static final String CLIENT_SECRET = System.getProperty("edayun.probe.clientSecret", ""); + private static final String APP_KEY = System.getProperty("edayun.probe.appKey", ""); + private static final String APP_SECRET = System.getProperty("edayun.probe.appSecret", ""); + private static final String SKU = opt("edayun.probe.sku", "ybtest"); + private static final boolean CALL = Boolean.getBoolean("edayun.probe.call"); + + @Test + void probePrintBarcode() { + BarcodePrintCommand cmd = BarcodePrintCommand.builder() + .paperSize(BarcodePaperSize.A4) + .remark("PROBE") + .printSkuName(true) + .item(SKU, 1) + .build(); + + EdayunBarcodeDtos.PrintBarcodeRequest req = EdayunBarcodeMapper.toRequest(cmd); + String bodyJson = new JacksonJsonCodec().toJson(req); + + System.out.println("\n================ edayun / POST " + + EdayunConstants.PATH_BARCODE_PRINT + " ================"); + System.out.println("[probe] baseUrl=" + BASE_URL + " sku=" + SKU); + System.out.println("[request] " + bodyJson); + + Assumptions.assumeTrue(CALL, "dry-run:未加 -Dedayun.probe.call=true,不实际调用"); + Assumptions.assumeTrue(!CLIENT_ID.trim().isEmpty() && !CLIENT_SECRET.trim().isEmpty() + && !APP_KEY.trim().isEmpty() && !APP_SECRET.trim().isEmpty(), + "真跑需要 -Dedayun.probe.clientId / clientSecret / appKey / appSecret"); + + try { + WarehouseContext ctx = WarehouseContext.of("EDY-PROBE", WarehouseProvider.EDAYUN, null, + WarehouseConnection.of(BASE_URL, + ChannelSecret.builder() + .appKey(APP_KEY).appSecret(APP_SECRET) + .clientId(CLIENT_ID).clientSecret(CLIENT_SECRET) + .build()), + "probe-" + UUID.randomUUID(), Clock.systemUTC()); + EdayunAdapter adapter = new EdayunAdapter( + new OkHttpTransport("common-ecommerce/1.0.0 (edayun-probe)", 10_000, 60_000), + new JacksonJsonCodec()); + + WarehouseLabel label = adapter.printBarcodes(ctx, cmd); + System.out.println("[OK] labelId=" + label.labelId() + " format=" + label.format() + + " url=" + label.url()); + } catch (RuntimeException e) { + String msg = e.getMessage() == null ? e.getClass().getSimpleName() : e.getMessage(); + System.out.println("[ERROR] " + e.getClass().getSimpleName() + ": " + + (msg.length() <= 800 ? msg : msg.substring(0, 800) + "…")); + if (e instanceof ChannelException) { + ChannelException ce = (ChannelException) e; + System.out.println(" platformCode=" + ce.platformCode() + + " retryable=" + ce.retryable()); + } + } + } + + private static String opt(String name, String fallback) { + String value = System.getProperty(name, ""); + String trimmed = value == null ? "" : value.trim(); + return trimmed.isEmpty() ? fallback : trimmed; + } +}