NEW ISSUE: Duplicate normative statements in Java CI and Java CAA

[David Booz <booz@us.ibm.com>]

TARGET: Java CAA specification CD03/PR01 [1]

DESCRIPTION:

There are two sets of normative statements that duplicate each other across the Java CAA and Java CI spec. Reference to Java CI [2] is included for convenience.

(1)
Java CAA: For a @Property annotation, if the type of the Java class field or the type of the input parameter of the setter method or constructor is defined as an array or as any type that extends or implements java.util.Collection, then the SCA runtime MUST introspect the component type of the implementation with a <property/> element with a @many attribute set to true, otherwise @many MUST be set to false.[JCA90047]

Java CI - line 438: many attribute is set to “false” unless the type of the field or of the setter method is an array or a java.util.Collection, in which case it is set to "true".
This statement is part of JCI80001.

(2)
Java CAA: If the type of a reference is not an array or any type that extends or implements java.util.Collection, then the SCA runtime MUST introspect the component type of the implementation with a <reference/> element with @multiplicity= 0..1 if the @Reference annotation required attribute is false and with @multiplicity=1..1 if the @Reference annotation required attribute is true. [JCA90020]

Java CAA: If the type of a reference is defined as an array or as any type that extends or implements java.util.Collection, then the SCA runtime MUST introspect the component type of the implementation with a <reference/> element with @multiplicity=0..n if the @Reference annotation required attribute is false and with @multiplicity=1..n if the @Reference annotation required attribute is true. [JCA90021]

Java CI - line 402: a) where the type of the field, setter or constructor parameter is an interface, the multiplicity attribute is (1..1) unless the @Reference annotation contains required=false, in which case it is (0..1) b) where the type of the field, setter or parameter is an array or is a java.util.Collection, the multiplicity attribute is (1..n) unless the @Reference annotation contains required=false, in which case it is (0..n)
This statement is part of JCI80001.

PROPOSAL:
I don't like the duplication, esp. for normative statements, but not sure which spec should retain the text. I tend to favor the Java CI spec because the existing rules are more complete.


[1] http://docs.oasis-open.org/opencsa/sca-j/sca-javacaa-1.1-spec-cd03.pdf
[2] http://docs.oasis-open.org/opencsa/sca-j/sca-javaci-1.1-spec-cd01.pdf

Dave Booz
STSM, BPM and SCA Architecture
Co-Chair OASIS SCA-Policy TC and SCA-J TC
"Distributed objects first, then world hunger"
Poughkeepsie, NY (845)-435-6093 or 8-295-6093
e-mail:booz@us.ibm.com