diff --git a/core/src/main/java/common/ecommerce/sdk/AdapterFactory.java b/core/src/main/java/common/ecommerce/sdk/AdapterFactory.java index 7a8ca5d..c5db9f6 100644 --- a/core/src/main/java/common/ecommerce/sdk/AdapterFactory.java +++ b/core/src/main/java/common/ecommerce/sdk/AdapterFactory.java @@ -20,24 +20,29 @@ public interface AdapterFactory { PlatformAdapter create(AdapterConfig config); - /** 适配器实例化所需的最小配置;凭证与账户信息在调用时经 ChannelContext 传入。 */ + /** + * 适配器实例化参数。 + * + *
不是配置项:SDK 不读配置文件、不查配置中心。端点、路径、限流等协议细节 + * 全部内置在适配器代码里;这里只承载「测试/联调时替换目标地址」这一种由调用方显式传入的 + * 参数。凭证与账户信息(含沙箱标记)属于账户数据,调用时经 + * {@link common.ecommerce.sdk.ChannelContext} 传入。
+ */ final class AdapterConfig { + /** 不覆盖任何默认值,使用适配器内置端点。 */ + public static final AdapterConfig NONE = new AdapterConfig(null); + private final String endpointBaseUrl; - private final boolean sandbox; - public AdapterConfig(String endpointBaseUrl, boolean sandbox) { + public AdapterConfig(String endpointBaseUrl) { this.endpointBaseUrl = endpointBaseUrl; - this.sandbox = sandbox; } + /** 仅用于测试/联调;为 null 表示使用适配器内置端点。 */ public String endpointBaseUrl() { return endpointBaseUrl; } - - public boolean sandbox() { - return sandbox; - } } /** 兜底:由平台推导默认 adapterId,便于日志定位。 */ diff --git a/core/src/main/java/common/ecommerce/sdk/ChannelSdk.java b/core/src/main/java/common/ecommerce/sdk/ChannelSdk.java index c96a6dc..89e927d 100644 --- a/core/src/main/java/common/ecommerce/sdk/ChannelSdk.java +++ b/core/src/main/java/common/ecommerce/sdk/ChannelSdk.java @@ -10,6 +10,7 @@ import common.ecommerce.idempotency.IdempotencyGuard; import common.ecommerce.model.account.AccountKey; import common.ecommerce.model.account.ChannelAccount; import common.ecommerce.spi.ChannelAccountRepository; +import common.ecommerce.sdk.AdapterFactory.AdapterConfig; import common.ecommerce.spi.IdempotencyStore; import java.time.Clock; @@ -186,8 +187,9 @@ public final class ChannelSdk implements ProviderResolver { if (adapters.isEmpty() && factories.isEmpty()) { throw new IllegalStateException("ChannelSdk requires at least one adapter or adapter factory"); } + // 端点内置于适配器代码,SDK 不读配置;AdapterConfig 只承载端口覆盖等测试用参数 for (AdapterFactory factory : factories) { - register(factory.create(new AdapterFactory.AdapterConfig(null, false))); + register(factory.create(AdapterConfig.NONE)); } return new ChannelSdk(this); } diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java index b3d6aaa..38939da 100644 --- a/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java +++ b/lingxing/src/main/java/common/ecommerce/lingxing/LingxingConstants.java @@ -1,10 +1,15 @@ package common.ecommerce.lingxing; import common.ecommerce.model.Platform; -/** 领星常量与 platform_code 映射。 */ +/** + * 领星协议常量与 platform_code 映射。 + * + *端点与路径是协议的一部分,必须写在代码里,不做成配置表: + * 配置化会让线上与测试跑不同协议,出错时无法从代码复现。
+ */ public final class LingxingConstants { - /** 生产环境基址。 */ + /** 生产环境基址;仅在测试/联调时由 AdapterConfig 覆盖。 */ public static final String DEFAULT_BASE_URL = "https://openapi.lingxing.com"; public static final String ADAPTER_ID = "lingxing";