ISSUE-189 Normative statement JCA90014 has the wrong form

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:

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

From:

Mike Edwards <>

To:

"OASIS Java" <>

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:  

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