javax.wsdl.factory
Class WSDLFactory

java.lang.Object
  javax.wsdl.factory.WSDLFactory

Direct Known Subclasses:

WSDLFactoryImpl

public abstract class WSDLFactory
extends java.lang.Object

This abstract class defines a factory API that enables applications to obtain a WSDLFactory capable of producing new Definitions, new WSDLReaders, and new WSDLWriters. Some ideas used here have been shamelessly copied from the wonderful JAXP and Xerces work.

Author:

Matthew J. Duftler (duftler@us.ibm.com)

Constructor Summary

WSDLFactory()

Method Summary

abstract Definition	newDefinition() Create a new instance of a Definition.
static WSDLFactory	newInstance() Get a new instance of a WSDLFactory.
static WSDLFactory	newInstance(java.lang.String factoryImplName) Get a new instance of a WSDLFactory.
static WSDLFactory	newInstance(java.lang.String factoryImplName, java.lang.ClassLoader classLoader) Get a new instance of a WSDLFactory.
abstract ExtensionRegistry	newPopulatedExtensionRegistry() Create a new instance of an ExtensionRegistry with pre-registered serializers/deserializers for the SOAP, HTTP and MIME extensions.
abstract WSDLReader	newWSDLReader() Create a new instance of a WSDLReader.
abstract WSDLWriter	newWSDLWriter() Create a new instance of a WSDLWriter.

Methods inherited from class java.lang.Object

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

Constructor Detail

WSDLFactory

public WSDLFactory()

Method Detail

newInstance

public static WSDLFactory newInstance()
                               throws WSDLException

Get a new instance of a WSDLFactory. This method follows (almost) the same basic sequence of steps that JAXP follows to determine the fully-qualified class name of the class which implements WSDLFactory.

The steps in order are:

1. Check the property file META-INF/services/javax.wsdl.factory.WSDLFactory.
2. Check the javax.wsdl.factory.WSDLFactory system property.
3. Check the lib/wsdl.properties file in the JRE directory. The key will have the same name as the above system property.
4. Use the default class name provided by the implementation.

Once an instance of a WSDLFactory is obtained, invoke newDefinition(), newWSDLReader(), or newWSDLWriter(), to create the desired instances.

Throws:

WSDLException

newInstance

public static WSDLFactory newInstance(java.lang.String factoryImplName)
                               throws WSDLException

Get a new instance of a WSDLFactory. This method returns an instance of the class factoryImplName. Once an instance of a WSDLFactory is obtained, invoke newDefinition(), newWSDLReader(), or newWSDLWriter(), to create the desired instances.

Parameters:

factoryImplName - the fully-qualified class name of the class which provides a concrete implementation of the abstract class WSDLFactory.

Throws:

WSDLException

newInstance

public static WSDLFactory newInstance(java.lang.String factoryImplName,
                                      java.lang.ClassLoader classLoader)
                               throws WSDLException

Get a new instance of a WSDLFactory. This method returns an instance of the class factoryImplName, using the specified ClassLoader. Once an instance of a WSDLFactory is obtained, invoke newDefinition(), newWSDLReader(), or newWSDLWriter(), to create the desired instances.

Parameters:

factoryImplName - the fully-qualified class name of the class which provides a concrete implementation of the abstract class WSDLFactory.

classLoader - the ClassLoader to use to load the WSDLFactory implementation.

Throws:

WSDLException

newDefinition

public abstract Definition newDefinition()

Create a new instance of a Definition.

newWSDLReader

public abstract WSDLReader newWSDLReader()

Create a new instance of a WSDLReader.

newWSDLWriter

public abstract WSDLWriter newWSDLWriter()

Create a new instance of a WSDLWriter.

newPopulatedExtensionRegistry

public abstract ExtensionRegistry newPopulatedExtensionRegistry()

Create a new instance of an ExtensionRegistry with pre-registered serializers/deserializers for the SOAP, HTTP and MIME extensions. Java extensionTypes are also mapped for all the SOAP, HTTP and MIME extensions.