ISSUE-186: JCI50002 and JCI50005 are not well written

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

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

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

David Booz---09/29/2009 10:18:41 AM---TARGET: SCA POJO spec CD01-rev1 DESCRIPTION:

From:	David Booz/Poughkeepsie/IBM@IBMUS
To:	sca-j@lists.oasis-open.org
Date:	09/29/2009 10:18 AM
Subject:	[sca-j] NEW ISSUE: JCI50002 and JCI50005 are not well written

---

TARGET: SCA POJO spec CD01-rev1

DESCRIPTION: 
(1) The spec contains the following for JCI50002:

The @Constructor annotation MUST only be specified on one constructor; the SCA container MUST raise an error if multiple constructors are annotated with @Constructor. [JCI50002]

The double 'MUST' is unnecessary. The fragment 'MUST only be specified on one' could be written more clearly.

(2) The spec contains the following for JCI50005:

The SCA runtime MUST raise an error if there are multiple constructors that are not annotated with @Constructor and have a non-empty parameter list with all parameters annotated with either @Property or @Reference. [JCI50005]

The statement is very hard to parse.


PROPOSAL: 

The @Constructor annotation MUST NOT appear on more than one constructor. [JCI50002]

In the absence of an @Constructor annotation, there MUST NOT be more than one constructor that has a non-empty parameter list with all parameters annotated with either @Property or @Reference. [JCI50005]



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