javax.wsdl.factory

Class WSDLFactory

Known Direct 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)

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(String factoryImplName)
Get a new instance of a WSDLFactory.
static WSDLFactory
newInstance(String factoryImplName, 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.

Method Details

newDefinition

public abstract Definition newDefinition()
Create a new instance of a Definition.

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.


newInstance

public static WSDLFactory newInstance(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.

newInstance

public static WSDLFactory newInstance(String factoryImplName,
                                      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.

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.

newWSDLReader

public abstract WSDLReader newWSDLReader()
Create a new instance of a WSDLReader.

newWSDLWriter

public abstract WSDLWriter newWSDLWriter()
Create a new instance of a WSDLWriter.

Copyright B) 2003,2006 IBM. All Rights Reserved.