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