org.oasisopen.sca.client
Class SCAClientFactory

java.lang.Object
  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 SCADomain.

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,
                             NoSuchDomainException

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

NoSuchDomainException - Domain requested was not found