Re: [sca-j] NEW ISSUE: Java CAA spec - Incorrect use of RFC2119 keywords

[Simon Nash <oasis@cjnash.com>]

David Booz wrote:
> TARGET: Java CAA specification CD03/PR01 [1]
> 
> DESCRIPTION:
> There are several places where RFC2119 keywords are misused:
> 
> a) The @AllowsPassByReference annotation MAY be placed on an individual 
> method of a remotable service implementation, on a service 
> implementation class, or on an individual reference for a remotable 
> service. When applied to a reference, it MAY appear anywhere that the 
> @Remotable annotation MAY appear. It MUST NOT appear anywhere else. 
> [JCA90052]
> 
This has already been raised as JAVA-165 and resolved.

   Simon

> b) A method annotated with @Destroy MAY have any access modifier and 
> MUST have a void return type and no arguments. [JCA90004]
> 
> c) A method marked with the @Init annotation MAY have any access 
> modifier and MUST have a void return type and no arguments.[JCA90008]
> 
> d) For SCA reference interfaces defined using interface.java, the Java 
> interface MAY contain the additional client-side asynchronous polling 
> and callback methods defined by JAX-WS. [JCA100007]
> 
> e) Section 12 has several uses of unlabelled RFC keywords. Was that 
> intentional?
> Lines 2338, 2341, 2344, 2345, 2354, 2356, 2358, 2360, 2362
> 
> PROPOSAL:
> 
> a) Replace JCA90052 with the following:
> 
> The @AllowsPassByReference annotation MUST only be placed on the 
> following locations; an individual method of a remotable service 
> implementation, on a service implementation class, or on an individual 
> reference for a remotable service. When applied to a reference, it MUST 
> NOT appear anywhere that the @Remotable annotation MUST NOT appear. 
> [JCA90052]
> 
> b) Replace JCA90004 with the following:
> 
> A method annotated with @Destroy can have any access modifier and MUST 
> have a void return type and no arguments.[JCA90004]
> 
> c) Replace JCA90008 with the following:
> A method marked with the @Init annotation can have any access modifier 
> and MUST have a void return type and no arguments.[JCA90008]
> 
> d) Replace JCA100007 with the following:
> For SCA reference interfaces defined using interface.java, the Java 
> interface can contain the additional client-side asynchronous polling 
> and callback methods defined by JAX-WS.
> 
> [1] http://docs.oasis-open.org/opencsa/sca-j/sca-javacaa-1.1-spec-cd03.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
>