Red Hat Summit 红帽全球峰会支持控制台（Console）开发人员开始试用联系人

第 58 章 HL7

HL7 组件用于使用 HL7 MLLP 协议和 HL7 v2 消息，使用 HAPI 库。

这个组件支持以下组件：

  • 用于 Mina的 HL7 MLLP codec
  • HL7 MLLP codec for Netty
  • 键入 Converter from/to HAPI 和 String
  • 使用 HAPI 库的 HL7 DataFormat

Maven 用户需要将以下依赖项添加到其 pom.xml 中： 

<dependency>
    <groupId>org.apache.camel</groupId>
    <artifactId>camel-hl7</artifactId>
    <version>{CamelSBVersion}</version>
    <!-- use the same version as your Camel core version -->
</dependency>
Copy to Clipboard Toggle word wrap

58.1. HL7 MLLP 协议
复制链接

HL7 通常用于 HL7 MLLP 协议，后者是基于 TCP 套接字的协议。此组件随附了符合 MLLP 协议的 Mina 和 Netty Codec，因此您可以轻松地公开 HL7 侦听器通过 TCP 传输层接受 HL7 请求。要公开 HL7 侦听器服务，camel-mina 或 link:camel-netty 组件用于 HL7MLLPCodec (mina)或 HL7MLLPNettyDecoder/HL7MLLPNettyEncoder (Netty)。

可以按照如下所示配置 HL7 MLLP codec：

Expand
Name默认值描述

startByte

0x0b

跨越 HL7 有效负载的初级字节。

endByte1

0x1c

跨越 HL7 有效负载的第一个最终字节。

endByte2

0x0d

跨越 HL7 有效负载的第二代最终字节。

charset

JVM 默认

用于 codec 的编码(a charset name)。如果没有提供，Camel 将使用 JVM 默认 Charset。

produceString

true

如果为 true，则 codec 使用定义的 charset 创建一个字符串。如果为 false，则 codec 会向路由发送一个纯文本数组，以便 HL7 Data Format 可以决定来自 HL7 消息内容的实际 charset。

convertLFtoCR

false

将 \n 转换为 \r (0x0d, 13 十进制)，作为网段术语器。HAPI 库需要使用 \r。

58.1.1. 使用 Mina 公开 HL7 侦听器
复制链接

在 Spring XML 文件中，我们将一个 mina 端点配置为使用 TCP 在端口 8888 上侦听 HL7 请求： 

<endpoint id="hl7MinaListener" uri="mina:tcp://localhost:8888?sync=true&amp;codec=#hl7codec"/>
Copy to Clipboard Toggle word wrap

sync=true 表示此侦听器是同步的，因此会向调用者返回 HL7 响应。HL7 codec 使用 codec=#hl7codec 设置。请注意，hl7codec 只是 Spring bean ID，因此它可以命名为 mygreatcodecforhl7 或任何内容。codec 还在 Spring XML 文件中设置： 

<bean id="hl7codec" class="org.apache.camel.component.hl7.HL7MLLPCodec">
    <property name="charset" value="iso-8859-1"/>
</bean>
Copy to Clipboard Toggle word wrap

然后，端点 hl7MinaLlistener 可以在作为消费者的路由中使用，因为此 Java DSL 示例： 

from("hl7MinaListener")
  .bean("patientLookupService");
Copy to Clipboard Toggle word wrap

这是一个非常简单的路由，将侦听 HL7，并将它路由到名为 patient LookupService 的服务。这也 Spring Bean ID 在 Spring XML 中配置，如下所示： 

<bean id="patientLookupService" class="com.mycompany.healthcare.service.PatientLookupService"/>
Copy to Clipboard Toggle word wrap

业务逻辑可以在 POJO 类中实施，该类不依赖于 Camel，如下所示： 

import ca.uhn.hl7v2.HL7Exception;
import ca.uhn.hl7v2.model.Message;
import ca.uhn.hl7v2.model.v24.segment.QRD;

public class PatientLookupService {
    public Message lookupPatient(Message input) throws HL7Exception {
        QRD qrd = (QRD)input.get("QRD");
        String patientId = qrd.getWhoSubjectFilter(0).getIDNumber().getValue();

        // find patient data based on the patient id and create a HL7 model object with the response
        Message response = ... create and set response data
        return response
    }
Copy to Clipboard Toggle word wrap

在 Spring XML 文件中，我们将一个 netty 端点配置为使用 TCP 在端口 8888 上侦听 HL7 请求： 

<endpoint id="hl7NettyListener" uri="netty:tcp://localhost:8888?sync=true&amp;encoders=#hl7encoder&amp;decoders=#hl7decoder"/>
Copy to Clipboard Toggle word wrap

sync=true 表示此侦听器是同步的，因此会向调用者返回 HL7 响应。HL7 codec 使用 encoders=#hl7encoder*and*decoders=#hl7decoder 设置。请注意，hl7encoder 和 hl7decoder 只是 bean ID，因此它们可以不同的命名。Bean 可在 Spring XML 文件中设置： 

<bean id="hl7decoder" class="org.apache.camel.component.hl7.HL7MLLPNettyDecoderFactory"/>
<bean id="hl7encoder" class="org.apache.camel.component.hl7.HL7MLLPNettyEncoderFactory"/>
Copy to Clipboard Toggle word wrap

然后，端点 hl7NettyListener 可以在作为消费者的路由中使用，因为此 Java DSL 示例： 

from("hl7NettyListener")
  .bean("patientLookupService");
Copy to Clipboard Toggle word wrap
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务，以及可以信赖的内容，帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情，请参阅红帽博客.

關於紅帽

我们提供强化的解决方案，使企业能够更轻松地跨平台和环境（从核心数据中心到网络边缘）工作。

Theme

© 2025 Red Hat