From 53ec19a428152cf9da4b40f670928f921ef09810 Mon Sep 17 00:00:00 2001
From: slaws <slaws@13f79535-47bb-0310-9956-ffa450edef68>
Date: Thu, 15 Jul 2010 10:51:26 +0000
Subject: some more detail on the style/format tests

git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@964380 13f79535-47bb-0310-9956-ffa450edef68
---
 sca-java-2.x/trunk/itest/ws/README | 40 ++++++++++++++++++++++++++++++--------
 1 file changed, 32 insertions(+), 8 deletions(-)

diff --git a/sca-java-2.x/trunk/itest/ws/README b/sca-java-2.x/trunk/itest/ws/README
index 380e3b3cc1..0efac242c2 100644
--- a/sca-java-2.x/trunk/itest/ws/README
+++ b/sca-java-2.x/trunk/itest/ws/README
@@ -7,11 +7,31 @@ General Patterns
 For simple synchronous tests:
 
 Jaxws client -> (b.ws service) SCA Component (b.ws reference) -> Jaxws Service
+     /\                                 /\                              |
+     | use                              | use                           | gen 
+     |                                  |                               \/
+Java Interface<------------------Java Interface<---------gen----------WSDL
 
-For callback or asynchronous tests
 
-JUnit client -> SCA Component (b.ws reference) -> (b.ws service) SCA component
+For message format the external service don't get involved in the varying message formats,
+They are still doing doc/lit/wrapped: 
 
+TODO - we could extend testing to include JAXWS edpoints thatunderstand the different formats
+
+JUnit client -> SCA Component (b.ws reference) -> (b.ws service) SCA component -> Jaxws Service
+     /\                            /\                   /\             /\                  |
+      |                             | config             | config      |                   |
+      |  use                        |                    |             | use               | gen
+      |                             -----------WSDL-------             |                   | 
+      |                                                                |                  \/
+Java Interface<-------------------------------------------------Java Interface<----gen---WSDL
+
+For SCA callback or asynchronous tests the external services don't get involved in the 
+callback or aysnc request:
+
+JUnit client -> SCA Component (b.ws reference) -> (b.ws service) SCA component -> Jaxws Service
+
+  
 Java First
 ----------
 implemenation.java 
@@ -47,20 +67,24 @@ rpc-lit              - supported
                           binding style set to rpc      - <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="rpc"/>
                           body uses literal             - <soap:body use="literal" namespace="http://ws.binding.sca.tuscany.apache.org/rpclit/getGreetingsNamespace" />
                              Note the use of a namespace on the body element to set the namespace of the wrapper child of the body element
-doc-lit              - not supported without wrapped style WSDL
+doc-lit(or bare)     - supported (however see note below)
                           WS-I BP1.1 4.7.6 states that an operation signature is a 
                           "fully qualified name of the child element of SOAP body of the SOAP input message"
                           to make this true for doc-lit encoding you have to design the WSDL to wrap the parameters
                           in an appropriate type. Hence doc-literal-wrapped is supported which encompasses this wrapping style. 
+                          For bare style interfaces you have to mark the Java service interface as follows
+                          SOAP binding is set to        - @SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
+                          WSDL configuration where 
+                          message parts use elements    - <part name="parameters" element="tns:getGreetings"/>
+                          the elements are directly implemented by the operation parameter type
+                          binding style set to document - <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
+                          body uses literal             - <soap:body use="literal"/>
 doc-lit-wrapped      - supported
                           WSDL configuration where 
-                          message parts use types       - <part name="parameters" element="tns:getGreetings"/>
+                          message parts use elements       - <part name="parameters" element="tns:getGreetings"/>
+                          the elements are implemented by wrapper types following the name of the operation
                           binding style set to document - <soap:binding transport="http://schemas.xmlsoap.org/soap/http" style="document"/>
                           body uses literal             - <soap:body use="literal"/>
-doc-lit-wrapped-bare - supported 
-                          WSDL configuration as per doc-lit-wrapped
-                          Java implementation configuration where
-                          SOAP binding is set to        - @SOAPBinding(parameterStyle = SOAPBinding.ParameterStyle.BARE)
 rpc-encoded          - not supported
                           not WS-I compliant
 doc-encoded          - not supported
-- 
cgit v1.2.3