Browse Source
运去哪之前只有单元测试(RecordingTransport 打桩),没有真机验证。补一个
只读探针,默认跳过,需显式开启:
mvn -pl warehouse-sdk-yqn -DfailIfNoTests=false \
-Dyqn.probe=true -Dyqn.probe.token=<x-api-key> \
-Dyqn.probe.providerWarehouseId=RF_NY_US \
-Dtest=YqnReadOnlyProbeTest test
覆盖 7 个查询接口:
- GET /v1/warehouse/findAll 仓库目录(不依赖单号)
- GET /v2/sysCarrierGroup/getCarrierGroupList 物流产品(验 GET+query 参数)
- GET /v2/inventory/get_inventory_by_page 库存(验分页与下划线字段名)
- POST /v1/warehouse/operation/costs/detail 结算明细(需 saleOrderNo)
- POST /v1/saleOrder/findOne 出库详情(需 outboundOrderNo)
- POST /v1/inbound/getInboundPlanInfo 入库计划(需 inboundOrderNo)
- POST /v3/saleReturn/getInboundPlanInfo 退货计划(需 returnOrderNo)
- GET api/v2/orderShipment/track/{no} 轨迹(需 trackingNo)
**不碰任何写接口**:下单 / 建入库 / 建调拨 / 建退货 / 销毁都会真实创建单据,
没有测试环境,一律不跑(遵守 feedback-no-live-write-tests)。
安全:
- 凭据只走系统属性,不入库
- 输出打印 token 掩码(前 4 + 后 2),不打印完整 token
- 只打印字段摘要,不打印完整报文(可能含 PII)
异常只打印不抛出,一次跑完便于对照真实报文。全量 162 个测试通过。
Co-Authored-By: Claude <noreply@anthropic.com>
feature/supplier-lingxing
1 changed files with 297 additions and 0 deletions
@ -0,0 +1,297 @@ |
|||||||
|
package common.ecommerce.yqn.probe; |
||||||
|
|
||||||
|
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.WarehouseProvider; |
||||||
|
import common.ecommerce.warehouse.sdk.WarehouseConnection; |
||||||
|
import common.ecommerce.warehouse.sdk.WarehouseContext; |
||||||
|
import common.ecommerce.yqn.YqnConstants; |
||||||
|
import common.ecommerce.yqn.adapter.YqnAdapter; |
||||||
|
import org.junit.jupiter.api.Assumptions; |
||||||
|
import org.junit.jupiter.api.Test; |
||||||
|
import org.junit.jupiter.api.condition.EnabledIfSystemProperty; |
||||||
|
|
||||||
|
import java.time.Clock; |
||||||
|
|
||||||
|
/** |
||||||
|
* 运去哪<b>只读</b>探针:核对已对接接口的真实出入参。 |
||||||
|
* |
||||||
|
* <p>默认跳过,用 {@code -Dyqn.probe=true} 显式开启;凭据走系统属性, |
||||||
|
* <b>真实 token 不入库</b>:</p> |
||||||
|
* |
||||||
|
* <pre> |
||||||
|
* mvn -pl warehouse-sdk-yqn -DfailIfNoTests=false \ |
||||||
|
* -Dyqn.probe=true \ |
||||||
|
* -Dyqn.probe.token=你的x-api-key \ |
||||||
|
* -Dyqn.probe.warehouseCode=RF_NY_US \ |
||||||
|
* -Dtest=YqnReadOnlyProbeTest test |
||||||
|
* </pre> |
||||||
|
* |
||||||
|
* <p><b>只跑查询类接口</b>:出库 / 入库 / 调拨 / 退货 / 销毁的下单类接口会真实创建单据, |
||||||
|
* 没有测试环境,一律不碰(见 feedback-no-live-write-tests)。</p> |
||||||
|
* |
||||||
|
* <p>输出只打印字段名与取值摘要,不打印完整报文(可能含 PII)。</p> |
||||||
|
*/ |
||||||
|
@EnabledIfSystemProperty(named = "yqn.probe", matches = "true") |
||||||
|
class YqnReadOnlyProbeTest { |
||||||
|
|
||||||
|
// 真实凭据不入库:本地跑探针时用 -Dyqn.probe.token=...
|
||||||
|
private static final String TOKEN = System.getProperty("yqn.probe.token", ""); |
||||||
|
private static final String BASE_URL = opt("yqn.probe.baseUrl", YqnConstants.PR_BASE_URL); |
||||||
|
private static final String AUX_URL = opt("yqn.probe.auxBaseUrl", YqnConstants.AUX_BASE_URL_PR); |
||||||
|
private static final String WAREHOUSE_CODE = opt("yqn.probe.warehouseCode", "YQN-PROBE"); |
||||||
|
private static final String PROVIDER_WAREHOUSE = opt("yqn.probe.providerWarehouseId", ""); |
||||||
|
|
||||||
|
private static WarehouseContext ctx() { |
||||||
|
return WarehouseContext.of(WAREHOUSE_CODE, WarehouseProvider.YQN, |
||||||
|
PROVIDER_WAREHOUSE.isEmpty() ? null : PROVIDER_WAREHOUSE, |
||||||
|
WarehouseConnection.of(BASE_URL, AUX_URL, |
||||||
|
ChannelSecret.builder().appSecret(TOKEN).build()), |
||||||
|
"probe-" + System.currentTimeMillis(), Clock.systemUTC()); |
||||||
|
} |
||||||
|
|
||||||
|
private static YqnAdapter adapter() { |
||||||
|
return new YqnAdapter(new OkHttpTransport("common-ecommerce-yqn-probe"), |
||||||
|
new JacksonJsonCodec()); |
||||||
|
} |
||||||
|
|
||||||
|
/** 仓库目录:不依赖任何单号,最容易验通。 */ |
||||||
|
@Test |
||||||
|
void probeWarehouseDirectory() { |
||||||
|
assumeToken(); |
||||||
|
run("GET /v1/warehouse/findAll", () -> { |
||||||
|
java.util.List<common.ecommerce.warehouse.model.WarehouseInfo> list = |
||||||
|
adapter().warehouses(ctx()); |
||||||
|
System.out.println("[warehouses] 返回 " + list.size() + " 个仓"); |
||||||
|
for (int i = 0; i < Math.min(list.size(), 5); i++) { |
||||||
|
common.ecommerce.warehouse.model.WarehouseInfo w = list.get(i); |
||||||
|
System.out.println(" [" + i + "] code=" + w.warehouseCode() |
||||||
|
+ " name=" + w.name() |
||||||
|
+ " country=" + w.country() |
||||||
|
+ " city=" + w.city()); |
||||||
|
} |
||||||
|
}); |
||||||
|
} |
||||||
|
|
||||||
|
/** 物流产品:验证「GET 但参数写在 query」这条路是否被仓方接受。 */ |
||||||
|
@Test |
||||||
|
void probeLogisticsProducts() { |
||||||
|
assumeToken(); |
||||||
|
run("GET /v2/sysCarrierGroup/getCarrierGroupList", () -> { |
||||||
|
java.util.List<common.ecommerce.warehouse.model.LogisticsProduct> list = |
||||||
|
adapter().products(ctx(), PROVIDER_WAREHOUSE.isEmpty() ? null : PROVIDER_WAREHOUSE); |
||||||
|
System.out.println("[products] 返回 " + list.size() + " 个物流产品"); |
||||||
|
for (int i = 0; i < Math.min(list.size(), 5); i++) { |
||||||
|
common.ecommerce.warehouse.model.LogisticsProduct p = list.get(i); |
||||||
|
System.out.println(" [" + i + "] code=" + p.logisticsProductCode() |
||||||
|
+ " name=" + p.logisticsProductName() |
||||||
|
+ " crossCountry=" + p.crossCountry()); |
||||||
|
} |
||||||
|
}); |
||||||
|
} |
||||||
|
|
||||||
|
/** 库存查询:验证分页结构与字段名(下划线风格)。 */ |
||||||
|
@Test |
||||||
|
void probeInventory() { |
||||||
|
assumeToken(); |
||||||
|
run("GET /v2/inventory/get_inventory_by_page", () -> { |
||||||
|
common.ecommerce.warehouse.model.InventoryQuery query = |
||||||
|
common.ecommerce.warehouse.model.InventoryQuery.builder() |
||||||
|
.pageSize(5).build(); |
||||||
|
common.ecommerce.shared.support.Page<common.ecommerce.warehouse.model.InventorySnapshot> page = |
||||||
|
adapter().query(ctx(), query); |
||||||
|
System.out.println("[inventory] 返回 " + page.size() |
||||||
|
+ " 条, 游标=" + page.nextCursor()); |
||||||
|
for (common.ecommerce.warehouse.model.InventorySnapshot s : page.items()) { |
||||||
|
System.out.println(" sku=" + s.providerSku() |
||||||
|
+ " avail=" + s.available() |
||||||
|
+ " onHand=" + s.onHand() |
||||||
|
+ " type=" + s.inventoryType() |
||||||
|
+ " asOf=" + s.asOfUtc()); |
||||||
|
} |
||||||
|
}); |
||||||
|
} |
||||||
|
|
||||||
|
/** 结算明细:需要单号,没有就跳过。 */ |
||||||
|
@Test |
||||||
|
void probeFeeDetail() { |
||||||
|
assumeToken(); |
||||||
|
String saleOrderNo = System.getProperty("yqn.probe.saleOrderNo", ""); |
||||||
|
Assumptions.assumeTrue(!saleOrderNo.trim().isEmpty(), |
||||||
|
"未提供 -Dyqn.probe.saleOrderNo,跳过结算明细探针"); |
||||||
|
run("POST /v1/warehouse/operation/costs/detail", () -> { |
||||||
|
java.util.List<common.ecommerce.warehouse.model.BillingDocument> list = |
||||||
|
adapter().settlements(ctx(), |
||||||
|
common.ecommerce.warehouse.model.FeeQuery.builder() |
||||||
|
.saleOrderNo(saleOrderNo).build()); |
||||||
|
System.out.println("[fees] 返回 " + list.size() + " 条"); |
||||||
|
for (common.ecommerce.warehouse.model.BillingDocument d : list) { |
||||||
|
System.out.println(" name=" + d.feeName() |
||||||
|
+ " type=" + d.feeType() |
||||||
|
+ " amount=" + d.amount() |
||||||
|
+ " estimated=" + d.estimated() |
||||||
|
+ " settledAt=" + d.settledAt()); |
||||||
|
} |
||||||
|
}); |
||||||
|
} |
||||||
|
|
||||||
|
/** 出库单详情:只查,不下单。 */ |
||||||
|
@Test |
||||||
|
void probeOutboundDetail() { |
||||||
|
assumeToken(); |
||||||
|
String orderNo = System.getProperty("yqn.probe.outboundOrderNo", ""); |
||||||
|
Assumptions.assumeTrue(!orderNo.trim().isEmpty(), |
||||||
|
"未提供 -Dyqn.probe.outboundOrderNo,跳过出库详情探针"); |
||||||
|
run("POST /v1/saleOrder/findOne", () -> { |
||||||
|
common.ecommerce.warehouse.model.OutboundOrder order = |
||||||
|
adapter().get(ctx(), |
||||||
|
common.ecommerce.warehouse.model.OutboundRef.ofRequestNo(orderNo)); |
||||||
|
if (order == null) { |
||||||
|
System.out.println("[outbound] 未找到该单"); |
||||||
|
return; |
||||||
|
} |
||||||
|
System.out.println("[outbound] status=" + order.status() |
||||||
|
+ " rawStatus=" + order.rawStatus() |
||||||
|
+ " tracking=" + order.trackingNumber() |
||||||
|
+ " carrierCode=" + order.carrierCode() |
||||||
|
+ " paidAt=" + order.paidAt() |
||||||
|
+ " shippedAt=" + order.shippedAt()); |
||||||
|
System.out.println(" 行数=" + order.lines().size() |
||||||
|
+ " 附件数=" + order.attachments().size() |
||||||
|
+ " SN数=" + order.serialNumbers().size() |
||||||
|
+ " signatureRequired=" + order.signatureRequired() |
||||||
|
+ " insured=" + order.insured()); |
||||||
|
for (common.ecommerce.warehouse.model.OutboundLine l : order.lines()) { |
||||||
|
System.out.println(" line sku=" + l.providerSku() |
||||||
|
+ " qty=" + l.quantity() |
||||||
|
+ " totalAmount=" + l.totalAmount() |
||||||
|
+ " batchNos=" + l.batchNos() |
||||||
|
+ " ordIds=" + l.platformOrderItemIds()); |
||||||
|
} |
||||||
|
for (common.ecommerce.warehouse.model.WarehouseAttachment a : order.attachments()) { |
||||||
|
System.out.println(" attach type=" + a.type() + " name=" + a.name() + " url=" + a.url()); |
||||||
|
} |
||||||
|
}); |
||||||
|
} |
||||||
|
|
||||||
|
/** 入库计划查询:只查,不创建。 */ |
||||||
|
@Test |
||||||
|
void probeInboundPlan() { |
||||||
|
assumeToken(); |
||||||
|
String orderNo = System.getProperty("yqn.probe.inboundOrderNo", ""); |
||||||
|
Assumptions.assumeTrue(!orderNo.trim().isEmpty(), |
||||||
|
"未提供 -Dyqn.probe.inboundOrderNo,跳过入库计划探针"); |
||||||
|
run("POST /v1/inbound/getInboundPlanInfo", () -> { |
||||||
|
common.ecommerce.warehouse.model.InboundOrder order = |
||||||
|
adapter().get(ctx(), orderNo); |
||||||
|
if (order == null) { |
||||||
|
System.out.println("[inbound] 未找到该单"); |
||||||
|
return; |
||||||
|
} |
||||||
|
System.out.println("[inbound] status=" + order.status() |
||||||
|
+ " planned=" + order.plannedQuantity() |
||||||
|
+ " packed=" + order.packedQuantity() |
||||||
|
+ " received=" + order.receivedQuantity() |
||||||
|
+ " boxes=" + order.boxCount() |
||||||
|
+ " containers=" + order.containers().size()); |
||||||
|
for (common.ecommerce.warehouse.model.InboundOrderBatch b : order.batches()) { |
||||||
|
System.out.println(" batch phase=" + b.phase() + " carton=" + b.cartonNo() |
||||||
|
+ " qty=" + b.quantity() + " invType=" + b.inventoryType()); |
||||||
|
} |
||||||
|
}); |
||||||
|
} |
||||||
|
|
||||||
|
/** 退货计划查询:验证明细行 id(API 77 的操作键)能否拿到。 */ |
||||||
|
@Test |
||||||
|
void probeReturnPlan() { |
||||||
|
assumeToken(); |
||||||
|
String orderNo = System.getProperty("yqn.probe.returnOrderNo", ""); |
||||||
|
Assumptions.assumeTrue(!orderNo.trim().isEmpty(), |
||||||
|
"未提供 -Dyqn.probe.returnOrderNo,跳过退货计划探针"); |
||||||
|
run("POST /v3/saleReturn/getInboundPlanInfo", () -> { |
||||||
|
common.ecommerce.warehouse.model.WarehouseReturn ret = |
||||||
|
adapter().getReturn(ctx(), orderNo); |
||||||
|
if (ret == null) { |
||||||
|
System.out.println("[return] 未找到该单"); |
||||||
|
return; |
||||||
|
} |
||||||
|
System.out.println("[return] status=" + ret.status() |
||||||
|
+ " rawStatus=" + ret.rawStatus() |
||||||
|
+ " inspected=" + ret.inspectedQuantity() |
||||||
|
+ " lines=" + ret.lines().size()); |
||||||
|
for (common.ecommerce.warehouse.model.WarehouseReturn.ReturnLine l : ret.lines()) { |
||||||
|
System.out.println(" line id=" + l.lineId() |
||||||
|
+ " sku=" + l.providerSku() |
||||||
|
+ " qty=" + l.quantity() |
||||||
|
+ " suggested=" + l.suggestedDisposition()); |
||||||
|
} |
||||||
|
}); |
||||||
|
} |
||||||
|
|
||||||
|
/** 物流轨迹:需要运单号。 */ |
||||||
|
@Test |
||||||
|
void probeTracking() { |
||||||
|
assumeToken(); |
||||||
|
String trackingNo = System.getProperty("yqn.probe.trackingNo", ""); |
||||||
|
Assumptions.assumeTrue(!trackingNo.trim().isEmpty(), |
||||||
|
"未提供 -Dyqn.probe.trackingNo,跳过轨迹探针"); |
||||||
|
run("GET /api/v2/orderShipment/track/{trackingNo}", () -> { |
||||||
|
common.ecommerce.warehouse.model.TrackingInfo info = |
||||||
|
adapter().trackShipment(ctx(), trackingNo); |
||||||
|
System.out.println("[tracking] status=" + info.status() |
||||||
|
+ " carrier=" + info.carrier() |
||||||
|
+ " signedBy=" + info.signedBy() |
||||||
|
+ " events=" + info.events().size() |
||||||
|
+ " parcelWeightG=" + info.parcelWeightGrams() |
||||||
|
+ " parcelLenCm=" + info.parcelLengthCm() |
||||||
|
+ " guaranteedDelivery=" + info.guaranteedDeliveryDate()); |
||||||
|
}); |
||||||
|
} |
||||||
|
|
||||||
|
// ---------------------------------------------------------------- helpers
|
||||||
|
|
||||||
|
private static void assumeToken() { |
||||||
|
Assumptions.assumeTrue(!TOKEN.trim().isEmpty(), |
||||||
|
"未提供 -Dyqn.probe.token,跳过运去哪探针"); |
||||||
|
} |
||||||
|
|
||||||
|
/** 探针异常只打印不抛出,方便一次跑完并对照真实报文。 */ |
||||||
|
private static void run(String api, Runnable r) { |
||||||
|
System.out.println("\n================ yqn / " + api + " ================"); |
||||||
|
System.out.println("[probe] baseUrl=" + BASE_URL + " auxUrl=" + AUX_URL |
||||||
|
+ " warehouse=" + WAREHOUSE_CODE + " token=" + mask()); |
||||||
|
try { |
||||||
|
r.run(); |
||||||
|
System.out.println("[OK] " + api); |
||||||
|
} catch (RuntimeException e) { |
||||||
|
String msg = e.getMessage() == null ? e.getClass().getSimpleName() : e.getMessage(); |
||||||
|
System.out.println("[ERROR] " + e.getClass().getSimpleName() + ": " |
||||||
|
+ (msg.length() <= 300 ? msg : msg.substring(0, 300) + "…")); |
||||||
|
if (e instanceof ChannelException) { |
||||||
|
ChannelException ce = (ChannelException) e; |
||||||
|
System.out.println(" platformCode=" + ce.platformCode() |
||||||
|
+ " platformRequestId=" + ce.platformRequestId() |
||||||
|
+ " retryable=" + ce.retryable()); |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
private static String mask() { |
||||||
|
if (TOKEN.length() <= 6) { |
||||||
|
return "***"; |
||||||
|
} |
||||||
|
return TOKEN.substring(0, 4) + "***" |
||||||
|
+ TOKEN.substring(TOKEN.length() - 2); |
||||||
|
} |
||||||
|
|
||||||
|
private static String opt(String name, String fallback) { |
||||||
|
String value = System.getProperty(name, ""); |
||||||
|
if (value == null) { |
||||||
|
return fallback; |
||||||
|
} |
||||||
|
String trimmed = value.trim(); |
||||||
|
return trimmed.isEmpty() ? fallback : trimmed; |
||||||
|
} |
||||||
|
} |
||||||
Loading…
Reference in new issue