package common.ecommerce.edayun.auth; import common.ecommerce.edayun.EdayunConstants; import common.ecommerce.edayun.dto.EdayunTokenDtos; import common.ecommerce.edayun.http.EdayunRequestFactory; import common.ecommerce.http.HttpRequest; import common.ecommerce.http.HttpResponse; import common.ecommerce.http.JsonCodec; import common.ecommerce.http.HttpTransport; import common.ecommerce.shared.error.ValidationException; import common.ecommerce.shared.spi.AccessToken; import common.ecommerce.warehouse.error.WarehouseException; import java.time.Clock; import java.time.Instant; /** * 易达云获取 token({@code POST /oauth/token})。 * *
凭据用 OMS 授权账号:{@link common.ecommerce.shared.spi.ChannelSecret#clientId()} * / {@link common.ecommerce.shared.spi.ChannelSecret#clientSecret()}。 * appKey 不参与这一步(它是业务请求头的字段)。
* *实测(2026-11-12,PR 环境):成功响应的 body 是扁平结构,没有 {@code code}:
*
* HTTP 200
* {"access_token":"0dabff46-...","token_type":"bearer","scope":"server"}
*
*
* token 是永久的(文档:「目前设计上是永久的,建议留个窗口刷新」), * 响应里没有有效期字段。所以 {@code expiresAt} 是个估算值——用于让 * {@code TokenManager} 定期重登一次,而不是真的到期。
* *兼容分支:若网关把结果包一层 {@code data} 或返回 {@code code}, * 也按对应形态解析(生产环境确认后可删)。
*/ public final class EdayunTokenClient { private static final String OP_FETCH = "token.fetch"; private final HttpTransport transport; private final JsonCodec json; private final EdayunRequestFactory requestFactory; private final Clock clock; public EdayunTokenClient(HttpTransport transport, JsonCodec json, Clock clock) { this.transport = transport; this.json = json; this.clock = clock; this.requestFactory = new EdayunRequestFactory(json); } /** * 换取令牌。 * * @param baseUrl 本次调用的基址 * @param clientId OMS 授权用户名 * @param clientSecret OMS 授权密码 */ public AccessToken fetch(String baseUrl, String clientId, String clientSecret) { HttpRequest req = requestFactory.token(baseUrl, clientId, clientSecret, OP_FETCH); HttpResponse resp = transport.execute(req); requireHttpOk(resp); String body = resp.body(); EdayunTokenDtos.TokenResponse parsed; try { parsed = json.fromJson(body, EdayunTokenDtos.TokenResponse.class); } catch (RuntimeException e) { throw validation("edayun token response is not json", body); } requireBusinessOk(parsed, body); String token = tokenOf(parsed, body); return AccessToken.builder() .value(token) .expiresAt(expiresAtOf(parsed)) .build(); } /** HTTP 层:非 2xx 直接失败。 */ private void requireHttpOk(HttpResponse resp) { int status = resp.statusCode(); if (status >= 200 && status < 300) { return; } throw toException(status, resp.body()); } private WarehouseException toException(int status, String body) { boolean retryable = status >= 500 && status != 504; return WarehouseException.builder() .message("edayun token request failed: http " + status + ", body=" + truncate(body)) .operation(OP_FETCH) .provider(EdayunConstants.ADAPTER_ID) .platformCode(String.valueOf(status)) .rawResponse(truncate(body)) .retryable(retryable) .build(); } /** * 业务码:200 成功;500 失败;503 网关无效;504 超时。 * *实测该接口不返回 {@code code}——HTTP 200 + body 里有 access_token * 就是成功。所以 {@code code} 缺失时不算失败,交给后续的 token 存在性校验; * 只有显式给了非 200 的 code 才判失败。
* *503 通常是网关问题、504 是超时,都值得重试;500 是明确失败,不重试。
*/ private void requireBusinessOk(EdayunTokenDtos.TokenResponse parsed, String body) { if (parsed == null) { throw validation("edayun token response is empty", body); } Integer code = parsed.code; if (code == null) { // 实测:扁平结构没有 code,视为成功,由 tokenOf 校验 token 是否存在 return; } if (code == EdayunConstants.CODE_SUCCESS) { return; } throw WarehouseException.builder() .message("edayun token business error: code=" + code + ", message=" + parsed.message) .operation(OP_FETCH) .provider(EdayunConstants.ADAPTER_ID) .platformCode(String.valueOf(code)) .rawResponse(truncate(body)) .retryable(code == EdayunConstants.CODE_GATEWAY_INVALID || code == EdayunConstants.CODE_TIMEOUT) .build(); } /** * 取 token:实测是顶层 {@code access_token};兼容 {@code data.access_token} * 与顶层 {@code token}。都取不到就失败,不猜。 */ private String tokenOf(EdayunTokenDtos.TokenResponse parsed, String body) { if (hasText(parsed.accessToken)) { return parsed.accessToken.trim(); } if (parsed.data != null && hasText(parsed.data.accessToken)) { return parsed.data.accessToken.trim(); } String topLevel = json.stringAt(body, "token"); if (hasText(topLevel)) { return topLevel.trim(); } throw validation("edayun token response has no access token" + " (looked for access_token, data.access_token and token)", body); } /** * 过期时刻(估算)。 * *实测响应没有有效期字段,文档也说 token「目前设计上是永久的, * 建议留个窗口刷新」。所以这里返回一个估算值,作用只是让 {@code TokenManager} * 定期重登一次,避免真出问题时卡死。
* *若将来响应里出现 {@code data.expires_in} 或 {@code data.expiry}, * 优先用真值。
*/ private Instant expiresAtOf(EdayunTokenDtos.TokenResponse parsed) { Instant now = Instant.now(clock); EdayunTokenDtos.TokenResponse.TokenData data = parsed.data; if (data != null && data.expiresIn != null && data.expiresIn > 0) { return now.plusSeconds(data.expiresIn); } if (data != null && hasText(data.expiry)) { Instant absolute = parseAbsolute(data.expiry.trim()); if (absolute != null) { return absolute; } } // 文档:token 永久,建议定期刷新。按兜底周期重登一次。 return now.plusSeconds(EdayunConstants.DEFAULT_TOKEN_TTL_SECONDS); } /** 绝对时刻:兼容 ISO-8601 与毫秒 / 秒数字。 */ private static Instant parseAbsolute(String raw) { try { return Instant.parse(raw); } catch (RuntimeException ignored) { // 继续试数字 } try { long n = Long.parseLong(raw); // 10 位按秒、13 位按毫秒 return raw.length() <= 10 ? Instant.ofEpochSecond(n) : Instant.ofEpochMilli(n); } catch (RuntimeException ignored) { return null; } } private static ValidationException validation(String message, String body) { return new ValidationException(WarehouseException.builder() .message(message) .operation(OP_FETCH) .provider(EdayunConstants.ADAPTER_ID) .rawResponse(truncate(body)) .retryable(false)); } private static boolean hasText(String v) { return v != null && !v.trim().isEmpty(); } /** 响应可能含 token 与密码,异常里只留很短一段。 */ private static String truncate(String body) { if (body == null) { return null; } return body.length() <= 300 ? body : body.substring(0, 300) + "..."; } }