JBoss Fuse中的XML数据格式转换

10次阅读

XSLT路径需按类路径写,如xsl/transform.xsl;传参须用setHeader设CamelXsltParameters为map,不可用simple直接赋值。

JBoss Fuse中的XML数据格式转换

Camel中用 xslt 转换 xml 时路径不生效?

JBoss Fuse(基于 apache Camel)里最常用的 XML 转换方式是 xslt 组件,但很多人卡在 XSLT 文件找不到或参数传不进去。根本原因通常是类路径解析逻辑和 Fuse 的 OSGi 类加载机制冲突。

  • xslt 默认从 classpath 加载 XSLT,不是文件系统路径 —— 写成 file:/opt/fuse/xsl/transform.xsl 会静默失败
  • 若 XSLT 放在 src/main/resources 下,直接写 xslt:transform.xsl 即可;放在子目录(如 resources/xsl/),必须写全路径 xslt:xsl/transform.xsl
  • 需要传参数给 XSLT?用 setHeader 设置 CamelXsltParameters,值为 Map,不能直接用 simple 表达式塞进 header
           #{'map:{"inputId": "${header.id}", "env": "prod"}}       

jaxb 反序列化后再改字段,比 XSLT 更可控?

当 XML 结构固定、转换逻辑偏业务逻辑(比如把 A 映射成 ACTIVE),硬写 XSLT 容易漏节点或难调试。这时用 jaxb 先转 java 对象,再用普通代码处理,更利于单元测试和维护。

  • 确保 JAXB context 能扫描到你的 POJO 类:Fuse 默认不自动注册,需显式配置 JaxbDataFormat 并传入 Class[]
  • POJO 字段名与 XML 元素名不一致?加 @XmlElement(name = "user-name") 注解,别依赖默认映射
  • 避免在 route 中反复 new JaxbDataFormat —— 它不是线程安全的,应作为 bean 声明在 spring XML 或 Blueprint 中

validate + xslt 连用时,XML 校验失败后没走 Error handler?

很多人想先校验 XML 是否符合 XSD,再做转换,结果 validate 报错后 route 直接中断,onException 不触发。这是因为 validate 抛的是 ValidationException,而默认 error handler 捕获的是 Exception 或其子类,但部分老版本 Camel 的 ValidationException 并未继承 RuntimeException

  • 显式在 onException 中声明捕获 org.apache.camel.ValidationException
  • 不要把 validatexslt 放在同一 route 的同一行 —— 分开成两个独立处理步骤,便于定位失败环节
  • XSD 文件路径同样受 classpath 限制;若引用了外部命名空间(如 xs:import Namespace="http://example.com/ns"),需确保该命名空间对应 XSD 也在 classpath 中且被正确注册

Fuse 6.3+ 中 smooks 插件已弃用,替代方案是什么?

早期 Fuse 项目常用 smooks 做复杂 XML/CSV/Java 对象混合转换,但自 Fuse 6.3 起,smooks-camel 不再预装,且与较新版本 Smooks(v1.7+)存在 OSGi 包冲突。强行安装容易引发 ClassNotFoundExceptionInvalidBundleException

  • 轻量场景:用 xslt + 自定义 function(通过 net.sf.saxon.TransformerFactoryImpl 注册扩展函数)补足逻辑缺失
  • 结构复杂、需多源数据聚合:改用 camel-jacksonxml 先转 json,再用 jsonpath + simple 处理,最后用 jacksonxml 回写 XML
  • 绝对避免在生产环境手动 drop smooks jar 到 deploy/ —— OSGi bundle 生命周期管理会失控,重启后可能不激活

真正麻烦的从来不是语法怎么写,而是 XSLT 里的命名空间前缀是否和输入 XML 一致、JAXB 的 @XmlRootElement 是否漏标、还有那些没报错但默默跳过校验的 validate 配置。

text=ZqhQzanResources