2.0 branch for possible maintenance release

git-svn-id: http://svn.us.apache.org/repos/asf/tuscany@1526672 13f79535-47bb-0310-9956-ffa450edef68

1 files changed, 36 insertions, 0 deletions

diff --git a/sca-java-2.x/branches/2.0/modules/sca-api/src/main/java/org/oasisopen/sca/client/SCAClientFactoryFinder.java b/sca-java-2.x/branches/2.0/modules/sca-api/src/main/java/org/oasisopen/sca/client/SCAClientFactoryFinder.java
new file mode 100644
index 0000000000..c6bcfd6c28
--- /dev/null
+++ b/sca-java-2.x/branches/2.0/modules/sca-api/src/main/java/org/oasisopen/sca/client/SCAClientFactoryFinder.java
@@ -0,0 +1,36 @@
+/*
+ * Copyright(C) OASIS(R) 2005,2010. All Rights Reserved.
+ * OASIS trademark, IPR and other policies apply.
+ */
+
+package org.oasisopen.sca.client;
+
+import java.net.URI;
+import java.util.Properties;
+
+import org.oasisopen.sca.NoSuchDomainException;
+
+/**
+ * A Service Provider Interface representing a SCAClientFactory finder.  
+ * SCA provides a default reference implementation of this interface.
+ * SCA runtime vendors can create alternative implementations of this 
+ * interface that use different class loading or lookup mechanisms.
+ */
+public interface SCAClientFactoryFinder {
+
+	/**
+	 * Method for finding the SCAClientFactory for a given Domain URI using
+	 * a specified set of properties and a a specified ClassLoader
+	 * @param properties - properties to use - may be null
+	 * @param classLoader - ClassLoader to use - may be null
+	 * @param domainURI - the Domain URI - must be a valid SCA Domain URI
+	 * @return - the SCAClientFactory or null if the factory could not be
+	 * @throws - NoSuchDomainException if the domainURI does not reference 
+	 * a valid SCA Domain 
+	 * found
+	 */
+    SCAClientFactory find(Properties properties,
+                          ClassLoader classLoader,
+                          URI domainURI ) 
+    	throws NoSuchDomainException ;
+}