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

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);
}
}