ISSUE-189 Normative statement JCA90014 has the wrong form

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

http://www.osoa.org/jira/browse/JAVA-189

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

Mike Edwards ---10/09/2009 05:13:05 AM---Raiser: Mike Edwards Target: sca-javacaa-1.1-spec-cd03-rev1.doc

From:	Mike Edwards <mike_edwards@uk.ibm.com>
To:	"OASIS Java" <sca-j@lists.oasis-open.org>
Date:	10/09/2009 05:13 AM
Subject:	[sca-j] [NEW ISSUE] Normative statement JCA90014 has the wrong form

---

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