diff options
Diffstat (limited to 'sca-java-2.x/branches/2.0-Beta2/modules/sca-api/src/main/java/org/oasisopen/sca/client')
3 files changed, 0 insertions, 476 deletions
diff --git a/sca-java-2.x/branches/2.0-Beta2/modules/sca-api/src/main/java/org/oasisopen/sca/client/SCAClientFactory.java b/sca-java-2.x/branches/2.0-Beta2/modules/sca-api/src/main/java/org/oasisopen/sca/client/SCAClientFactory.java deleted file mode 100644 index 9e25d407a5..0000000000 --- a/sca-java-2.x/branches/2.0-Beta2/modules/sca-api/src/main/java/org/oasisopen/sca/client/SCAClientFactory.java +++ /dev/null @@ -1,152 +0,0 @@ -/* - * 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; -import org.oasisopen.sca.NoSuchServiceException; -import org.oasisopen.sca.client.SCAClientFactoryFinder; -import org.oasisopen.sca.client.impl.SCAClientFactoryFinderImpl; - -/** - * The SCAClientFactory can be used by non-SCA managed code to - * lookup services that exist in a SCA Domain. - * - * @see SCAClientFactoryFinderImpl - * - * @author OASIS Open - */ - -public abstract class SCAClientFactory { - - /** - * The SCAClientFactoryFinder. - * Provides a means by which a provider of an SCAClientFactory - * implementation can inject a factory finder implementation into - * the abstract SCAClientFactory class - once this is done, future - * invocations of the SCAClientFactory use the injected factory - * finder to locate and return an instance of a subclass of - * SCAClientFactory. - */ - protected static SCAClientFactoryFinder factoryFinder; - /** - * The Domain URI of the SCA Domain which is accessed by this - * SCAClientFactory - */ - private URI domainURI; - - /** - * Prevent concrete subclasses from using the no-arg constructor - */ - private SCAClientFactory() { - } - - /** - * Constructor used by concrete subclasses - * @param domainURI - The Domain URI of the Domain accessed via this - * SCAClientFactory - */ - protected SCAClientFactory(URI domainURI) - throws NoSuchDomainException { - this.domainURI = domainURI; - } - - /** - * Gets the Domain URI of the Domain accessed via this SCAClientFactory - * @return - the URI for the Domain - */ - protected URI getDomainURI() { - return domainURI; - } - - - /** - * Creates a new instance of the SCAClientFactory that can be - * used to lookup SCA Services. - * - * @param domainURI URI of the target domain for the SCAClientFactory - * @return A new SCAClientFactory - */ - public static SCAClientFactory newInstance( URI domainURI ) - throws NoSuchDomainException { - return newInstance(null, null, domainURI); - } - - /** - * Creates a new instance of the SCAClientFactory that can be - * used to lookup SCA Services. - * - * @param properties Properties that may be used when - * creating a new instance of the SCAClientFactory - * @param domainURI URI of the target domain for the SCAClientFactory - * @return A new SCAClientFactory instance - */ - public static SCAClientFactory newInstance(Properties properties, - URI domainURI) - throws NoSuchDomainException { - return newInstance(properties, null, domainURI); - } - - /** - * Creates a new instance of the SCAClientFactory that can be - * used to lookup SCA Services. - * - * @param classLoader ClassLoader that may be used when - * creating a new instance of the SCAClientFactory - * @param domainURI URI of the target domain for the SCAClientFactory - * @return A new SCAClientFactory instance - */ - public static SCAClientFactory newInstance(ClassLoader classLoader, - URI domainURI) - throws NoSuchDomainException { - return newInstance(null, classLoader, domainURI); - } - - /** - * Creates a new instance of the SCAClientFactory that can be - * used to lookup SCA Services. - * - * @param properties Properties that may be used when - * creating a new instance of the SCAClientFactory - * @param classLoader ClassLoader that may be used when - * creating a new instance of the SCAClientFactory - * @param domainURI URI of the target domain for the SCAClientFactory - * @return A new SCAClientFactory instance - */ - public static SCAClientFactory newInstance(Properties properties, - ClassLoader classLoader, - URI domainURI) - throws NoSuchDomainException { - final SCAClientFactoryFinder finder = - factoryFinder != null ? factoryFinder : - new SCAClientFactoryFinderImpl(); - final SCAClientFactory factory - = finder.find(properties, classLoader, domainURI); - return factory; - } - - /** - * Returns a reference proxy that implements the business interface <T> - * of a service in the SCA Domain handled by this SCAClientFactory - * - * @param serviceURI the relative URI of the target service. Takes the - * form componentName/serviceName. - * Can also take the extended form componentName/serviceName/bindingName - * to use a specific binding of the target service - * - * @param interfaze The business interface class of the service in the - * domain - * @param <T> The business interface class of the service in the domain - * - * @return a proxy to the target service, in the specified SCA Domain - * that implements the business interface <B>. - * @throws NoSuchServiceException Service requested was not found - * @throws NoSuchDomainException Domain requested was not found - */ - public abstract <T> T getService(Class<T> interfaze, String serviceURI) - throws NoSuchServiceException, NoSuchDomainException; -} diff --git a/sca-java-2.x/branches/2.0-Beta2/modules/sca-api/src/main/java/org/oasisopen/sca/client/SCAClientFactoryFinder.java b/sca-java-2.x/branches/2.0-Beta2/modules/sca-api/src/main/java/org/oasisopen/sca/client/SCAClientFactoryFinder.java deleted file mode 100644 index 54a73fc023..0000000000 --- a/sca-java-2.x/branches/2.0-Beta2/modules/sca-api/src/main/java/org/oasisopen/sca/client/SCAClientFactoryFinder.java +++ /dev/null @@ -1,35 +0,0 @@ -/* - * 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 ; -} diff --git a/sca-java-2.x/branches/2.0-Beta2/modules/sca-api/src/main/java/org/oasisopen/sca/client/impl/SCAClientFactoryFinderImpl.java b/sca-java-2.x/branches/2.0-Beta2/modules/sca-api/src/main/java/org/oasisopen/sca/client/impl/SCAClientFactoryFinderImpl.java deleted file mode 100644 index 0f5eae7603..0000000000 --- a/sca-java-2.x/branches/2.0-Beta2/modules/sca-api/src/main/java/org/oasisopen/sca/client/impl/SCAClientFactoryFinderImpl.java +++ /dev/null @@ -1,289 +0,0 @@ -/* - * Copyright(C) OASIS(R) 2005,2010. All Rights Reserved. - * OASIS trademark, IPR and other policies apply. - */ -package org.oasisopen.sca.client.impl; - -import org.oasisopen.sca.client.SCAClientFactoryFinder; - -import java.io.BufferedReader; -import java.io.Closeable; -import java.io.IOException; -import java.io.InputStream; -import java.io.InputStreamReader; -import java.lang.reflect.Constructor; -import java.net.URI; -import java.net.URL; -import java.util.Properties; - -import org.oasisopen.sca.NoSuchDomainException; -import org.oasisopen.sca.ServiceRuntimeException; -import org.oasisopen.sca.client.SCAClientFactory; - -/** - * This is a default implementation of an SCAClientFactoryFinder which is - * used to find an implementation of the SCAClientFactory interface. - * - * @see SCAClientFactoryFinder - * @see SCAClientFactory - * - * @author OASIS Open - */ -public class SCAClientFactoryFinderImpl implements SCAClientFactoryFinder { - - /** - * The name of the System Property used to determine the SPI - * implementation to use for the SCAClientFactory. - */ - private static final String SCA_CLIENT_FACTORY_PROVIDER_KEY = - SCAClientFactory.class.getName(); - - /** - * The name of the file loaded from the ClassPath to determine - * the SPI implementation to use for the SCAClientFactory. - */ - private static final String SCA_CLIENT_FACTORY_PROVIDER_META_INF_SERVICE - = "META-INF/services/" + SCA_CLIENT_FACTORY_PROVIDER_KEY; - - /** - * Public Constructor - */ - public SCAClientFactoryFinderImpl() { - } - - /** - * Creates an instance of the SCAClientFactorySPI implementation. - * This discovers the SCAClientFactorySPI Implementation and instantiates - * the provider's implementation. - * - * @param properties Properties that may be used when creating a new - * instance of the SCAClient - * @param classLoader ClassLoader that may be used when creating a new - * instance of the SCAClient - * @return new instance of the SCAClientFactory - * @throws ServiceRuntimeException Failed to create SCAClientFactory - * Implementation. - */ - public SCAClientFactory find(Properties properties, - ClassLoader classLoader, - URI domainURI ) - throws NoSuchDomainException, ServiceRuntimeException { - if (classLoader == null) { - classLoader = getThreadContextClassLoader (); - } - final String factoryImplClassName = - discoverProviderFactoryImplClass(properties, classLoader); - final Class<? extends SCAClientFactory> factoryImplClass - = loadProviderFactoryClass(factoryImplClassName, - classLoader); - final SCAClientFactory factory = - instantiateSCAClientFactoryClass(factoryImplClass, - domainURI ); - return factory; - } - - /** - * Gets the Context ClassLoader for the current Thread. - * - * @return The Context ClassLoader for the current Thread. - */ - private static ClassLoader getThreadContextClassLoader () { - final ClassLoader threadClassLoader = - Thread.currentThread().getContextClassLoader(); - return threadClassLoader; - } - - /** - * Attempts to discover the class name for the SCAClientFactorySPI - * implementation from the specified Properties, the System Properties - * or the specified ClassLoader. - * - * @return The class name of the SCAClientFactorySPI implementation - * @throw ServiceRuntimeException Failed to find implementation for - * SCAClientFactorySPI. - */ - private static String - discoverProviderFactoryImplClass(Properties properties, - ClassLoader classLoader) - throws ServiceRuntimeException { - String providerClassName = - checkPropertiesForSPIClassName(properties); - if (providerClassName != null) { - return providerClassName; - } - - providerClassName = - checkPropertiesForSPIClassName(System.getProperties()); - if (providerClassName != null) { - return providerClassName; - } - - providerClassName = checkMETAINFServicesForSPIClassName(classLoader); - if (providerClassName == null) { - throw new ServiceRuntimeException( - "Failed to find implementation for SCAClientFactory"); - } - - return providerClassName; - } - - /** - * Attempts to find the class name for the SCAClientFactorySPI - * implementation from the specified Properties. - * - * @return The class name for the SCAClientFactorySPI implementation - * or <code>null</code> if not found. - */ - private static String - checkPropertiesForSPIClassName(Properties properties) { - if (properties == null) { - return null; - } - - final String providerClassName = - properties.getProperty(SCA_CLIENT_FACTORY_PROVIDER_KEY); - if (providerClassName != null && providerClassName.length() > 0) { - return providerClassName; - } - - return null; - } - - /** - * Attempts to find the class name for the SCAClientFactorySPI - * implementation from the META-INF/services directory - * - * @return The class name for the SCAClientFactorySPI implementation or - * <code>null</code> if not found. - */ - private static String checkMETAINFServicesForSPIClassName(ClassLoader cl) - { - final URL url = - cl.getResource(SCA_CLIENT_FACTORY_PROVIDER_META_INF_SERVICE); - if (url == null) { - return null; - } - - InputStream in = null; - try { - in = url.openStream(); - BufferedReader reader = null; - try { - reader = - new BufferedReader(new InputStreamReader(in, "UTF-8")); - - String line; - while ((line = readNextLine(reader)) != null) { - if (!line.startsWith("#") && line.length() > 0) { - return line; - } - } - - return null; - } finally { - closeStream(reader); - } - } catch (IOException ex) { - throw new ServiceRuntimeException( - "Failed to discover SCAClientFactory provider", ex); - } finally { - closeStream(in); - } - } - - /** - * Reads the next line from the reader and returns the trimmed version - * of that line - * - * @param reader The reader from which to read the next line - * @return The trimmed next line or <code>null</code> if the end of the - * stream has been reached - * @throws IOException I/O error occurred while reading from Reader - */ - private static String readNextLine(BufferedReader reader) - throws IOException { - - String line = reader.readLine(); - if (line != null) { - line = line.trim(); - } - return line; - } - - /** - * Loads the specified SCAClientFactory Implementation class. - * - * @param factoryImplClassName The name of the SCAClientFactory - * Implementation class to load - * @return The specified SCAClientFactory Implementation class - * @throws ServiceRuntimeException Failed to load the SCAClientFactory - * Implementation class - */ - private static Class<? extends SCAClientFactory> - loadProviderFactoryClass(String factoryImplClassName, - ClassLoader classLoader) - throws ServiceRuntimeException { - - try { - final Class<?> providerClass = - classLoader.loadClass(factoryImplClassName); - final Class<? extends SCAClientFactory> providerFactoryClass = - providerClass.asSubclass(SCAClientFactory.class); - return providerFactoryClass; - } catch (ClassNotFoundException ex) { - throw new ServiceRuntimeException( - "Failed to load SCAClientFactory implementation class " - + factoryImplClassName, ex); - } catch (ClassCastException ex) { - throw new ServiceRuntimeException( - "Loaded SCAClientFactory implementation class " - + factoryImplClassName - + " is not a subclass of " - + SCAClientFactory.class.getName() , ex); - } - } - - /** - * Instantiate an instance of the specified SCAClientFactorySPI - * Implementation class. - * - * @param factoryImplClass The SCAClientFactorySPI Implementation - * class to instantiate. - * @return An instance of the SCAClientFactorySPI Implementation class - * @throws ServiceRuntimeException Failed to instantiate the specified - * specified SCAClientFactorySPI Implementation class - */ - private static SCAClientFactory instantiateSCAClientFactoryClass( - Class<? extends SCAClientFactory> factoryImplClass, - URI domainURI) - throws NoSuchDomainException, ServiceRuntimeException { - - try { - Constructor<? extends SCAClientFactory> URIConstructor = - factoryImplClass.getConstructor(domainURI.getClass()); - SCAClientFactory provider = - URIConstructor.newInstance( domainURI ); - return provider; - } catch (Throwable ex) { - throw new ServiceRuntimeException( - "Failed to instantiate SCAClientFactory implementation class " - + factoryImplClass, ex); - } - } - - /** - * Utility method for closing Closeable Object. - * - * @param closeable The Object to close. - */ - private static void closeStream(Closeable closeable) { - if (closeable != null) { - try{ - closeable.close(); - } catch (IOException ex) { - throw new ServiceRuntimeException("Failed to close stream", - ex); - } - } - } -} |