org.oasisopen.sca.client
Class SCAClientFactory

java.lang.Object
  extended by org.oasisopen.sca.client.SCAClientFactory

public abstract class SCAClientFactory
extends java.lang.Object

The SCAClientFactory can be used by non-SCA managed code to lookup services that exist in a SCA Domain.

Author:
OASIS Open
See Also:
SCAClientFactoryFinderImpl

Method Summary
abstract
<T> T
getService(java.lang.Class<T> interfaze, java.lang.String serviceURI)
          Returns a reference proxy that implements the business interface of a service in the SCA Domain handled by this SCAClientFactory
static SCAClientFactory newInstance(java.lang.ClassLoader classLoader, java.net.URI domainURI)
          Creates a new instance of the SCAClientFactory that can be used to lookup SCA Services.
static SCAClientFactory newInstance(java.util.Properties properties, java.lang.ClassLoader classLoader, java.net.URI domainURI)
          Creates a new instance of the SCAClientFactory that can be used to lookup SCA Services.
static SCAClientFactory newInstance(java.util.Properties properties, java.net.URI domainURI)
          Creates a new instance of the SCAClientFactory that can be used to lookup SCA Services.
static SCAClientFactory newInstance(java.net.URI domainURI)
          Creates a new instance of the SCAClientFactory that can be used to lookup SCA Services.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Method Detail

newInstance

public static SCAClientFactory newInstance(java.net.URI domainURI)
                                    throws NoSuchDomainException
Creates a new instance of the SCAClientFactory that can be used to lookup SCA Services.

Parameters:
domainURI - URI of the target domain for the SCAClientFactory
Returns:
A new SCAClientFactory
Throws:
NoSuchDomainException

newInstance

public static SCAClientFactory newInstance(java.util.Properties properties,
                                           java.net.URI domainURI)
                                    throws NoSuchDomainException
Creates a new instance of the SCAClientFactory that can be used to lookup SCA Services.

Parameters:
properties - Properties that may be used when creating a new instance of the SCAClientFactory
domainURI - URI of the target domain for the SCAClientFactory
Returns:
A new SCAClientFactory instance
Throws:
NoSuchDomainException

newInstance

public static SCAClientFactory newInstance(java.lang.ClassLoader classLoader,
                                           java.net.URI domainURI)
                                    throws NoSuchDomainException
Creates a new instance of the SCAClientFactory that can be used to lookup SCA Services.

Parameters:
classLoader - ClassLoader that may be used when creating a new instance of the SCAClientFactory
domainURI - URI of the target domain for the SCAClientFactory
Returns:
A new SCAClientFactory instance
Throws:
NoSuchDomainException

newInstance

public static SCAClientFactory newInstance(java.util.Properties properties,
                                           java.lang.ClassLoader classLoader,
                                           java.net.URI domainURI)
                                    throws NoSuchDomainException
Creates a new instance of the SCAClientFactory that can be used to lookup SCA Services.

Parameters:
properties - Properties that may be used when creating a new instance of the SCAClientFactory
classLoader - ClassLoader that may be used when creating a new instance of the SCAClientFactory
domainURI - URI of the target domain for the SCAClientFactory
Returns:
A new SCAClientFactory instance
Throws:
NoSuchDomainException

getService

public abstract <T> T getService(java.lang.Class<T> interfaze,
                                 java.lang.String serviceURI)
                      throws NoSuchServiceException
Returns a reference proxy that implements the business interface of a service in the SCA Domain handled by this SCAClientFactory

Type Parameters:
T - The business interface class of the service in the domain
Parameters:
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
interfaze - The business interface class of the service in the domain
Returns:
a proxy to the target service, in the specified SCA Domain that implements the business interface .
Throws:
NoSuchServiceException - Service requested was not found