Service Component Architecture sca-j common Annotations and apis Specification Version 1 Committee Draft 03 – Rev1 + Issue 127

9.7Constants

package org.oasisopen.sca;

String SCA_NS="http://docs.oasis-open.org/ns/opencsa/sca/200903";

String SCA_PREFIX = "{"+SCA_NS+"}";

}

9.8SCAClientFactory Class

The SCAClientFactory is an abstract class which provides a set of static newInstance(...) methods which the client can invoke in order to obtain a concrete object implementing the SCAClientFactory interface for a particular SCA Domain. The returned SCAClientFactory object provides a getService() method which provides the client with the means to obtain a reference proxy object for a service running in the SCA Domain.

The SCAClientFactory class is as follows:
/*

* Copyright(C) OASIS(R) 2005,2009. All Rights Reserved.

* OASIS trademark, IPR and other policies apply.

*/

package org.oasisopen.sca.client;

* The SCAClientFactory can be used by non-SCA managed code to

* lookup services that exist in a SCADomain.

*

* @see SCAClientFactoryFinderImpl

* @author OASIS Open

*/
public abstract class SCAClientFactory {
protected static SCAClientFactoryFinder factoryFinder;
private SCAClientFactory() {}
protected SCAClientFactory(URI domainURI)

throws NoSuchDomainException {...}
public URI getDomainURI() {...}

public static SCAClientFactory newInstance( URI domainURI )

throws NoSuchDomainException {...}

public static SCAClientFactory newInstance(Properties properties,

URI domainURI)

URI domainURI)

ClassLoader classLoader,

URI domainURI)

throws NoSuchDomainException {...}

public abstract T getService(Class interfaze, String serviceURI)

throws NoSuchServiceException, NoSuchDomainException;

}

newInstance ( URI ) method:

Obtains a object implementing the SCAClientFactory class.

Returns:

• 
  object which implements the SCAClientFactory class
  

• 
  domainURI - a URI for the SCA Domain which is targeted by the returned SCAClient object
  

• 
  NoSuchDomainException - thrown if the domainURI parameter does not identify a valid SCA Domain
  

Obtains a object implementing the SCAClientFactory class, using a specified set of properties.

Returns:

• 
  object which implements the SCAClientFactory class
  

• 
  properties - a set of Properties that can be used when creating the object which implements the SCAClientFactory class.
  
• 
  domainURI - a URI for the SCA Domain which is targeted by the returned SCAClient object
  

• 
  NoSuchDomainException - thrown if the domainURI parameter does not identify a valid SCA Domain
  

Obtains a object implementing the SCAClientFactory class using a specified classloader.

Returns:

• 
  object which implements the SCAClientFactory class
  

• 
  classLoader - a ClassLoader to use when creating the object which implements the SCAClientFactory class.
  
• 
  domainURI - a URI for the SCA Domain which is targeted by the returned SCAClient object
  

• 
  NoSuchDomainException - thrown if the domainURI parameter does not identify a valid SCA Domain
  

Obtains a object implementing the SCAClientFactory class using a specified set of properties and a specified classloader.

Returns:

• 
  object which implements the SCAClientFactory class
  

• 
  properties - a set of Properties that can be used when creating the object which implements the SCAClientFactory class.
  
• 
  classLoader - a ClassLoader to use when creating the object which implements the SCAClientFactory class.
  
• 
  domainURI - a URI for the SCA Domain which is targeted by the returned SCAClient object
  

• 
  NoSuchDomainException - thrown if the domainURI parameter does not identify a valid SCA Domain
  

Obtains a proxy reference object for a specified target service in a specified SCA Domain.

Returns:

• 
  proxy object which implements the business interface T
  Invocations of a business method of the proxy causes the invocation of the corresponding operation of the target service .
  

• 
  interfaze - a Java interface class which is the business interface of the target service
  
• 
  serviceURI - a String containing the relative URI of the target service within its SCA Domain.
  Takes the form componentName/serviceName or can also take the extended form componentName/serviceName/bindingName to use a specific binding of the target service
  

• 
  NoSuchServiceException - thrown if a service with the relative URI serviceURI and a business interface which matches interfaze cannot be found in the SCA Domain targeted by the SCAClient object
  
• 
  NoSuchDomainException - thrown if the domainURI of the SCAClientFactory does not identify a valid SCA Domain
  

Obtains the Domain URI value for this SCAClientFactory

Returns:

• 
  URI of the target SCA Domain for this SCAClientFactory
  

• 
  none
  

• 
  NoSuchDomainException - thrown if the domainURI parameter does not identify a valid SCA Domain
  

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.