程序包 com.midi.his.sdk.config

类 HisConfig.Builder

java.lang.Object

com.midi.his.sdk.config.HisConfig.Builder

封闭类:

HisConfig

public static final class HisConfig.Builder
extends Object

HisConfig 构建器。未显式设置的项采用注释中的默认值。

方法概要

修饰符和类型	方法	说明
HisConfig	build()
HisConfig.Builder	callTimeout(Duration timeout)	整体调用超时，默认不限制；包含重试在内的总耗时上限。
HisConfig.Builder	connectTimeout(Duration timeout)	连接超时，默认 5 秒。
HisConfig.Builder	dataChannel(String dataChannel)	查询数据通道，默认 DC10001。
HisConfig.Builder	defaultDataAmount(int dataAmount)	查询默认单页行数，默认 500。
HisConfig.Builder	defaultTriggerData(int triggerData)	查询默认分页阈值，默认 0（不分页）。
HisConfig.Builder	fidOverride(HisService service, String fid)	覆盖某个服务的 Fid。
HisConfig.Builder	fidOverrides(Map<String,String> overrides)	批量设置 Fid 覆盖，键为服务枚举名（大小写不敏感），取值按 fidOverride(com.midi.his.sdk.catalog.HisService, java.lang.String) 规范化。
HisConfig.Builder	hospCode(String hospCode)	院区标识。
HisConfig.Builder	logPayload(boolean logPayload)	是否在 DEBUG 级别输出完整报文，默认 false。
HisConfig.Builder	orderNoOverride(HisService service, String orderNo)	覆盖某个服务的固定 OrderNo。
HisConfig.Builder	orderNoOverrides(Map<String,String> overrides)	批量设置 OrderNo 覆盖，键为服务枚举名（大小写不敏感），取值按 orderNoOverride(com.midi.his.sdk.catalog.HisService, java.lang.String) 规范化。
HisConfig.Builder	password(String password)	平台分配的密码。
HisConfig.Builder	protocol(Protocol protocol)	协议，默认 Protocol.SOAP_1_1。
HisConfig.Builder	pushEndpoints(String... endpoints)	推送服务地址，覆盖式设置。
HisConfig.Builder	pushEndpoints(List<String> endpoints)	推送服务地址列表。
HisConfig.Builder	pushReturnFlag(String returnFlag)	推送 ReturnFlag，默认 -1（该服务不进行回写）。
HisConfig.Builder	pushTargetSysCode(String targetSysCode)	推送请求的接收方系统编号，未设置时沿用 sourceSysCode。
HisConfig.Builder	queryEndpoints(String... endpoints)	查询服务地址，覆盖式设置。
HisConfig.Builder	queryEndpoints(List<String> endpoints)	查询服务地址列表。
HisConfig.Builder	queryTargetSysCode(String targetSysCode)	查询请求的接收方系统编号。
HisConfig.Builder	readTimeout(Duration timeout)	读超时，默认 30 秒。
HisConfig.Builder	retryPolicy(RetryPolicy retryPolicy)	重试策略，默认 3 次尝试、500ms 起退避。
HisConfig.Builder	soapAction(String soapAction)	SOAPAction 头原文，默认空串。
HisConfig.Builder	sourceSysCode(String sourceSysCode)	本系统在平台中的编号。
HisConfig.Builder	sysFlag(SysFlag sysFlag)	环境标识，默认生产。
HisConfig.Builder	userName(String userName)	平台分配的用户名。

从类继承的方法 java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

方法详细资料

protocol

public HisConfig.Builder protocol(Protocol protocol)

协议，默认 Protocol.SOAP_1_1。

queryEndpoints

public HisConfig.Builder queryEndpoints(String... endpoints)

查询服务地址，覆盖式设置。

queryEndpoints

public HisConfig.Builder queryEndpoints(List<String> endpoints)

查询服务地址列表。

pushEndpoints

public HisConfig.Builder pushEndpoints(String... endpoints)

推送服务地址，覆盖式设置。

pushEndpoints

public HisConfig.Builder pushEndpoints(List<String> endpoints)

推送服务地址列表。

userName

public HisConfig.Builder userName(String userName)

平台分配的用户名。

password

public HisConfig.Builder password(String password)

平台分配的密码。

sysFlag

public HisConfig.Builder sysFlag(SysFlag sysFlag)

环境标识，默认生产。

sourceSysCode

public HisConfig.Builder sourceSysCode(String sourceSysCode)

本系统在平台中的编号。

queryTargetSysCode

public HisConfig.Builder queryTargetSysCode(String targetSysCode)

查询请求的接收方系统编号。

pushTargetSysCode

public HisConfig.Builder pushTargetSysCode(String targetSysCode)

推送请求的接收方系统编号，未设置时沿用 sourceSysCode。

hospCode

public HisConfig.Builder hospCode(String hospCode)

院区标识。

dataChannel

public HisConfig.Builder dataChannel(String dataChannel)

查询数据通道，默认 DC10001。

connectTimeout

public HisConfig.Builder connectTimeout(Duration timeout)

连接超时，默认 5 秒。

readTimeout

public HisConfig.Builder readTimeout(Duration timeout)

读超时，默认 30 秒。

callTimeout

public HisConfig.Builder callTimeout(Duration timeout)

整体调用超时，默认不限制；包含重试在内的总耗时上限。

retryPolicy

public HisConfig.Builder retryPolicy(RetryPolicy retryPolicy)

重试策略，默认 3 次尝试、500ms 起退避。

defaultDataAmount

public HisConfig.Builder defaultDataAmount(int dataAmount)

查询默认单页行数，默认 500。

defaultTriggerData

public HisConfig.Builder defaultTriggerData(int triggerData)

查询默认分页阈值，默认 0（不分页）。

soapAction

public HisConfig.Builder soapAction(String soapAction)

SOAPAction 头原文，默认空串。

空串按 SOAP 1.1 惯例下发 SOAPAction: ""； 传 null 表示完全不带该头（少数平台拒绝空 SOAPAction 时需要）； 已含引号的值原样下发。从 properties 装载时该键总有值，要省略头请在本方法上显式传 null。

pushReturnFlag

public HisConfig.Builder pushReturnFlag(String returnFlag)

推送 ReturnFlag，默认 -1（该服务不进行回写）。

fidOverride

public HisConfig.Builder fidOverride(HisService service,
 String fid)

覆盖某个服务的 Fid。

空值一律拒绝：Fid 会直接写进 AccessControl 与 MessageHeader， 空编号到线上只会表现为鉴权失败，必须在登记时就报错。OrderNo 已按服务固定， 改 Fid 时如需同步改订单号，请另行调用 orderNoOverride(com.midi.his.sdk.catalog.HisService, java.lang.String)。

参数:

service - 服务

fid - 实际使用的服务编号，去空白后不可为空

返回:

自身

抛出:

HisConfigException - fid 为 null 或空白

fidOverrides

public HisConfig.Builder fidOverrides(Map<String,String> overrides)

批量设置 Fid 覆盖，键为服务枚举名（大小写不敏感），取值按 fidOverride(com.midi.his.sdk.catalog.HisService, java.lang.String) 规范化。

参数:

overrides - 服务名到服务编号的映射

返回:

自身

抛出:

HisConfigException - 键不是已登记服务名，或取值为空

orderNoOverride

public HisConfig.Builder orderNoOverride(HisService service,
 String orderNo)

覆盖某个服务的固定 OrderNo。

未设置时使用 HisService.defaultOrderNo()（来自 docs/文档解析.md）。 空值一律拒绝，避免把空订单号写到鉴权节点后才在线上表现为鉴权失败。

参数:

service - 服务

orderNo - 固定订单编号，去空白后不可为空

返回:

自身

抛出:

HisConfigException - orderNo 为 null 或空白

orderNoOverrides

public HisConfig.Builder orderNoOverrides(Map<String,String> overrides)

批量设置 OrderNo 覆盖，键为服务枚举名（大小写不敏感），取值按 orderNoOverride(com.midi.his.sdk.catalog.HisService, java.lang.String) 规范化。

参数:

overrides - 服务名到固定订单编号的映射

返回:

自身

抛出:

HisConfigException - 键不是已登记服务名，或取值为空

logPayload

public HisConfig.Builder logPayload(boolean logPayload)

是否在 DEBUG 级别输出完整报文，默认 false。

build

public HisConfig build()

返回:

校验后的不可变配置