From:
Mike Edwards [mailto:mike_edwards@uk.ibm.com]
Sent: 15 June 2009 08:32
To: OASIS Java
Subject: [sca-j] [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: 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