[NEW ISSUE] Normative statement JCA90052 is poorly worded

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:  

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