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

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 结构固定、转换逻辑偏业务逻辑(比如把 映射成 ),硬写 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 - 不要把
validate和xslt放在同一 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 包冲突。强行安装容易引发 ClassNotFoundException 或 InvalidBundleException。
- 轻量场景:用
xslt+ 自定义function(通过net.sf.saxon.TransformerFactoryImpl注册扩展函数)补足逻辑缺失 - 结构复杂、需多源数据聚合:改用
camel-jacksonxml先转 json,再用jsonpath+simple处理,最后用jacksonxml回写 XML - 绝对避免在生产环境手动 drop
smooksjar 到deploy/—— OSGi bundle 生命周期管理会失控,重启后可能不激活
真正麻烦的从来不是语法怎么写,而是 XSLT 里的命名空间前缀是否和输入 XML 一致、JAXB 的 @XmlRootElement 是否漏标、还有那些没报错但默默跳过校验的 validate 配置。