You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
203 lines
7.7 KiB
203 lines
7.7 KiB
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; |
|
|
|
/** |
|
* 假仓适配器:只实现出库能力,用于验证门面抽象、幂等与能力检查。 |
|
* |
|
* <pre> |
|
* FakeWarehouseAdapter adapter = new FakeWarehouseAdapter(); |
|
* </pre> |
|
*/ |
|
public final class FakeWarehouseAdapter implements OutboundCapable { |
|
|
|
private final Map<String, OutboundOrder> orders = new LinkedHashMap<String, OutboundOrder>(); |
|
private final List<String> createCalls = new ArrayList<String>(); |
|
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) |
|
.accountId("acc-" + warehouseCode) |
|
.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<WarehouseCapability> 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<OutboundOrder> query(WarehouseContext ctx, OutboundQuery query) { |
|
return Page.last(new ArrayList<OutboundOrder>(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<PackageResult> 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<String> createCalls() { |
|
return Collections.unmodifiableList(createCalls); |
|
} |
|
}
|
|
|