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.

169 lines
7.1 KiB

package common.ecommerce.xincang.http;
import common.ecommerce.http.HttpResponse;
import common.ecommerce.http.JsonCodec;
import common.ecommerce.shared.error.AuthException;
import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.error.PlatformBusinessException;
import common.ecommerce.shared.error.RateLimitException;
import common.ecommerce.shared.error.TransientException;
import common.ecommerce.shared.error.ValidationException;
import common.ecommerce.xincang.XincangConstants;
/**
* 信仓响应信封校验。
*
* <p>信仓统一外层(Apifox「OMS接口文档V2」):</p>
* <pre>
* { "rst": ..., "errno": 0, "err": "", "trace_id": "..." }
* </pre>
*
* <p>两条成功判定:顶层 {@code errno} 为 0;业务接口的 {@code rst} 是
* {@code {"code":"0","msg":"","data":...}} 时还要求 {@code rst.code} 为 {@code "0"}。
* 登录是例外——它的 {@code rst} 直接是客户 / token 字段,没有 {@code code},缺失即视为通过。</p>
*
* <p>HTTP 401/403/429/5xx 仍按 HTTP 语义映射:网关或代理层直接拒绝时也要能正确分类。</p>
*/
public final class XincangEnvelope {
/** 原始响应体。 */
private final String rawBody;
/** 信仓侧链路号 {@code trace_id};可能为 null。 */
private final String platformTraceId;
private XincangEnvelope(String rawBody, String platformTraceId) {
this.rawBody = rawBody;
this.platformTraceId = platformTraceId;
}
/**
* 校验 HTTP 状态与业务码。
*
* @param response 传输层响应
* @param json 用于读 {@code errno} / {@code rst.code} / {@code trace_id}
* @param operation 门面操作名,如 {@code token.fetch}
* @param requestId 我方链路 ID
* @throws AuthException 401 / 403
* @throws RateLimitException 429
* @throws TransientException 5xx
* @throws ValidationException 其它非 2xx,或报文结构不符合预期
* @throws PlatformBusinessException errno 非 0,或 rst.code 非 0
*/
public static XincangEnvelope of(HttpResponse response, JsonCodec json, String operation,
String requestId) {
int status = response.statusCode();
if (status == 401 || status == 403) {
throw new AuthException(base(operation, requestId)
.message("xincang auth failed: http " + status)
.platformCode(String.valueOf(status))
.rawResponse(truncate(response.body()))
.retryable(false));
}
if (status == 429) {
throw new RateLimitException(base(operation, requestId)
.message("xincang rate limited")
.platformCode(String.valueOf(status))
.retryable(true), retryAfterMillis(response));
}
if (status >= 500) {
throw new TransientException(base(operation, requestId)
.message("xincang server error: http " + status)
.platformCode(String.valueOf(status))
.retryable(true), null);
}
if (status < 200 || status >= 300) {
throw new ValidationException(base(operation, requestId)
.message("xincang request rejected: http " + status)
.platformCode(String.valueOf(status))
.rawResponse(truncate(response.body()))
.retryable(false));
}
String body = response.body();
if (body == null || body.trim().isEmpty()) {
throw new ValidationException(base(operation, requestId)
.message("xincang returned an empty body")
.retryable(false));
}
String traceId = json.stringAt(body, "trace_id");
String errno = json.stringAt(body, "errno");
if (errno == null || errno.trim().isEmpty()) {
throw new ValidationException(base(operation, requestId)
.message("xincang response has no errno")
.platformRequestId(traceId)
.rawResponse(truncate(body))
.retryable(false));
}
if (!XincangConstants.SUCCESS_ERRNO.equals(errno.trim())) {
throw new PlatformBusinessException(base(operation, requestId)
.message("xincang business error: errno=" + errno
+ ", err=" + json.stringAt(body, "err"))
.platformCode(errno.trim())
.platformRequestId(traceId)
.rawResponse(truncate(body))
.retryable(false));
}
String rstCode = json.stringAt(body, "rst.code");
if (rstCode != null && !XincangConstants.SUCCESS_RST_CODE.equals(rstCode.trim())) {
throw new PlatformBusinessException(base(operation, requestId)
.message("xincang business error: rst.code=" + rstCode
+ ", rst.msg=" + json.stringAt(body, "rst.msg"))
.platformCode(rstCode.trim())
.platformRequestId(traceId)
.rawResponse(truncate(body))
.retryable(false));
}
return new XincangEnvelope(body, traceId);
}
/** 原始响应体;不会是 null。 */
public String body() {
return rawBody;
}
/** 信仓侧链路号 {@code trace_id};可能为 null。 */
public String platformTraceId() {
return platformTraceId;
}
/**
* 统一异常字段。
*
* <p>返回 {@link ChannelException.Builder} 而不是 {@code WarehouseException.Builder}:
* 仓库域的自定义异常仅有 {@code WarehouseException} 一个,其余分类(Auth / RateLimit /
* Transient / Validation / PlatformBusiness)的构造器都收 {@code ChannelException.Builder}。</p>
*
* <p>{@code warehouseCode} 保留在签名里便于调用方一致传参,但 <b>不</b>写进
* {@code omsStoreId}——那是渠道域的店铺 ID,填仓编码会污染审计字段。
* 需要仓维度的错误请由适配器层包一层 {@code WarehouseException}。</p>
*/
private static ChannelException.Builder base(String operation,
String requestId) {
return ChannelException.builder()
.operation(operation)
.provider(XincangConstants.ADAPTER_ID)
.requestId(requestId);
}
/** {@code Retry-After} 秒折算毫秒;缺失按 1s。 */
private static long retryAfterMillis(HttpResponse response) {
String header = response.header("Retry-After");
if (header == null || header.trim().isEmpty()) {
return 1000L;
}
try {
return Math.max(0L, Long.parseLong(header.trim()) * 1000L);
} catch (NumberFormatException e) {
return 1000L;
}
}
private static String truncate(String body) {
if (body == null) {
return null;
}
return body.length() <= 2000 ? body : body.substring(0, 2000) + "...";
}
}