129.5. 端点选项
Spring WebService 端点使用 URI 语法进行配置:
spring-ws:type:lookupKey:webServiceEndpointUri
以下是 path 和 query 参数:
129.5.1. 路径参数(4 参数)
Name | 描述 | 默认值 | 类型 |
---|---|---|---|
type (consumer) | 如果使用了端点映射,端点映射类型。使用 rootqname - 提供根据消息中包含的根元素的合格名称映射 Web 服务请求的选项。soapaction - 用于根据消息标头中指定的 SOAP 操作来映射 Web 服务请求。uri - 为映射以特定 URI. xpathresult - 用于根据针对传入邮件的 XPath 表达式评估的 Web 服务请求来映射 Web 服务请求。评估的结果应匹配端点 URI. beanname 中指定的 XPath 结果 - 允许您引用 org.apache.camel.component.spring.ws.bean.CamelEndpointDispatcher 对象,以便与 PayloadRootQNameEndpointMapping, SoapActionEndpointMapping 等现有(传统)端点映射集成。 Enum 值:
| EndpointMappingType | |
lookupKey (consumer) | 如果使用端点映射,端点映射密钥。 | 字符串 | |
webServiceEndpointUri (producer) | 用于制作者的默认 Web Service 端点 uri。 | 字符串 | |
expression (consumer) | 用于 when 选项 type=xpathresult 的 XPath 表达式。然后需要配置这个选项。 | 字符串 |
129.5.2. 查询参数(21 参数)
Name | 描述 | 默认值 | 类型 |
---|---|---|---|
messageFilter (common) | 提供自定义 MessageFilter 的选项。例如,当您要自行处理标头或附加时。 | MessageFilter | |
messageIdStrategy (common) | 提供自定义 MessageIdStrategy 来控制 WS-Addressing 唯一消息 ids 的生成选项。 | MessageIdStrategy | |
endpointDispatcher (consumer) | Spring org.springframework.ws.server.endpoint.MessageEndpoint 将 Spring-WS 收到的消息分配给 Camel 端点,以与现有(传统)端点映射集成,如 PayloadRootQNameEndpointMapping, SoapActionEndpointMapping 等。 | CamelEndpointDispatcher | |
endpointMapping (consumer) | 引用 Registry/ApplicationContext 中的 org.apache.camel.component.spring.ws.bean.CamelEndpointMapping 实例。registry 中只需要一个 bean 来提供所有 Camel/Spring-WS 端点。这个 bean 由 MessageDispatcher 自动发现,用于根据端点上指定的特征(如 root QName、SOAP 操作等)将请求映射到 Camel 端点。 | CamelSpringWSEndpointMapping | |
bridgeErrorHandler (consumer (advanced)) | 允许将消费者桥接到 Camel 路由错误处理程序,这意味着当消费者试图选择传入消息或类似信息时发生异常,现在将作为消息处理并由路由 Error Handler 处理。默认情况下,使用者将使用 org.apache.camel.spi.ExceptionHandler 来处理例外情况,该处理程序将被记录在 WARN 或 ERROR 级别,并忽略。 | false | 布尔值 |
exceptionHandler (consumer (advanced)) | 要让使用者使用自定义例外处理程序:请注意,如果启用了 bridgeErrorHandler 选项,则此选项不使用。默认情况下,消费者将处理异常,其记录在 WARN 或 ERROR 级别中,并忽略。 | ExceptionHandler | |
exchangePattern (consumer (advanced)) | 在消费者创建交换时设置交换模式。 Enum 值:
| ExchangePattern | |
allowResponseAttachmentOverride (producer) | 通过来自实际服务层的附件覆盖跨外交换中的 soap 响应附件的选项。如果调用的服务在设为 true 时附加或重写 soap 附加,则允许在/out 消息附加中覆盖修改后的 soap attachments。 | false | 布尔值 |
allowResponseHeaderOverride (producer) | 使用来自实际服务层的标头信息覆盖/出站交换中的 soap 响应标头的选项。如果调用的服务在设为 true 时附加或重写 soap 标头,则允许在/out 消息标头中覆盖修改后的 soap 标头。 | false | 布尔值 |
faultAction (producer) | 表示由方法提供的 faultAction 响应 WS-Addressing Fault Action 标头的值。如需了解更多详细信息,请参阅 org.springframework.ws.soap.addressing.server.annotation.Action 注解。 | URI | |
faultTo (producer) | 表示由方法提供的 faultAction 响应 WS-Addressing FaultTo 标头的值。如需了解更多详细信息,请参阅 org.springframework.ws.soap.addressing.server.annotation.Action 注解。 | URI | |
messageFactory (producer) | 提供自定义 WebServiceMessageFactory 的选项。例如,当您希望 Apache Axiom 处理 Web 服务消息而不是 SAAJ 时。 | WebServiceMessageFactory | |
messageSender (producer) | 提供自定义 WebServiceMessageSender 的选项。例如,执行身份验证或使用替代传输。 | WebServiceMessageSender | |
outputAction (producer) | 表示由方法提供的响应 WS-Addressing Action 标头的值。如需了解更多详细信息,请参阅 org.springframework.ws.soap.addressing.server.annotation.Action 注解。 | URI | |
replyTo (producer) | 表示由方法提供的 replyTo 响应 WS-Addressing ReplyTo 标头的值。如需了解更多详细信息,请参阅 org.springframework.ws.soap.addressing.server.annotation.Action 注解。 | URI | |
SOAPAction (producer) | 在访问远程 Web 服务时,SOAP 操作要包含在 SOAP 请求中。 | 字符串 | |
timeout (producer) | 在使用制作者调用 webservice 时设置套接字读取超时(以毫秒为单位),请参阅 URLConnection.setReadTimeout ()和 CommonsHttpMessageSender.setReadTimeout ()。此选项在使用内置消息发送器实现时工作: CommonsHttpMessageSender 和 HttpUrlConnectionMessageSender。除非自定义提供给组件的 Spring WS 配置选项,否则这些实现默认将用于基于 HTTP 的服务。如果您使用非标准发件人,则假设您将处理自己的超时配置。内置的消息发送者 HttpComponentsMessageSender 被认为是 CommonsHttpMessageSender,它已被弃用,请参阅 HttpComponentsMessageSender.setReadTimeout ()。 | int | |
webServiceTemplate (producer) | 提供自定义 WebServiceTemplate 的选项。这允许对客户端 Web 服务处理进行完全控制;例如添加自定义拦截器或指定故障解析器、邮件发送者或消息工厂。 | WebServiceTemplate | |
wsAddressingAction (producer) | 在访问 Web 服务时包含 WS-Addressing 1.0 操作标头。To 标头设置为端点 URI (默认 Spring-WS 行为)中指定的 Web 服务的地址。 | URI | |
lazyStartProducer (producer (advanced)) | 生成者是否应懒惰启动 (在第一个消息中)。通过懒惰启动,您可以使用此选项来允许 CamelContext 和路由在生成者启动期间启动,并导致路由启动失败。通过懒惰启动,启动失败可以在路由信息时通过 Camel 的路由错误处理程序进行处理。请注意,在处理第一个消息时,创建并启动生成者可能需要稍等时间,并延长处理的总处理时间。 | false | 布尔值 |
sslContextParameters (security) | 使用 SSLContextParameters 配置安全性。 | SSLContextParameters |