第 226 章 MLLP 组件
从 Camel 版本 2.17 开始提供
MLLP 组件专门设计来处理 MLLP 协议的细微性，并提供 Healthcare 供应商使用 MLLP 协议与其他系统通信所需的功能。MLLP 组件提供简单的配置 URI，自动化的 HL7 确认生成和自动确认干预。
MLLP 协议通常不使用大量并发 TCP 连接 - 一个活跃的 TCP 连接是正常的。因此，MLLP 组件使用基于标准 Java 套接字的简单线程-per-connection 模型。这可使实施简单，并消除了除 Camel 本身以外的依赖项。
组件支持以下内容：
- 使用 TCP 服务器的 Camel 使用者
- 使用 TCP 客户端的 Camel 生成者
MLLP 组件使用 byte[] 有效负载，并依赖于 Camel Type Conversion 将 byte[] 转换为其他类型。
Maven 用户需要将以下依赖项添加到此组件的 pom.xml 中：
<dependency>
<groupId>org.apache.camel</groupId>
<artifactId>camel-mllp</artifactId>
<version>x.x.x</version>
<!-- use the same version as your Camel core version -->
</dependency>226.1. MLLP 选项
MLLP 组件支持 5 个选项，如下所列。
| 名称 | 描述 | 默认值 | 类型 |
|---|---|---|---|
| logPhi (advanced) | 将组件设置为日志 PHI 数据。 | true | 布尔值 |
| logPhiMaxBytes (advanced) | 设置在日志条目中将登录的 PHI 的最大字节数。 | 5120 | 整数 |
| defaultCharset (advanced) | 设置用于字节到字符串转换的默认字符集。 | ISO-8859-1 | 字符串 |
| configuration (common) | 设置创建 MLLP 端点时要使用的默认配置。 | MllpConfiguration | |
| resolveProperty Placeholders (advanced) | 启动时组件是否应解析自身上的属性占位符。只有属于 String 类型的属性才能使用属性占位符。 | true | 布尔值 |
MLLP 端点使用 URI 语法进行配置：
mllp:hostname:port
使用以下路径和查询参数：
226.1.1. 路径参数(2 参数)：
| 名称 | 描述 | 默认值 | 类型 |
|---|---|---|---|
| hostname | 必需 TCP 连接的连接的主机名或 IP。默认值为 null，这意味着任何本地 IP 地址 | 字符串 | |
| 端口 | TCP 连接所需的端口号 | int |
226.1.2. 查询参数(27 参数)：
| 名称 | 描述 | 默认值 | 类型 |
|---|---|---|---|
| autoAck (common) | 仅启用/禁用 MLLP Acknowledgement MLLP Consumers 的自动生成 | true | 布尔值 |
| bufferWrites (common) | 在写入套接字前，弃用的 Enable/Disable the buffering of HL7 payloads。 | false | 布尔值 |
| hl7Headers (common) | 仅启用/禁用 HL7 Message MLLP Consumers 的自动生成消息标头 | true | 布尔值 |
| requireEndOfData (common) | 启用/禁用对 MLLP 标准的严格合规性。MLLP 标准指定 START_OF_BLOCKhl7 payloadEND_OF_BLOCKEND_OF_DATA，但有些系统不会发送最终 END_OF_DATA 字节。此设置控制是否需要最终 END_OF_DATA 字节或可选。 | true | 布尔值 |
| stringPayload (common) | 启用/禁用将有效负载转换为 String。如果启用，则从外部系统接收的 HL7 Payloads 将验证转换为字符串。如果设置了 charsetName 属性，则该字符集将用于转换。如果没有设置 charsetName 属性，则使用 MSH-18 的值来确定 th 合适的字符集。如果没有设置 MSH-18，则将使用默认 ISO-8859-1 字符集。 | true | 布尔值 |
| validatePayload (common) | 启用/禁用 HL7 Payloads if enabled, HL7 Payloads if enabled, HL7 Payloads are received from external system isUtil.generateInvalidPayloadExceptionMessage 以了解验证的详情。如果检测到无效有效负载，则会抛出 MllpInvalidMessageException （用于消费者）或 MllpInvalidAcknowledgementException。 | false | 布尔值 |
| bridgeErrorHandler (consumer) | 允许将消费者桥接到 Camel 路由 Error Handler，这意味着当消费者试图接收传入的消息或类似信息时发生异常，现在将被作为消息进行处理，并由路由 Error Handler 处理。如果禁用，使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理异常，方法是将它们记录到 WARN 或 ERROR 级别，并忽略。 | true | 布尔值 |
| exceptionHandler (consumer) | 要让使用者使用自定义例外处理程序：请注意，如果启用了 bridgeErrorHandler 选项，则此选项不使用。默认情况下，消费者将处理异常，其记录在 WARN 或 ERROR 级别中，并忽略。 | ExceptionHandler | |
| exchangePattern (consumer) | 在消费者创建交换时设置交换模式。 | InOut | ExchangePattern |
| 同步 (advanced) | 设置是否应严格使用同步处理（此组件只支持同步操作）。 | true | 布尔值 |
| backlog (tcp) | 传入连接的最大队列长度（连接的请求）设置为 backlog 参数。如果连接指示在队列满时到达，连接将被拒绝。 | 5 | 整数 |
| lenientBind (tcp) | TCP Server Only - 允许端点在 TCP ServerSocket 绑定前启动。在某些环境中，可能需要允许端点在 TCP ServerSocket 绑定之前启动。 | false | 布尔值 |
| maxConcurrentConsumers (tcp) | 允许的最大并发 MLLP Consumer 连接数。如果收到新连接并且已建立最大连接，则新连接将立即重置。 | 5 | int |
| reuseAddress (tcp) | 启用/禁用 SO_REUSEADDR 套接字选项。 | false | 布尔值 |
| acceptTimeout (timeout) | 只等待 TCP 连接 TCP 服务器超时（以毫秒为单位） | 60000 | int |
| bindRetryInterval (timeout) | 仅限 TCP 服务器 - 绑定尝试之间等待的毫秒数 | 5000 | int |
| bindTimeout (timeout) | 仅限 TCP 服务器 - 重试绑定到服务器端口的毫秒数 | 30000 | int |
| connectTimeout (timeout) | 仅为 TCP 连接 TCP 客户端建立超时（以毫秒为单位） | 30000 | int |
| idleTimeout (timeout) | 在客户端 TCP 连接将重置前允许的大约空闲时间。null 值或小于或等于零的值将禁用闲置超时。 | 整数 | |
| maxReceiveTimeouts (timeout) | 弃用 TCP 连接将重置前允许的最大超时数（由 receiveTimeout 指定）。 | 整数 | |
| keepAlive (tcp) | 启用/禁用 SO_KEEPALIVE 套接字选项。 | true | 布尔值 |
| receiveBufferSize (tcp) | 将 SO_RCVBUF 选项设置为指定的值（以字节为单位） | 8192 | 整数 |
| sendBufferSize (tcp) | 将 SO_SNDBUF 选项设置为指定的值（以字节为单位） | 8192 | 整数 |
| tcpNoDelay (tcp) | 启用/禁用 TCP_NODELAY 套接字选项。 | true | 布尔值 |
| readTimeout (timeout) | 收到 MLLP 框架开始后使用的 SO_TIMEOUT 值（以毫秒为单位） | 5000 | int |
| receiveTimeout (timeout) | 等待 MLLP 帧开始时使用的 SO_TIMEOUT 值（以毫秒为单位） | 15000 | int |
| charsetName (codec) | 在交换中设置 CamelCharsetName 属性 | 字符串 |
