Camel中XML与Java对象转换首选camel-jaxb组件，需复用JAXBContext、正确配置命名空间与空元素处理；定制输出格式须通过JaxbDataFormat.Configuration；复杂XML推荐camel-jacksonxml替代。
Camel中用camel-jaxb处理XML转Java对象
XML到Java对象的转换在Camel里最常用的是camel-jaxb组件，它底层依赖JAXB 2.x，适合结构稳定、有XSD或已知POJO类的场景。不推荐直接用camel-xstream（已弃用）或手动解析DocumentBuilder——既绕过Camel的类型路由能力，又难统一异常处理。
关键点是：JAXBContext必须复用，不能每次路由都新建；否则会严重拖慢吞吐量，尤其高并发时CPU和GC压力明显上升。
- 确保你的POJO类标注了
@XmlRootElement或通过JaxbDataFormat显式指定contextPath - 若XML含命名空间，POJO需用
@XmlSchema声明namespace，且JaxbDataFormat要设ignoreNamespace = false - 空元素（如
<price></price>）默认映射为null，若需转成0或空字符串，得在POJO字段加@XmlElement(nillable = true)并配合自定义XmlAdapter
from("file:input?noop=true")
.unmarshal(new JaxbDataFormat("com.example.invoice"))
.process(exchange -> {
Invoice invoice = exchange.getIn().getBody(Invoice.class);
// 处理逻辑
});
Java对象转XML时控制格式与编码
默认生成的XML无缩进、无声明头、编码固定为UTF-8。生产环境常需定制：比如对接老系统要求encoding="GBK"，或日志调试需要可读缩进。
JaxbDataFormat本身不暴露Marshaller配置入口，得用setConfiguration传入JaxbDataFormat.Configuration实例。
- 缩进需同时设
marshaller.setProperty(Marshaller.JAXB_FORMATTED_OUTPUT, true)和marshaller.setProperty(Marshaller.JAXB_ENCODING, "UTF-8") - 若强制GBK输出，除了设
JAXB_ENCODING，还必须在to("file:output?charset=GBK")里显式声明charset参数，否则文件内容仍是UTF-8字节 - 避免在
marshal()后接convertBodyTo(String.class)再处理——这会触发两次序列化，中间XML可能被意外转义
JaxbDataFormat jaxb = new JaxbDataFormat("com.example.invoice");
jaxb.setConfiguration(new JaxbDataFormat.Configuration() {{
setEncoding("GBK");
setFormattedOutput(true);
}});
from("direct:invoice")
.marshal(jaxb)
.to("file:output?charset=GBK");
遇到javax.xml.bind.UnmarshalException: unexpected element
这是最典型的JAXB反序列化失败，根本原因几乎都是XML根元素名与预期不符。常见于：SOAP响应带soap:Envelope外壳、REST API返回<response><data>...</data></response>嵌套、或命名空间URI拼写差一个字符。
通过Apache Tika Server REST API从1400多种文件格式中提取文本和元数据。处理PDF、DOCX、PPTX、电子邮件归档以及带有MIME类型检测的嵌入式文档提取。
不要急着改POJO——先用log拦截原始XML，确认实际结构。Camel的streamCaching必须开启，否则log后unmarshal会报Stream closed。
- 若只是外层包装，用
removeHeaders("Camel*")+setBody(simple("${body.replaceAll('^.+<data>','').replaceAll('</data>.+$','')}"))临时剥离（仅调试用） - 若含SOAP外壳，优先用
camel-cxf替代裸JAXB；若必须用JAXB，需在contextPath中包含soap包，并让POJO继承org.apache.cxf.binding.soap.SoapMessage - 命名空间问题最隐蔽：检查
xmlns值是否含尾部斜杠（http://example.com/vshttp://example.com），JAXB认作不同命名空间
复杂XML（混合内容、任意子元素）怎么处理
当XML含<p>Hello <b>world</b>!</p>这类混合内容，或子元素顺序不定、个数不固定（如<item></item>列表长度动态），JAXB原生支持弱。硬套@XmlMixed + List<object></object>会导致类型丢失，后续无法做字段级校验或转换。
此时应切换策略：用camel-dom或camel-jacksonxml替代JAXB。后者基于Jackson，对任意结构容忍度高，且能无缝接入ValidationProcessor做JSON Schema式校验。
-
camel-jacksonxml需额外引入jackson-dataformat-xml，且XmlMapper必须禁用FAIL_ON_UNKNOWN_PROPERTIES - 混合内容会被转成
Map<string object></string>或JsonNode，用simple("${body.path('p.b.text()')}")提取文本更灵活 - 性能比JAXB低15–20%，但开发效率和容错性提升显著，适合非高频核心链路
命名空间、混合内容、编码细节——这三个地方出问题时，错误日志往往不指向真实根源。多打一行log看原始XML，比翻十页文档更快。
