第 379 章 XStream DataFormat
从 Camel 版本 1.3 开始提供
Xstream 是一个 Data Format，它使用 XStream 库 来聚合和来自 XML 的 Java 对象。
要在 camel 路由中使用 XStream，您需要添加对实现此数据格式的 camel-xstream 的依赖关系。
Maven 用户需要将以下依赖项添加到这个组件的 pom.xml 中：
<dependency> <groupId>org.apache.camel</groupId> <artifactId>camel-xstream</artifactId> <version>x.x.x</version> <!-- use the same version as your Camel core version --> </dependency>
379.1. 选项
XStream dataformat 支持 10 个选项，如下所列。
| Name | 默认值 | Java 类型 | 描述 |
|---|---|---|---|
| 权限 |
| 添加控制在 unmarshal from xml/json 到 Java Bean 期间允许使用哪些 Java 软件包和类 XStream 的权限。必须在此处或全局使用 JVM 系统属性配置权限。权限可以使用加号允许的语法指定，减号是 deny。使用 . 作为前缀来支持通配符。例如，允许 com.foo 和所有子软件包，然后 specfy com.foo.。可以用逗号分隔多个权限，如 com.foo.,-com.foo.bar.MySecretBean。以下默认权限始终被包括： -,java.lang.,java.util.，除非其使用键 org.apache.camel.xstream.permissions 指定 JVM 系统属性来覆盖它。 | |
| 编码 |
| 设置要使用的编码 | |
| driver |
| 使用自定义 XStream 驱动程序。实例必须是 com. althoughtworks.xstream.io.HierarchicalStreamDriver 的类型 | |
| driverRef |
| 在 registry 中引用要查询的自定义 XStream 驱动程序。实例必须是 com. althoughtworks.xstream.io.HierarchicalStreamDriver 的类型 | |
| 模式 |
| 处理重复引用的模式有：NO_REFERENCES ID_REFERENCES XPATH_REFERENCES XPATH_REFERENCES XPATH_ABSLUTE_REFERENCES SINGLE_NODE_XPATH_RELATIVE_REFERENCES SINGLE_NODE_XPATH_REFOLUTE_REFERENCES SINGLE_REFERENCES SINGLE_REFERENCES SINGINGLE_REFERENCES SINGLE_REFERENCES XPATH_REFERENCES SINGLE_REFERENCES XPATH_REFERENCES XPATH_REFERENCES XPATH_REFERENCES XPATH_REFERENCES XPATH | |
| 转换器 |
| 使用自定义 XStream 转换器的类名称列表。类必须是 com. althoughtworks.xstream.converters.Converter | |
| 别名 |
| 将类别名为在 XML 元素中使用的短名称。 | |
| omitFields |
| 防止字段被序列化。若要省略一个字段，您必须始终提供声明类型，而不一定是转换的类型。 | |
| implicitCollections |
| 添加用于任何未映射 XML 标签的默认隐式集合。 | |
| contentTypeHeader |
|
| 如果数据格式可以这样做，则数据格式是否应使用 data 格式的类型设置 Content-Type 标头。例如，用于数据格式的 application/xml 放入 XML 或用于数据格式的 application/json，如 JSon 等。 |
