第 166 章 JacksonXML DataFormat
作为 Camel 版本 2.16 可用
jackson XML 是一个数据格式,它使用带有 XMLMapper 扩展的 Jackson 库 ,将 XML 有效负载分到 Java 对象或将 marshal Java 对象编入 XML 有效负载中。
INFO:如果您熟悉 Jackson,此 XML 数据格式的行为与其 JSON 计数器部分相同,因此可用于 JSON 序列化/反序列化的类。
此扩展还模仿 JAXB 的"代码优先"方法。
这个数据格式依赖于 Woodstox (特别是对于用户印刷等功能),这是一个快速高效的 XML 处理器。
from("activemq:My.Queue"). unmarshal().jacksonxml(). to("mqseries:Another.Queue");
166.1. JacksonXML Options
JacksonXML 数据格式支持 15 选项,它们如下所列。
Name | 默认 | Java 类型 | 描述 |
---|---|---|---|
xmlMapper |
| 查找并使用带有给定 ID 的现有 XmlMapper。 | |
prettyPrint |
|
| 要让用户能够正常格式化打印输出。默认为 false。 |
unmarshalTypeName |
| 取消armshalling 时要使用的 java 类型的类名称 | |
jsonView |
| 当 marshalling a POJO 到 JSON 时,您可能想要从 JSON 输出中排除某些字段。通过 Jackson,您可以使用 JSON 视图来实现此目的。此选项引用包含 JsonView 注解的类 | |
Include |
| 如果您想将 pojo 提供给 JSON,并且 pojo 具有一些带有 null 值的字段。而且您要跳过这些 null 值,您可以将这个选项设置为 NON_NULL | |
allowJmsType |
|
| 用于 JMS 用户,以允许 JMS spec 中的 JMSType 标头指定一个 FQN 类名称,用于取消传递。 |
collectionTypeName |
| 指的是注册表中要使用的自定义集合类型。这个选项应该很少被使用,但允许使用不同于 java.util.Collection 的不同集合类型作为默认值。 | |
useList |
|
| 要取消与映射列表或 Pojo 列表相关的内容。 |
enableJaxbAnnotationModule |
|
| 使用 jackson 时是否启用 JAXB 注解模块。启用后,Jackson 可以使用 JAXB 注解。 |
moduleClassNames |
| 要使用自定义 Jackson 模块 com.fasterxml.jackson.databind.Module,指定为带有 FQN 类名称的 String。可以使用逗号分隔多个类。 | |
moduleRefs |
| 使用从 Camel 注册表引用的自定义 Jackson 模块。可以使用逗号分隔多个模块。 | |
enableFeatures |
| 在 Jackson com.fasterxml.jackson.databind.ObjectMapper 上启用的功能集。这个功能应当是与 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 或 com.fasterxml.jackson.jackson.jackson.databind.MapperFeature.jackson.databind. | |
disableFeatures |
| 在 Jackson com.fasterxml.jackson.databind.ObjectMapper 上禁用的功能集合。这个功能应当是与 com.fasterxml.jackson.databind.SerializationFeature, com.fasterxml.jackson.databind.DeserializationFeature 或 com.fasterxml.jackson.jackson.jackson.databind.MapperFeature.jackson.databind. | |
allowUnmarshallType |
|
| 如果启用,则允许 Jackson 在 unmarshalling 期间尝试使用 CamelJacksonUnmarshalType 标头。这只有在需要被使用时才启用。 |
contentTypeHeader |
|
| 如果数据格式能够这样做,则数据格式是否应该以 data 格式设置 Content-Type 标头。例如,用于数据格式的 application/xml (数据格式)或 application/json 用于数据格式 marshalling to JSon etc。 |