rivethealth/mllp-http

MLLP/HTTP

概述

实现MLLP与HTTP协议之间的双向转换。

http2mllp是一个HTTP服务器，可将HTTP请求转换为MLLP消息，并将MLLP消息转换为HTTP响应。

mllp2http是一个MLLP服务器，可将MLLP消息转换为HTTP请求，并将HTTP响应转换为MLLP消息。

关键词：MLLP、HTTP、HL7、HL7 over HTTP

描述

MLLP（最小低层协议）是HL7消息的传统会话协议。

许多现代工具（负载均衡器、应用框架、API监控）都是围绕HTTP设计的。这一观察是https://hapifhir.github.io/hapi-hl7v2/hapi-hl7overhttp/specification.html%E8%A7%84%E8%8C%83%E7%9A%84%E5%9F%BA%E7%A1%80%E3%80%82

本项目MLLP/HTTP架起了这两种协议之间的桥梁，使网络工程师和应用开发人员能够使用熟悉的HTTP技术与基于MLLP的程序进行交互。

实现了MLLP release 1和HTTP/1.1。每个MLLP消息都假定有相应的响应内容（例如HL7确认）。

请注意，本项目仅处理MLLP层；它不处理HL7消息本身。HTTP参与方必须能够解释HL7消息并生成确认。这种分离是有益的，因为它使应用开发人员能够完全访问HL7协议的功能。

安装

Pip

sh
pip install mllp-http

运行方式：

sh
http2mllp mllp://localhost:2575

mllp2http http://localhost:8000

https://hub.docker.com/r/rivethealth/mllp-http

sh
docker pull rivethealth/mllp-http

运行方式：

sh
docker run -it -p 2575:2575 rivethealth/mllp-http http2mllp mllp://localhost:2575

docker run -it -p 2575:2575 rivethealth/mllp-http mllp2http http://localhost:8000

使用方法

http2mllp

usage: http2mllp [-h] [-H HOST] [-p PORT] [--keep-alive KEEP_ALIVE] [--log-level {error,warn,info}] [--mllp-max-messages MLLP_MAX_MESSAGES] [--mllp-release {1}]
                 [--timeout TIMEOUT] [-v]
                 mllp_url

            HTTP服务器，代理MLLP服务器。
            期望MLLP响应消息，并将其用作HTTP响应。


位置参数:
  mllp_url              MLLP URL，例如 mllp://hostname:port

可选参数:
  -h, --help            显示此帮助消息并退出
  -H HOST, --host HOST  HTTP主机（默认：0.0.0.0）
  -p PORT, --port PORT  HTTP端口（默认：8000）
  --keep-alive KEEP_ALIVE
                        保持连接时间（毫秒），-1表示无限制（默认：0）
  --log-level {error,warn,info}
                        日志级别
  --mllp-max-messages MLLP_MAX_MESSAGES
                        每个连接的最大消息数，-1表示无限制（默认：-1）
  --mllp-release {1}    MLLP版本（默认：1）
  --timeout TIMEOUT     套接字超时（毫秒），0表示无限制（默认：10000）
  -v, --version         显示程序版本号并退出

mllp2http

usage: mllp2http [-h] [-H HOST] [-p PORT] [--content-type CONTENT_TYPE] [--log-level {error,warn,info}] [--mllp-release {1}]
                 [--timeout TIMEOUT] [-v]
                 http_url

MLLP服务器，代理HTTP服务器。返回HTTP响应。

位置参数:
  http_url              HTTP URL

可选参数:
  -h, --help            显示此帮助消息并退出
  -H HOST, --host HOST  MLLP主机（默认：0.0.0.0）
  -p PORT, --port PORT  MLLP端口（默认：2575）
  --content-type CONTENT_TYPE
                        HTTP Content-Type头（默认：x-application/hl7-v2+er7）
  --log-level {error,warn,info}
                        日志级别
  --mllp-release {1}    MLLP版本（默认：1）
  --timeout TIMEOUT     超时时间（毫秒）（默认：10000）
  -v, --version         显示程序版本号并退出

环境变量:
    HTTP_AUTHORIZATION - HTTP Authorization头

示例

mllp2http

运行HTTP调试服务器：

sh
docker run -p 8000:80 kennethreitz/httpbin

运行MLLP连接器：

sh
mllp2http http://localhost:8000/post

发送MLLP消息：

sh
printf '\x0bMESSAGE\x1c\x0d' | socat - TCP:localhost:2575

查看HTTP服务器的响应（描述连接器发出的HTTP请求）：

json
{
  "args": {},
  "data": "MESSAGE",
  "files": {},
  "form": {},
  "headers": {
    "Accept": "*/*",
    "Accept-Encoding": "gzip, deflate",
    "Connection": "keep-alive",
    "Content-Length": "7",
    "Content-Type": "x-application/hl7-v2+er7",
    "Forwarded": "by=127.0.0.1:2575;for=127.0.0.1:54572;proto=mllp",
    "Host": "localhost:8000",
    "User-Agent": "mllp2http/1.0.2"
  },
  "json": null,
  "origin": "127.0.0.1:54572",
  "url": "mllp://localhost:8000/post"
}

开发

安装：

sh
make install

提交前格式化：

sh
make format