@ -11,7 +11,16 @@ import java.util.Objects;
@@ -11,7 +11,16 @@ import java.util.Objects;
* /
public final class WarehouseAccount {
/** OMS 仓编码,本域主键。 */
/ * *
* 账户主键 , 同时是取密钥的键 。
*
* < p > 由 OMS 自己定 ( 自增 ID / 业务编号均可 ) , 一个账户一条 。
* { @code SecretProvider } 拿它去取对应的 { @code ChannelSecret } 。
* 同一账户下挂多个仓时 , 这些仓共用这一套密钥 。 < / p >
* /
private final String accountId ;
/** OMS 仓编码,业务主键;{@code sdk.warehouses()} 传的就是它。 */
private final String warehouseCode ;
/** 接入通道名({@code WarehouseProvider.name()})。 */
@ -20,21 +29,23 @@ public final class WarehouseAccount {
@@ -20,21 +29,23 @@ public final class WarehouseAccount {
/** 仓方仓编码,如 {@code RF_NY_US};下发与回传时使用。 */
private final String providerWarehouseId ;
/** 凭证引用,不是凭证本体。 */
private final String credentialRef ;
private WarehouseAccount ( Builder b ) {
this . accountId = require ( b . accountId , "accountId" ) ;
this . warehouseCode = require ( b . warehouseCode , "warehouseCode" ) ;
this . provider = require ( b . provider , "provider" ) ;
this . providerWarehouseId = b . providerWarehouseId ;
this . credentialRef = require ( b . credentialRef , "credentialRef" ) ;
}
public static Builder builder ( ) {
return new Builder ( ) ;
}
/** OMS 下发的仓编码,本域主键。 */
/** 账户主键,同时作为 {@code SecretProvider} 的取密钥键。 */
public String accountId ( ) {
return accountId ;
}
/** OMS 下发的仓编码,本域业务主键。 */
public String warehouseCode ( ) {
return warehouseCode ;
}
@ -49,11 +60,6 @@ public final class WarehouseAccount {
@@ -49,11 +60,6 @@ public final class WarehouseAccount {
return providerWarehouseId ;
}
/** 凭证引用,不是凭证本体;由 {@code SecretProvider} 解析成密钥与端点。 */
public String credentialRef ( ) {
return credentialRef ;
}
private static String require ( String v , String n ) {
if ( v = = null | | v . trim ( ) . isEmpty ( ) ) {
throw new IllegalArgumentException ( n + " must not be blank" ) ;
@ -62,10 +68,16 @@ public final class WarehouseAccount {
@@ -62,10 +68,16 @@ public final class WarehouseAccount {
}
public static final class Builder {
private String accountId ;
private String warehouseCode ;
private String provider ;
private String providerWarehouseId ;
private String credentialRef ;
/** 账户主键;不填时默认等于 {@code warehouseCode}。 */
public Builder accountId ( String v ) {
this . accountId = v ;
return this ;
}
public Builder warehouseCode ( String v ) {
this . warehouseCode = v ;
@ -82,12 +94,11 @@ public final class WarehouseAccount {
@@ -82,12 +94,11 @@ public final class WarehouseAccount {
return this ;
}
public Builder credentialRef ( String v ) {
this . credentialRef = v ;
return this ;
}
/** 构建账户;{@code accountId} 未设置时取 {@code warehouseCode}。 */
public WarehouseAccount build ( ) {
if ( accountId = = null | | accountId . trim ( ) . isEmpty ( ) ) {
accountId = warehouseCode ;
}
return new WarehouseAccount ( this ) ;
}
}