RE: [sca-j] [NEW ISSUE] Normative statement JCA90052 is poorly worded - [JAVA-165]

Hi,

 

I have raised this new issue as JAVA-165. See:

 

http://www.osoa.org/jira/browse/JAVA-165

 

Thanks,

 

Mark

Mark Combellack| Software Developer| Avaya | Eastern Business Park | St. Mellons | Cardiff |
CF3 5EA | Voice: +44 (0) 29 2081 7624 | 

From:
Mike Edwards [mailto:] 

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:  

 

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