Re: [sca-j] [NEW ISSUE] Normative statement JCA90052 is poorly worded

[Simon Nash <oasis@cjnash.com>]

Mike,
While we are fixing this, we should also correct the bogus reference
to @Remotable.  This was a typo for @Reference in the resolution to
JAVA-6 (my apologies).  This mistake is less obvious now, given that
JAVA-125 has recently extended the use of @Remotable to include
these cases :-)

I think it would be clearer to simply list all the places where the
@AllowsPassByReference annotation can occur, as we have done for
@Remotable in the resolution to JAVA-125.  This would produce the
following text:

The @AllowsPassByReference annotation MUST only annotate the following
locations:
- a service implementation class
- an individual method of a remotable service implementation
- an individual reference which uses a remotable interface, where the
   reference is a field, a setter method, or a constructor parameter
   [JCA90052]

   Simon

Mike Edwards wrote:
> 
> Raiser:                        Mike Edwards
> 
> Target:                        sca-javacaa-1.1-spec-cd03.pdf
> 
> Description:
> 
> JCA90052 is worded as follows:
> 
> 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.
> 
> The existence of three MAY words followed by a MUST NOT is at best 
> confusing.  It leads to an assumption
> that @AllowsPassByReference is an optional feature, which is not intended.
> 
> This confusing formulation should be replaced by clearer wording that 
> avoids the impression of optionality.
> 
> Proposal:
> 
> The @AllowsPassByReference annotation MUST only annotate the following 
> locations:
> - a service implementation class
> - an individual method of a remotable service implementation
> - an individual reference which uses a remotable interface, where the 
> @AllowsPassByReference annotation
> can annotate any artifact which can be annotated by the @Remotable 
> annotation
> [JCA90052]
> 
> 
> 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/
> 
> 
> 
> 
> 
>