package common.ecommerce.warehouse.testkit; import common.ecommerce.shared.spi.ChannelSecret; import common.ecommerce.shared.support.Page; import common.ecommerce.warehouse.enums.WarehouseCapability; import common.ecommerce.warehouse.enums.WarehouseProvider; import common.ecommerce.warehouse.capability.OutboundCapable; import common.ecommerce.warehouse.error.OutboundCancelBlockedException; import common.ecommerce.warehouse.error.OutboundCancelChargeRequiredException; import common.ecommerce.warehouse.error.WarehouseUnsupportedCapabilityException; import common.ecommerce.warehouse.model.CancelCommand; import common.ecommerce.warehouse.enums.CancelEligibility; import common.ecommerce.warehouse.model.CancelResult; import common.ecommerce.warehouse.model.OutboundCommand; import common.ecommerce.warehouse.model.OutboundOrder; import common.ecommerce.warehouse.model.OutboundQuery; import common.ecommerce.warehouse.model.OutboundReceipt; import common.ecommerce.warehouse.model.OutboundRef; import common.ecommerce.warehouse.enums.OutboundStatus; import common.ecommerce.warehouse.model.PackageResult; import common.ecommerce.warehouse.sdk.WarehouseAdapter; import common.ecommerce.warehouse.sdk.WarehouseConnection; import common.ecommerce.warehouse.sdk.WarehouseContext; import common.ecommerce.warehouse.spi.WarehouseAccount; import java.util.ArrayList; import java.util.Collections; import java.util.EnumSet; import java.util.LinkedHashMap; import java.util.List; import java.util.Map; /** * 假仓适配器:只实现出库能力,用于验证门面抽象、幂等与能力检查。 * *
 * FakeWarehouseAdapter adapter = new FakeWarehouseAdapter();
 * 
*/ public final class FakeWarehouseAdapter implements OutboundCapable { private final Map orders = new LinkedHashMap(); private final List createCalls = new ArrayList(); private int sequence; /** 取消费用;非 null 时 checkCancel 返回 CHARGED。 */ private String cancelFee; /** 置 true 时 checkCancel 返回 BLOCKED。 */ private boolean cancelBlocked; /** 置 true 时 create 抛可重试异常,用于验证幂等 FAILED_RETRYABLE 路径。 */ private boolean failNextCreate; public static WarehouseAccount account(String warehouseCode, WarehouseProvider provider) { return WarehouseAccount.builder() .warehouseCode(warehouseCode) .provider(provider.name()) .providerWarehouseId("WH-" + warehouseCode) .credentialRef("kms://test/fake-warehouse") .build(); } public static WarehouseConnection connection() { return WarehouseConnection.of("https://fake.warehouse.example.com", ChannelSecret.builder().appSecret("fake-token").build()); } /** 免连接测试用默认端点。 */ @Override public String defaultEndpointBaseUrl() { return "https://fake.warehouse.example.com"; } public FakeWarehouseAdapter chargeCancel(String fee) { this.cancelFee = fee; return this; } public FakeWarehouseAdapter blockCancel() { this.cancelBlocked = true; return this; } public FakeWarehouseAdapter failNextCreate() { this.failNextCreate = true; return this; } @Override public String adapterId() { return "fake-warehouse"; } @Override public WarehouseProvider provider() { return WarehouseProvider.CUSTOM; } @Override public EnumSet capabilities() { return EnumSet.of(WarehouseCapability.OUTBOUND); } @Override public OutboundReceipt create(WarehouseContext ctx, OutboundCommand cmd) { if (!capabilities().contains(WarehouseCapability.OUTBOUND)) { throw new WarehouseUnsupportedCapabilityException(WarehouseCapability.OUTBOUND); } if (failNextCreate) { failNextCreate = false; throw common.ecommerce.warehouse.error.WarehouseException.builder() .message("fake transient failure") .operation("warehouse.outbound.create") .warehouseCode(ctx.warehouseCode()) .retryable(true) .build(); } createCalls.add(cmd.outboundRequestNo()); String providerOrderId = "WH" + (++sequence); orders.put(cmd.outboundRequestNo(), OutboundOrder.builder() .warehouseCode(ctx.warehouseCode()) .outboundRequestNo(cmd.outboundRequestNo()) .providerOrderId(providerOrderId) .orderRef(cmd.orderRef()) .labelMode(cmd.labelMode()) .status(OutboundStatus.SUBMITTED) .rawStatus("SUBMITTED") .requestedAt(java.time.Instant.now(ctx.clock())) .sourceProvider(provider()) .build()); return OutboundReceipt.of(cmd.outboundRequestNo(), providerOrderId, "SUBMITTED"); } @Override public OutboundOrder get(WarehouseContext ctx, OutboundRef ref) { if (ref.outboundRequestNo() != null) { return orders.get(ref.outboundRequestNo()); } for (OutboundOrder o : orders.values()) { if (ref.providerOrderId().equals(o.providerOrderId())) { return o; } } return null; } @Override public Page query(WarehouseContext ctx, OutboundQuery query) { return Page.last(new ArrayList(orders.values())); } @Override public CancelEligibility checkCancel(WarehouseContext ctx, OutboundRef ref) { if (cancelBlocked) { return CancelEligibility.BLOCKED; } return cancelFee == null ? CancelEligibility.FREE : CancelEligibility.CHARGED; } @Override public CancelResult cancel(WarehouseContext ctx, CancelCommand cmd) { CancelEligibility eligibility = checkCancel(ctx, OutboundRef.ofRequestNo(cmd.outboundRequestNo())); if (eligibility == CancelEligibility.BLOCKED) { throw new OutboundCancelBlockedException(common.ecommerce.warehouse.error.WarehouseException.builder() .message("outbound already shipped") .operation("warehouse.outbound.cancel") .warehouseCode(ctx.warehouseCode())); } if (eligibility == CancelEligibility.CHARGED && !cmd.acceptCharge()) { throw new OutboundCancelChargeRequiredException( common.ecommerce.warehouse.error.WarehouseException.builder() .message("cancel is charged, acceptCharge required") .operation("warehouse.outbound.cancel") .warehouseCode(ctx.warehouseCode()), cancelFee, "USD"); } return CancelResult.builder() .outboundRequestNo(cmd.outboundRequestNo()) .eligibility(eligibility) .cancelled(true) .rawStatus("CANCELLED") .build(); } @Override public List packages(WarehouseContext ctx, OutboundRef ref) { return Collections.singletonList(PackageResult.builder() .packageId("PKG-1") .outboundRequestNo(ref.outboundRequestNo() == null ? "unknown" : ref.outboundRequestNo()) .trackingNumber("TRACK-1") .carrier("FAKE") .labelRef("LABEL-1") .build()); } /** 实际调用 create 的次数;验证幂等只调一次。 */ public int createCallCount() { return createCalls.size(); } public List createCalls() { return Collections.unmodifiableList(createCalls); } }