summaryrefslogtreecommitdiffstats
path: root/sca-java-2.x/trunk/modules/sca-api/src/main
diff options
context:
space:
mode:
authorantelder <antelder@13f79535-47bb-0310-9956-ffa450edef68>2010-04-08 11:02:01 +0000
committerantelder <antelder@13f79535-47bb-0310-9956-ffa450edef68>2010-04-08 11:02:01 +0000
commit975d98a42e868c42c6c80b4acc09c84ea6a8c8ca (patch)
tree9d1899ade86ae35fda7e73fec0c7f6f37ff1054a /sca-java-2.x/trunk/modules/sca-api/src/main
parentfa161a4d3732d63c79b78936e22d9fff977cd85d (diff)
Update sca-api with latest OASIS code, these ones have only formatting and javadoc changes
git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@931875 13f79535-47bb-0310-9956-ffa450edef68
Diffstat (limited to 'sca-java-2.x/trunk/modules/sca-api/src/main')
-rw-r--r--sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/ServiceReference.java35
1 files changed, 26 insertions, 9 deletions
diff --git a/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/ServiceReference.java b/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/ServiceReference.java
index d89ed54d10..d2d62763fa 100644
--- a/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/ServiceReference.java
+++ b/sca-java-2.x/trunk/modules/sca-api/src/main/java/org/oasisopen/sca/ServiceReference.java
@@ -1,19 +1,36 @@
/*
- * Copyright(C) OASIS(R) 2005,2009. All Rights Reserved.
+ * Copyright(C) OASIS(R) 2005,2010. All Rights Reserved.
* OASIS trademark, IPR and other policies apply.
*/
package org.oasisopen.sca;
-import java.io.Serializable;
-
-
/**
- * A ServiceReference represents a client's perspective of a reference to another service.
+ * The ServiceReference interface represents a component reference.
+ * It can be injected using the @Reference annotation
+ * on a field, a setter method, or constructor parameter taking the
+ * type ServiceReference.
*
- * @version $Rev$ $Date$
- * @param <B> the Java interface associated with this reference
+ * @param <B> the type of the service reference
*/
-public interface ServiceReference<B> extends Serializable {
+public interface ServiceReference<B> extends java.io.Serializable {
+
+ /**
+ * Returns a type-safe reference to the target of this reference.
+ * The instance returned is guaranteed to implement the business
+ * interface for this reference. The value returned is a proxy
+ * to the target that implements the business interface associated
+ * with this reference.
+ *
+ * @return a type-safe reference to the target of this reference.
+ */
B getService();
- Class<B> getBusinessInterface();
+
+ /**
+ * Returns the Java class for the business interface associated
+ * with this reference.
+ *
+ * @return the Java class for the business interface associated
+ * with this reference.
+ */
+ Class<B> getBusinessInterface();
}