Re: comment on @WebParam/@WebResult

[Bryan Aupperle <aupperle@us.ibm.com>]

The SCA-J TC thanks you for review and comments
on the SCA-J Common Annotations and APIs Specification. 

 
Section 11.1 defines the effects on
an SCA interface defined by a Java Interface or Java Class of any JAX-WS
annotations on the Java Interface or Java Class or any of the elements
of the Java Interface of Java Class.  It is important to define these
effects since any remotable SCA interface is potentially mapped to WSDL
1.1 for testing interface compatibility so any an annotations that impact
the mapping of the Java to the
corresponding WSDL portType and
messages or any of the child elements of the corresponding portType and
messages need to be considered. 

SCA 1.1 considers the operations (including the name, return type and parameter
types - but not names - of each operation) and faults/exceptions (including
the structure of the fault message) when testing compatibility.

With this as background we can consider the treatment of the name/partName
attributes of @WebParam and @WebReturn and compare this with the treatment
of @WebFault, @RequestWrapper and @ResponseWrapper
. 
The name and partName attributes of @WebParam and @WebReturn impact the
name attribute of a part element of a WSDL message, which impacts the signature
of the WSDL operation so this also impacts the signature of the SCA operation.
 Admittedly this portion of the signature is not relevant in SCA 1.1,
but defining the impacts sets the path for potential future refinement.
 Because parameter names are not currently used, there are no normative
statements associated withe the impacts of the name and partName attributes
of @WebParam and @WebReturn. 

Contrast this with effects of @WebFault, @RequestWrapper and @ResponseWrapper
which control the XML information with respect to the corresponding JAXB
beans but not the operation/fault names or message content and thus not
the signature of a operation or fault. 

This section could perhaps be clearer about the name and partName attributes
of @WebParam and @WebReturn not currently having any observable impact
on the SCA interface, but the information in the tables is correct and
appropriate. 

Bryan Aupperle, Ph.D.
STSM, WebSphere Enterprise Platform Software Solution Architect
WW Center of Excellence for Enterprise Systems & Banking Center of
Excellence Application Integration Architect

Research Triangle Park,  NC 
+1 919-254-7508 (T/L 444-7508)
Internet Address: aupperle@us.ibm.com