[NEW ISSUE] Normative statement JCA90014 has the wrong form

[Mike Edwards <mike_edwards@uk.ibm.com>]

Raiser:        
       Mike Edwards

Target:        
       sca-javacaa-1.1-spec-cd03-rev1.doc

Description:

The statement JCA90014 has the form:

 "For a @Property annotation
applied to a constructor parameter, the required attribute MUST have the
value true.  [JCA90014]"

This has the unfortunate effect of implying
that the writer of the composite file must explicitly set the @required
attribute of the 
@Property annotation - ie that the form
@Property(required="true") is necessary.

However, a recent change to the spec
caused by the resolution of another issue changed the default value of
the @required
attribute to "true" - see
the statement immediately before JCA90014 - "Defaults to true".
 So it is clear that the default value of
@required satisfies JCA90014.

In order to avoid confusion and remove
the implication that the @required="true" must be declared explicitly,
the form of JCA90014
should be changed (BUT NOT ITS MEANING)

Proposal:

Change JCA90014 to read as follows:

"For a @Property annotation applied
to a constructor parameter, the required attribute MUST NOT have the value
false. [JCA90014]"

This simply implies that @requires="false"
is not allowed and leaves open the possibility not to state @requires at
all, picking
up the default value of "true"


Yours,  Mike.

Strategist - Emerging Technologies, SCA & SDO.
Co Chair OASIS SCA Assembly TC.
IBM Hursley Park, Mail Point 146, Winchester, SO21 2JN, Great Britain.
Phone & FAX: +44-1962-818014    Mobile: +44-7802-467431  
Email:  mike_edwards@uk.ibm.com

---

Unless stated otherwise above:
IBM United Kingdom Limited - Registered in England and Wales with number 741598.
Registered office: PO Box 41, North Harbour, Portsmouth, Hampshire PO6 3AU