Direction for normative text and tests covering JAX-WS annotations.

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

On this week's call we had a brief discussion
about the lack of a normative statement covering the exclude property of
@WebMethod and thus no test assertion or test case.  When I looked
at this in more detail I noticed a couple of things. Normative statement
JCA100011 states: An SCA runtime MUST
apply the JAX-WS annotations as described in Table 11-1 and Table 11-2
when introspecting a Java class or interface class.
 The test assertion document states that for this normative statement:
No meaningful assertion.

I contrast this with a similar situation
in the JCS Spec, where JCI80001 states: An
SCA runtime MUST introspect the componentType of a Java implementation
class following the rules defined in the section "Component Type of
a Java Implementation".  This
normative statement leads to a number of individual test assertions: JCI-TA-8001,
JCI-TA-8002, JCI-TA-8003, JCI-TA-8004, JCI-TA-8005, JCI-TA-8006, JCI-TA-8007,
JCI-TA-8008, JCI-TA-8009, JCI-TA-8010, JCI-TA-8011, JCI-TA-8012, JCI-TA-8013,
JCI-TA-8016, JCI-TA-8017, JCI-TA-8018, JCI-TA-8019, JCI-TA-8020, JCI-TA-8021,
JCI-TA-8022, JCI-TA-8023, JCI-TA-8024, JCI-TA-8025, JCI-TA-8026, JCI-TA-8027,
JCI-TA-8028, JCI-TA-8029, JCI-TA-8030, JCI-TA-8031, JCI-TA-8032, JCI-TA-8033,
JCI-TA-8034, JCI-TA-8035, JCI-TA-8036, JCI-TA-8037 in the current draft.

There are several points in CAA
Table 11-1 and Table 11-2 that probably
need testing that currently do not have explicit normative statements:
@WebService: name
@WebMethod: operationName and exclude
@WebParam: name, mode and  partName
@WebReturn: name and partName
@WebFault: name
We could write explicit normative statements
for each of these (making JCA100011 redundant) or cover them via JCA100011
and have test assertions and thus test cases for JCA100011 like we have
for JCI80001.

I'd like some input on the direction
to take before I write up an issue/proposal.

Thanks.

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