OASIS Mailing List ArchivesView the OASIS mailing list archive below
or browse/search using MarkMail.


Help: OASIS Mailing Lists Help | MarkMail Help

sca-j message

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]

Subject: [NEW ISSUE] Normative statement JCA90052 is poorly worded

Raiser:                        Mike Edwards

Target:                        sca-javacaa-1.1-spec-cd03.pdf


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.


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

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

[Date Prev] | [Thread Prev] | [Thread Next] | [Date Next] -- [Date Index] | [Thread Index] | [List Home]