RE: [sca-j] ISSUE 11: Semantics of getCallbackID() are underspecified

["Peshev, Peter" <peter.peshev@sap.com>]

Hi,

I fully agree with the proposal, but I am not sure I understand the concern of Michael raised during the meeting that different bindings may behave differently. I would expect that the only interraction with the binding will happen at point 5 when the proxy will invoke it, and before that everything should be one and the same and there is no problem to specify the semantics. 


@Michael - is there something that I am missing ?

Best Regards
Peter




-----Original Message-----
From: Barack, Ron [mailto:ron.barack@sap.com] 
Sent: Thursday, 4. October 2007 21:03
To: sca-j@lists.oasis-open.org
Subject: [sca-j] ISSUE 11: Semantics of getCallbackID() are underspecified

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

-----Ursprüngliche Nachricht-----
Von: Simon Nash [mailto:NASH@uk.ibm.com] 
Gesendet: Mittwoch, 26. September 2007 15:43
An: sca-j@lists.oasis-open.org
Betreff: [sca-j] NEW ISSUE: Semantics of getCallbackID() are underspecified

TARGET:

Java Common Annotations and APIs specification, section "Java API" / 
{"CallableReference"}

DESCRIPTION:
 
The getCallbackID() method description doesn't specify the initial state 
of the returned value and the events that cause this value to change.

Consider the following sequence of events:
1) A ServiceReference is created, either by injection or by 
ComponentContext.getServiceReference().
2) getCallbackID() is called on the ServiceReference.
3) A type-safe reference (proxy) is created from the ServiceReference by 
CallableReference.getService().
4) getCallbackID() is called on the ServiceReference.
5) A service call is made through the type-safe reference.
6) getCallbackID() is called on the ServiceReference.

It seems reasonably intuitive that call 2) will return null and call 6) 
will return the system-generated callback ID that was used for the service 
call.  It's less clear what call 4) will return.  Does the 
system-generated callback ID get created and set into the ServiceReference 
as part of event 3) or as part of event 5)?

The description of the getCallbackID() method should describe a "state 
model" for how the value returned would change based on other actions.

PROPOSAL:

At point 2) the value returned will be null.  At point 4, it will still be 
null,  At point 6), it will be the system-generated callback ID that was 
used for the service call 5).  This information should be stated 
explicitly in the description of getCallbackID().






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