HL7 v2消息映射为XML必须严格遵循XML_Encoding_Rules_for_HL7_v2_Messages.pdf的语义结构规则，使用HL72XMLConverter.jar批量转换时需确保hl7v2xml.dat同目录、输入文件无BOM且换行符统一；JavaScript实时转换须动态提取MSH-1分隔符并正确处理子组件与转义；XSLT因缺乏语义感知易失败，院内扩展字段须提前在映射资源中显式声明。
HL7 v2 消息映射成 XML 不是简单字符串替换，而是按标准语义结构化展开——必须严格遵循 XML_Encoding_Rules_for_HL7_v2_Messages.pdf 定义的段（Segment）、字段（Field）、子组件（Component）层级与命名规则，否则下游系统无法解析。
用 HL72XMLConverter.jar 命令行快速转换（最轻量实操路径）
开源工具包中的 Java 可执行包已封装好核心逻辑，适合批量处理或 CI/CD 集成。关键不是“能不能跑”，而是参数和输入格式是否合规：
-
hl7v2xml.dat必须与HL72XMLConverter.jar在同一目录，否则报FileNotFoundException——它不是可选配置，而是内含 HL7 v2.3/v2.5 字段定义的映射资源 - 输入 HL7 文件必须以
\r或\n行结束（Windows/Linux 换行需统一），且首行不能有 BOM；否则解析器会把 MSH 段第一字段识别为乱码，导致MSH-1（字段分隔符）错位 - 执行命令示例：
java -jar HL72XMLConverter.jar 001.hl7 output.xml
输出的output.xml默认不带 DTD 声明，如需校验，得手动合并附带的hl7v23.dtd
JavaScript Transformer 中手写 HL7→XML 映射（Mirth Connect / Rhapsody 场景）
在信道级做实时转换时，不能依赖外部 jar，需在 Destination Transformer 写 JS 脚本。难点在于分隔符嵌套和空字段处理：
java-api-doc-generator
下载
分析 Java Spring Boot 后端 Controller 代码，自动生成 Markdown 格式的接口文档。当用户说“生成 Java 接口文档”、“生成 API 文档”、“从 Spring 代码生成文档”时触发。
- HL7 字段分隔符（
|）、组件分隔符（^）、重复分隔符（~）必须从MSH-1动态提取，硬编码|会导致 v2.6+ 消息解析失败 - PID-5（患者姓名）可能为
DOE^JOHN^^MR，对应 XML 应生成<family>DOE</family><given>JOHN</given><suffix>MR</suffix>，而非扁平拼接；空子组件（如中间的^^）需保留对应 XML 元素（内容为空） - 常见错误：直接用
split('|')后再对每个字段split('^')，会破坏转义字符（如\F\表示字段分隔符字面量），正确做法是用 HL7-aware 解析器（如 hapi 的GenericParser）或正则预处理转义
为什么不用 XSLT 直接转换？（兼容性陷阱）
有人尝试把 HL7 当纯文本用 XSLT 处理，结果在真实医院消息中频繁失败——因为 HL7 v2 不是规范 XML，其“结构”依赖上下文：
- 同一字段在不同段含义不同：PID-3 是患者标识，PV1-3 是就诊编号，但都叫 “ID”；XSLT 无法自动绑定语义，必须人工写
<when test="name()='PID' and position()=3"></when>类规则，维护成本爆炸 - 重复段（如 OBX 多次出现）需按序号生成
<obx_1>...</obx_1><obx_2>...</obx_2>，而标准 XSLT 无原生序号感知，得靠position()+ 外层循环，极易漏掉嵌套重复（如 NTE 在 OBX 下） - 实际项目中，90% 的“XSLT 方案”最终退化为先用 Java/hapi 转成中间 XML，再用 XSLT 做二次整形——不如一步到位用成熟解析器
真正卡住进度的往往不是技术选型，而是 HL7 消息里那些没写进文档的“院内扩展字段”：比如某三甲医院在 PID-18 加了医保电子凭证号，但未注册到 HL7 注册表。这种字段一进标准转换器就会被丢弃或塞进 <unknown></unknown>，必须提前在 hl7v2xml.dat 或 JS 映射逻辑里显式声明——没人告诉你，但系统上线那天它一定出问题。
