diff options
Diffstat (limited to 'sca-java-1.x/tags/1.6/modules/sca-api/src/main/java/org/osoa/sca/ServiceReference.java')
-rw-r--r-- | sca-java-1.x/tags/1.6/modules/sca-api/src/main/java/org/osoa/sca/ServiceReference.java | 54 |
1 files changed, 54 insertions, 0 deletions
diff --git a/sca-java-1.x/tags/1.6/modules/sca-api/src/main/java/org/osoa/sca/ServiceReference.java b/sca-java-1.x/tags/1.6/modules/sca-api/src/main/java/org/osoa/sca/ServiceReference.java new file mode 100644 index 0000000000..8da6bcd1f3 --- /dev/null +++ b/sca-java-1.x/tags/1.6/modules/sca-api/src/main/java/org/osoa/sca/ServiceReference.java @@ -0,0 +1,54 @@ +/* + * (c) Copyright BEA Systems, Inc., Cape Clear Software, International Business Machines Corp, Interface21, IONA Technologies, + * Oracle, Primeton Technologies, Progress Software, Red Hat, Rogue Wave Software, SAP AG., Siemens AG., Software AG., Sybase + * Inc., TIBCO Software Inc., 2005, 2007. All rights reserved. + * + * see http://www.osoa.org/display/Main/Service+Component+Architecture+Specifications + */ +package org.osoa.sca; + + +/** + * A ServiceReference represents a client's perspective of a reference to another service. + * + * @version $Rev$ $Date$ + * @param <B> the Java interface associated with this reference + */ +public interface ServiceReference<B> extends CallableReference<B> { + /** + * Returns the id supplied by the user that will be associated with conversations initiated through this reference. + * + * @return the id to associated with any conversation initiated through this reference + */ + Object getConversationID(); + + /** + * Set the id to associate with any conversation started through this reference. + * If the value supplied is null then the id will be generated by the implementation. + * + * @param conversationId the user-defined id to associated with a conversation + * @throws IllegalStateException if a conversation is currently associated with this reference + */ + void setConversationID(Object conversationId) throws IllegalStateException; + + /** + * Sets the callback ID. + * + * @param callbackID the callback ID + */ + void setCallbackID(Object callbackID); + + /** + * Returns the callback object. + * + * @return the callback object + */ + Object getCallback(); + + /** + * Sets the callback object. + * + * @param callback the callback object + */ + void setCallback(Object callback); +} |