javax.xml.rpc
Class ServiceFactory

java.lang.Object
  javax.xml.rpc.ServiceFactory

public abstract class ServiceFactory

extends Object

The javax.xml.rpc.ServiceFactory is an abstract class that provides a factory for the creation of instances of the type javax.xml.rpc.Service. This abstract class follows the abstract static factory design pattern. This enables a J2SE based client to create a Service instance in a portable manner without using the constructor of the Service implementation class.

The ServiceFactory implementation class is set using the system property SERVICEFACTORY_PROPERTY.

Version:

1.0

Author:

Rahul Sharma, Roberto Chinnici

See Also:

Service

Field Summary

static String

SERVICEFACTORY_PROPERTY A constant representing the property used to lookup the name of a ServiceFactory implementation class.

Method Summary

abstract Service	createService(QName serviceName) Create a Service instance.
abstract Service	createService(URL wsdlDocumentLocation, QName serviceName) Create a Service instance.
static ServiceFactory	newInstance() Gets an instance of the ServiceFactory

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

SERVICEFACTORY_PROPERTY

public static final String SERVICEFACTORY_PROPERTY

A constant representing the property used to lookup the name of a ServiceFactory implementation class.

See Also:

Constant Field Values

Method Detail

newInstance

public static ServiceFactory newInstance()
                                  throws ServiceException

Gets an instance of the ServiceFactory

Only one copy of a factory exists and is returned to the application each time this method is called.

The implementation class to be used can be overridden by setting the javax.xml.rpc.ServiceFactory system property.

Throws:

ServiceException

createService

public abstract Service createService(URL wsdlDocumentLocation,
                                      QName serviceName)
                               throws ServiceException

Create a Service instance.

Parameters:

wsdlDocumentLocation - URL for the WSDL document location for the service

serviceName - QName for the service

Throws:

ServiceException - If any error in creation of the specified service

createService

public abstract Service createService(QName serviceName)
                               throws ServiceException

Create a Service instance.

Parameters:

serviceName - QName for the service

Throws:

ServiceException - If any error in creation of the specified service