RE: [sca-j] [NEW ISSUE] Missing Normative statement relating to getServi

Hi,

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

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

Thanks,

Mark

From: Mike Edwards [mailto:mike_edwards@uk.ibm.com]
Sent: 30 April 2009 08:48
To: OASIS Java
Subject: [sca-j] [NEW ISSUE] Missing Normative statement relating to getServiceReference() method

Raiser: Mike Edwards

Target: sca-javacaa-1.1-spec-cd02-rev7.doc

Description:

The paragraph describing the getServiceReference() method in section 9.1 contains normative material that
is not tagged as a normative statement:

Lines 1320-1322:

getServiceReference(Class<B> businessInterface, String referenceName)

– Returns a ServiceReference defined by the current component. This method MUST throw an IllegalArgumentException if the reference has multiplicity greater than one.

I also note that the description for this method does not describe other error cases that should be covered.

Proposal:

Create a new normative statements, appropriately tagged, as follows:

getServiceReference(Class<B> businessInterface, String referenceName)

– Returns a ServiceReference defined by the current component.

businessInterface - the interface class of the reference

referenceName - the name of the reference

The getServiceReference method MUST throw an IllegalArgumentException if the reference named by the referenceName parameter has multiplicity greater than one. [JCA80004]

The getServiceReference method MUST throw an IllegalArgumentException if the reference named by the referenceName parameter does not have an interface of the type defined by the businessInterface parameter. [JCA80005]

The getServiceReference method MUST return null if the component does not have a reference with the name provided in the referenceName parameter. [JCA80006]

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

sca-j message