第 61 章 SOAP
SOAP 是一个数据格式,使用 JAXB2 和 JAX-WS 注释来组合和联合 SOAP 有效负载。它提供了 Apache CXF 的基本功能,无需 CXF 堆栈。
命名空间前缀映射
如需有关如何使用 SOAP 数据格式时控制命名空间前缀映射的详细信息,请参阅 JAXB。
61.1. SOAP 选项
SOAP 数据格式支持 6 选项,如下所示。
Name | 默认 | Java 类型 | 描述 |
---|---|---|---|
contextPath |
| 您的 JAXB 类所在的必要软件包名称。 | |
encoding |
| 要超额规则并使用特定的编码。 | |
elementNameStrategyRef |
| 指的是从 registry 查找的元素策略。元素名称策略用于两个目的。第一种方法是查找给定对象的 xml 元素名称,并在将对象放入 SOAP 消息时采取 soap 操作。第二个是查找给定 soap 错误名称的 Exception 类。以下三个元素策略类名称是开箱即用的。QNameStrategy - 使用在实例化时配置的固定 qName。不支持 TypeNameStrategy 时出现异常查找 - 使用给定类型的 XMLType 注解中的名称和命名空间。如果没有设置 namespace,则使用 package-info。异常查找不支持 ServiceInterfaceStrategy - 使用 webservice 接口中的信息来确定类型名称,并为 SOAP 错误或类似工具找到异常类。这个类位于软件包名称 org.apache.camel.dataformat. makingp.name。如果您已使用 cxf-codegen 或类似工具生成了 web 服务 stub 代码,那么您可能想使用 ServiceInterface.apache.camel.dataformat.rhnp.name。如果没有注解的服务接口,您应该使用 QNameStrategy 或 TypeNameStrategy。 | |
version |
| SOAP 版本应为 1.1 或 1.2。默认为 1.1。 | |
namespacePrefixRef |
| 使用 JAXB 或 SOAP 总结时,JAXB 实施将自动分配命名空间前缀,如 ns2、ns3、ns4 等。要控制此映射,Camel 允许您引用包含所需映射的映射。 | |
schema |
| 对现有架构进行验证。您可以使用前缀 classpath:、file: 或 http: 指定资源通过解析的方式。您可以使用 ',' 字符分隔多个 schema 文件。 |