This is an automated email from the ASF dual-hosted git repository. davsclaus pushed a commit to branch main in repository https://gitbox.apache.org/repos/asf/camel.git
The following commit(s) were added to refs/heads/main by this push: new 7f11999cf91 Updated the documentation on Spring Webservice Component, remove Axiom reference because is no longer supported (#11419) 7f11999cf91 is described below commit 7f11999cf91a7fa145638f6b2faaff8713cdbd79 Author: richardgroote <32516488+richardgro...@users.noreply.github.com> AuthorDate: Sun Sep 17 11:54:26 2023 +0200 Updated the documentation on Spring Webservice Component, remove Axiom reference because is no longer supported (#11419) * Removed references to Axiom in Spring WS Component because that is no longer supported by Spring WS version 4.x and higher * Removed references to Axiom in Spring WS Component because that is no longer supported by Spring WS version 4.x and higher --------- Co-authored-by: r.groote <r.gro...@beinformed.com> --- .../apache/camel/catalog/components/spring-ws.json | 2 +- .../camel/component/spring/ws/spring-ws.json | 2 +- .../src/main/docs/spring-ws-component.adoc | 60 +--------------------- .../spring/ws/SpringWebserviceConfiguration.java | 3 +- 4 files changed, 5 insertions(+), 62 deletions(-) diff --git a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/spring-ws.json b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/spring-ws.json index 9f887ac5f05..6ce7e348962 100644 --- a/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/spring-ws.json +++ b/catalog/camel-catalog/src/generated/resources/org/apache/camel/catalog/components/spring-ws.json @@ -52,7 +52,7 @@ "allowResponseHeaderOverride": { "index": 12, "kind": "parameter", "displayName": "Allow Response Header Override", "group": "producer", "label": "producer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Option to override soap response header i [...] "faultAction": { "index": 13, "kind": "parameter", "displayName": "Fault Action", "group": "producer", "label": "producer", "required": false, "type": "string", "javaType": "java.net.URI", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Signifies the value for the faultAction response WS-Addressing Fault Action header that is pro [...] "faultTo": { "index": 14, "kind": "parameter", "displayName": "Fault To", "group": "producer", "label": "producer", "required": false, "type": "string", "javaType": "java.net.URI", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Signifies the value for the faultAction response WS-Addressing FaultTo header that is provided by the [...] - "messageFactory": { "index": 15, "kind": "parameter", "displayName": "Message Factory", "group": "producer", "label": "producer", "required": false, "type": "object", "javaType": "org.springframework.ws.WebServiceMessageFactory", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Option to provide a custom WebServiceMessageFactory. [...] + "messageFactory": { "index": 15, "kind": "parameter", "displayName": "Message Factory", "group": "producer", "label": "producer", "required": false, "type": "object", "javaType": "org.springframework.ws.WebServiceMessageFactory", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Option to provide a custom WebServiceMessageFactory." }, "messageSender": { "index": 16, "kind": "parameter", "displayName": "Message Sender", "group": "producer", "label": "producer", "required": false, "type": "object", "javaType": "org.springframework.ws.transport.WebServiceMessageSender", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Option to provide a custom WebServiceMessageSe [...] "outputAction": { "index": 17, "kind": "parameter", "displayName": "Output Action", "group": "producer", "label": "producer", "required": false, "type": "string", "javaType": "java.net.URI", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Signifies the value for the response WS-Addressing Action header that is provided by the met [...] "replyTo": { "index": 18, "kind": "parameter", "displayName": "Reply To", "group": "producer", "label": "producer", "required": false, "type": "string", "javaType": "java.net.URI", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Signifies the value for the replyTo response WS-Addressing ReplyTo header that is provided by the meth [...] diff --git a/components/camel-spring-ws/src/generated/resources/org/apache/camel/component/spring/ws/spring-ws.json b/components/camel-spring-ws/src/generated/resources/org/apache/camel/component/spring/ws/spring-ws.json index 9f887ac5f05..6ce7e348962 100644 --- a/components/camel-spring-ws/src/generated/resources/org/apache/camel/component/spring/ws/spring-ws.json +++ b/components/camel-spring-ws/src/generated/resources/org/apache/camel/component/spring/ws/spring-ws.json @@ -52,7 +52,7 @@ "allowResponseHeaderOverride": { "index": 12, "kind": "parameter", "displayName": "Allow Response Header Override", "group": "producer", "label": "producer", "required": false, "type": "boolean", "javaType": "boolean", "deprecated": false, "autowired": false, "secret": false, "defaultValue": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Option to override soap response header i [...] "faultAction": { "index": 13, "kind": "parameter", "displayName": "Fault Action", "group": "producer", "label": "producer", "required": false, "type": "string", "javaType": "java.net.URI", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Signifies the value for the faultAction response WS-Addressing Fault Action header that is pro [...] "faultTo": { "index": 14, "kind": "parameter", "displayName": "Fault To", "group": "producer", "label": "producer", "required": false, "type": "string", "javaType": "java.net.URI", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Signifies the value for the faultAction response WS-Addressing FaultTo header that is provided by the [...] - "messageFactory": { "index": 15, "kind": "parameter", "displayName": "Message Factory", "group": "producer", "label": "producer", "required": false, "type": "object", "javaType": "org.springframework.ws.WebServiceMessageFactory", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Option to provide a custom WebServiceMessageFactory. [...] + "messageFactory": { "index": 15, "kind": "parameter", "displayName": "Message Factory", "group": "producer", "label": "producer", "required": false, "type": "object", "javaType": "org.springframework.ws.WebServiceMessageFactory", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Option to provide a custom WebServiceMessageFactory." }, "messageSender": { "index": 16, "kind": "parameter", "displayName": "Message Sender", "group": "producer", "label": "producer", "required": false, "type": "object", "javaType": "org.springframework.ws.transport.WebServiceMessageSender", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Option to provide a custom WebServiceMessageSe [...] "outputAction": { "index": 17, "kind": "parameter", "displayName": "Output Action", "group": "producer", "label": "producer", "required": false, "type": "string", "javaType": "java.net.URI", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Signifies the value for the response WS-Addressing Action header that is provided by the met [...] "replyTo": { "index": 18, "kind": "parameter", "displayName": "Reply To", "group": "producer", "label": "producer", "required": false, "type": "string", "javaType": "java.net.URI", "deprecated": false, "autowired": false, "secret": false, "configurationClass": "org.apache.camel.component.spring.ws.SpringWebserviceConfiguration", "configurationField": "configuration", "description": "Signifies the value for the replyTo response WS-Addressing ReplyTo header that is provided by the meth [...] diff --git a/components/camel-spring-ws/src/main/docs/spring-ws-component.adoc b/components/camel-spring-ws/src/main/docs/spring-ws-component.adoc index 9c82b5ec89f..2e7465c4b12 100644 --- a/components/camel-spring-ws/src/main/docs/spring-ws-component.adoc +++ b/components/camel-spring-ws/src/main/docs/spring-ws-component.adoc @@ -34,6 +34,8 @@ for this component: </dependency> ------------------------------------------------------------ +*Be aware* Spring WS version 4.x does not support Axiom anymore (because Axiom does not support Jakarte JEE 9) + == URI format The URI scheme for this component is as follows @@ -205,64 +207,6 @@ Use the bead defined above in the camel endpoint ------------------------------------------------------------------ -== How to use MTOM attachments - -The BasicMessageFilter provides all required information for Apache -Axiom in order to produce MTOM message. If you want to use Apache Camel -Spring WS within Apache Axiom, here is an example: -- Simply define the messageFactory as is bellow and Spring-WS will use -MTOM strategy to populate your SOAP message with optimized attachments. - -[source,xml] ------------------------------------------------------------------- -<bean id="axiomMessageFactory" -class="org.springframework.ws.soap.axiom.AxiomSoapMessageFactory"> -<property name="payloadCaching" value="false" /> -<property name="attachmentCaching" value="true" /> -<property name="attachmentCacheThreshold" value="1024" /> -</bean> ------------------------------------------------------------------- - -- Add into your pom.xml the following dependencies - -[source,xml] ----------------------------------------------- -<dependency> -<groupId>org.apache.ws.commons.axiom</groupId> -<artifactId>axiom-api</artifactId> -<version>1.2.13</version> -</dependency> -<dependency> -<groupId>org.apache.ws.commons.axiom</groupId> -<artifactId>axiom-impl</artifactId> -<version>1.2.13</version> -<scope>runtime</scope> -</dependency> ----------------------------------------------- - -- Add your attachment into the pipeline, for example using a Processor -implementation. - -[source,java] ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- -private class Attachement implements Processor { -public void process(Exchange exchange) throws Exception -{ exchange.getOut().copyFrom(exchange.getIn()); File file = new File("testAttachment.txt"); exchange.getOut().addAttachment("test", new DataHandler(new FileDataSource(file))); } -} ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- - -- Define endpoint (producer) as ussual, for example like this: - -[source,java] ----------------------------------------------------------------------------------------------------------- -from("direct:send") -.process(new Attachement()) -.to("spring-ws:http://localhost:8089/mySoapService?soapAction=mySoap&messageFactory=axiomMessageFactory"); ----------------------------------------------------------------------------------------------------------- - -- Now, your producer will generate MTOM message with otpmized -attachments. - == The custom header and attachment filtering If you need to provide your custom processing of either headers or diff --git a/components/camel-spring-ws/src/main/java/org/apache/camel/component/spring/ws/SpringWebserviceConfiguration.java b/components/camel-spring-ws/src/main/java/org/apache/camel/component/spring/ws/SpringWebserviceConfiguration.java index 339d223868a..f1ab3bf7369 100644 --- a/components/camel-spring-ws/src/main/java/org/apache/camel/component/spring/ws/SpringWebserviceConfiguration.java +++ b/components/camel-spring-ws/src/main/java/org/apache/camel/component/spring/ws/SpringWebserviceConfiguration.java @@ -106,8 +106,7 @@ public class SpringWebserviceConfiguration { } /** - * Option to provide a custom WebServiceMessageFactory. For example when you want Apache Axiom to handle web service - * messages instead of SAAJ. + * Option to provide a custom WebServiceMessageFactory. */ public void setMessageFactory(WebServiceMessageFactory messageFactory) { this.messageFactory = messageFactory;