javax.xml.rpc

Class ServiceFactory

Known Direct Subclasses:
ServiceFactory

public abstract class ServiceFactory
extends java.lang.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

Field Summary

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

Constructor Summary

ServiceFactory()
Protected constructor.

Method Summary

Service
createService(URL wsdlDocumentLocation, QName serviceName)
Create a Service instance.
Service
createService(QName serviceName)
Create a Service instance.
Service
loadService(java.lang.Class class1)
Service
loadService(java.net.URL url, java.lang.Class class1, java.util.Properties properties)
Service
loadService(java.net.URL url, QName qname, java.util.Properties properties)
static ServiceFactory
newInstance()
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.

Field Details

SERVICEFACTORY_PROPERTY

public static final java.lang.String SERVICEFACTORY_PROPERTY
A constant representing the property used to lookup the name of a ServiceFactory implementation class.

Field Value:
""

Constructor Details

ServiceFactory

protected ServiceFactory()
Protected constructor.

Method Details

createService

public Service createService(URL wsdlDocumentLocation,
                             QName serviceName)
            throws ServiceException
Create a Service instance.

Parameters:
wsdlDocumentLocation - URL for the WSDL document location
serviceName - QName for the service.

Returns:
Service.

Throws:
ServiceException - If any error in creation of the specified service


createService

public Service createService(QName serviceName)
            throws ServiceException
Create a Service instance.

Parameters:
serviceName - QName for the service

Returns:
Service.

Throws:
ServiceException - If any error in creation of the specified service


loadService

public Service loadService(java.lang.Class class1)
            throws ServiceException


loadService

public Service loadService(java.net.URL url,
                           java.lang.Class class1,
                           java.util.Properties properties)
            throws ServiceException


loadService

public Service loadService(java.net.URL url,
                           QName qname,
                           java.util.Properties properties)
            throws ServiceException


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.

Returns:
ServiceFactory.

Throws:
ServiceException -


Copyright B) 2005 Apache Web Services Project. All Rights Reserved.