org.apache.wsif
Class WSIFServiceFactory

java.lang.Object
  extended byorg.apache.wsif.WSIFServiceFactory
Direct Known Subclasses:
WSIFServiceFactoryImpl

public abstract class WSIFServiceFactory
extends java.lang.Object

Abstract factory class to create instances of WSIFService. Call newInstance to get a instance of the factory.

Author:
Mark Whitlock, Owen Burroughs, Andrzej Taramina

Constructor Summary
WSIFServiceFactory()
           
 
Method Summary
 void cachingOn(boolean on)
          Deprecated. Use setFeature(WSIFConstants.WSIF_FEATURE_SERVICE_CACHING, new Boolean(true)) or setFeature(WSIFConstants.WSIF_FEATURE_SERVICE_CACHING, new Boolean(false)) instead
 void clearServiceCache()
          Clear out the service cache.
abstract  java.lang.Object getFeature(java.lang.String name)
          Get the value for a feature currently being used by the factory.
abstract  java.util.Map getFeatures()
          Get the map of features currently being used by the factory.
abstract  WSIFService getService(javax.wsdl.Definition def)
          Returns a new WSIFService.
abstract  WSIFService getService(javax.wsdl.Definition def, javax.wsdl.Service service)
          Returns a new WSIFService.
abstract  WSIFService getService(javax.wsdl.Definition def, javax.wsdl.Service service, javax.wsdl.PortType portType)
          Returns a new WSIFService.
abstract  WSIFService getService(javax.wsdl.Definition def, java.lang.String serviceNS, java.lang.String serviceName, java.lang.String portTypeNS, java.lang.String portTypeName)
          Returns a new WSIFService.
abstract  WSIFService getService(java.lang.String wsdlLoc, java.lang.ClassLoader cl, java.lang.String serviceNS, java.lang.String serviceName, java.lang.String portTypeNS, java.lang.String portTypeName)
          Create a WSIF service instance from WSDL document URL using a ClassLoader to find local resources.
abstract  WSIFService getService(java.lang.String wsdlLoc, java.lang.String serviceNS, java.lang.String serviceName, java.lang.String portTypeNS, java.lang.String portTypeName)
          Create a WSIFService from WSDL document URL.
static WSIFServiceFactory newInstance()
          Creates a new instance of an implementation the abstract WSIFServiceFactory class.
abstract  void setFeature(java.lang.String name, java.lang.Object value)
          Set a feature on the WSIFServiceFactory.
abstract  void setFeatures(java.util.Map map)
          Set features on the WSIFServiceFactory.
 
Methods inherited from class java.lang.Object
equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

WSIFServiceFactory

public WSIFServiceFactory()
Method Detail

newInstance

public static WSIFServiceFactory newInstance()
Creates a new instance of an implementation the abstract WSIFServiceFactory class.


getService

public abstract WSIFService getService(java.lang.String wsdlLoc,
                                       java.lang.String serviceNS,
                                       java.lang.String serviceName,
                                       java.lang.String portTypeNS,
                                       java.lang.String portTypeName)
                                throws WSIFException
Create a WSIFService from WSDL document URL.
If serviceName or serviceNS is null, then WSDL document must have exactly one service in it.
If portTypeName or portTypeNS is null, then WSDL document must have exactly one portType in it and all ports of the selected service must implement the same portType.

Throws:
WSIFException

getService

public abstract WSIFService getService(java.lang.String wsdlLoc,
                                       java.lang.ClassLoader cl,
                                       java.lang.String serviceNS,
                                       java.lang.String serviceName,
                                       java.lang.String portTypeNS,
                                       java.lang.String portTypeName)
                                throws WSIFException
Create a WSIF service instance from WSDL document URL using a ClassLoader to find local resources.
If serviceName or serviceNS is null, then WSDL document must have exactly one service in it.
If portTypeName or portTypeNS is null, then WSDL document must have exactly one portType in it and all ports of the selected service must implement the same portType.

Throws:
WSIFException

getService

public abstract WSIFService getService(javax.wsdl.Definition def)
                                throws WSIFException
Returns a new WSIFService.

Throws:
WSIFException

getService

public abstract WSIFService getService(javax.wsdl.Definition def,
                                       javax.wsdl.Service service)
                                throws WSIFException
Returns a new WSIFService.

Throws:
WSIFException

getService

public abstract WSIFService getService(javax.wsdl.Definition def,
                                       javax.wsdl.Service service,
                                       javax.wsdl.PortType portType)
                                throws WSIFException
Returns a new WSIFService.

Throws:
WSIFException

getService

public abstract WSIFService getService(javax.wsdl.Definition def,
                                       java.lang.String serviceNS,
                                       java.lang.String serviceName,
                                       java.lang.String portTypeNS,
                                       java.lang.String portTypeName)
                                throws WSIFException
Returns a new WSIFService.

Throws:
WSIFException

cachingOn

public void cachingOn(boolean on)
Deprecated. Use setFeature(WSIFConstants.WSIF_FEATURE_SERVICE_CACHING, new Boolean(true)) or setFeature(WSIFConstants.WSIF_FEATURE_SERVICE_CACHING, new Boolean(false)) instead

Set caching on services on/off. Off is the default

Parameters:
on - Flag to indicate whether or not caching of services should be used

clearServiceCache

public void clearServiceCache()
Clear out the service cache. Useful if wsdl definitions can change during runtime operations.


setFeature

public abstract void setFeature(java.lang.String name,
                                java.lang.Object value)
Set a feature on the WSIFServiceFactory. The names of supported features are stored as constants in the WSIFConstants class. The names of these constants have a convention of starting WSIF_FEATURE_. For more information about individual features, see the field details for the feature constants.

Note: features should be set before calls to the getService methods.

Parameters:
name - The name of the feature to set
value - The value of the feature

setFeatures

public abstract void setFeatures(java.util.Map map)
Set features on the WSIFServiceFactory. Calling this method will replace the currently set features with those configured in the Map passed in. The names of supported features are stored as constants in the WSIFConstants class. The names of these constants have a convention of starting WSIF_FEATURE_. For more information about individual features, see the field details for the feature constants.

Note: features should be set before calls to the getService methods.

Parameters:
map - A Map containing all the features to set on the factory

getFeatures

public abstract java.util.Map getFeatures()
Get the map of features currently being used by the factory.

Returns:
The map of features

getFeature

public abstract java.lang.Object getFeature(java.lang.String name)
Get the value for a feature currently being used by the factory.

Returns:
The feature value


Copyright ? 2002, 2006 Apache XML Project. All Rights Reserved.