com.ibm.wsdl.xml

Class WSDLReaderImpl

Implemented Interfaces:
WSDLReader

public class WSDLReaderImpl
extends java.lang.Object
implements WSDLReader

This class describes a collection of methods that enable conversion of a WSDL document (in XML, following the WSDL schema described in the WSDL specification) into a WSDL model.

Authors:
Matthew J. Duftler
Nirmal Mukhi

Field Summary

protected Map
allSchemas
protected ExtensionRegistry
extReg
protected String
factoryImplName
protected boolean
importDocuments
protected WSDLLocator
loc
protected boolean
verbose

Method Summary

ExtensionRegistry
getExtensionRegistry()
Get the extension registry, if one was set.
String
getFactoryImplName()
Get the factoryImplName, if one was set.
boolean
getFeature(String name)
Gets the value of the specified feature.
protected Binding
parseBinding(Element bindingEl, Definition def)
protected BindingFault
parseBindingFault(Element bindingFaultEl, Definition def)
protected BindingInput
parseBindingInput(Element bindingInputEl, Definition def)
protected BindingOperation
parseBindingOperation(Element bindingOperationEl, PortType portType, Definition def)
protected BindingOutput
parseBindingOutput(Element bindingOutputEl, Definition def)
protected Definition
parseDefinitions(String documentBaseURI, Element defEl, Map importedDefs)
protected Object
parseExtensibilityAttribute(Element el, int attrType, String attrValue, Definition def)
protected void
parseExtensibilityAttributes(Element el, Class parentType, AttributeExtensible attrExt, Definition def)
protected ExtensibilityElement
parseExtensibilityElement(Class parentType, Element el, Definition def)
protected Fault
parseFault(Element faultEl, Definition def)
protected Import
parseImport(Element importEl, Definition def, Map importedDefs)
protected Input
parseInput(Element inputEl, Definition def)
protected Message
parseMessage(Element msgEl, Definition def)
protected Operation
parseOperation(Element opEl, PortType portType, Definition def)
protected Output
parseOutput(Element outputEl, Definition def)
protected Part
parsePart(Element partEl, Definition def)
protected Port
parsePort(Element portEl, Definition def)
protected PortType
parsePortType(Element portTypeEl, Definition def)
protected ExtensibilityElement
parseSchema(Class parentType, Element el, Definition def)
protected ExtensibilityElement
parseSchema(Class parentType, Element el, Definition def, ExtensionRegistry extReg)
protected Service
parseService(Element serviceEl, Definition def)
protected Types
parseTypes(Element typesEl, Definition def)
Definition
readWSDL(String wsdlURI)
Read the WSDL document accessible via the specified URI into a WSDL definition.
Definition
readWSDL(String documentBaseURI, Document wsdlDocument)
Read the specified WSDL document into a WSDL definition.
Definition
readWSDL(String documentBaseURI, Element definitionsElement)
Read the specified <wsdl:definitions> element into a WSDL definition.
protected Definition
readWSDL(String documentBaseURI, Element definitionsElement, Map importedDefs)
Definition
readWSDL(String documentBaseURI, InputSource inputSource)
Read a WSDL document into a WSDL definition.
Definition
readWSDL(String contextURI, String wsdlURI)
Read the WSDL document accessible via the specified URI into a WSDL definition.
Definition
readWSDL(WSDLLocator locator)
Read a WSDL document into a WSDL definition.
void
setExtensionRegistry(ExtensionRegistry extReg)
Set the extension registry to be used when reading WSDL documents into a WSDL definition.
void
setFactoryImplName(String factoryImplName)
Set a different factory implementation to use for creating definitions when reading WSDL documents.
void
setFeature(String name, boolean value)
Sets the specified feature to the specified value.

Field Details

allSchemas

protected Map allSchemas


extReg

protected ExtensionRegistry extReg


factoryImplName

protected String factoryImplName


importDocuments

protected boolean importDocuments


loc

protected WSDLLocator loc


verbose

protected boolean verbose

Method Details

getExtensionRegistry

public ExtensionRegistry getExtensionRegistry()
Get the extension registry, if one was set. Default is null.
Specified by:
getExtensionRegistry in interface WSDLReader


getFactoryImplName

public String getFactoryImplName()
Get the factoryImplName, if one was set. Default is null.
Specified by:
getFactoryImplName in interface WSDLReader


getFeature

public boolean getFeature(String name)
            throws IllegalArgumentException
Gets the value of the specified feature.
Specified by:
getFeature in interface WSDLReader

Parameters:
name - the name of the feature to get the value of.

See Also:
setFeature(String,boolean)


parseBinding

protected Binding parseBinding(Element bindingEl,
                               Definition def)
            throws WSDLException


parseBindingFault

protected BindingFault parseBindingFault(Element bindingFaultEl,
                                         Definition def)
            throws WSDLException


parseBindingInput

protected BindingInput parseBindingInput(Element bindingInputEl,
                                         Definition def)
            throws WSDLException


parseBindingOperation

protected BindingOperation parseBindingOperation(Element bindingOperationEl,
                                                 PortType portType,
                                                 Definition def)
            throws WSDLException


parseBindingOutput

protected BindingOutput parseBindingOutput(Element bindingOutputEl,
                                           Definition def)
            throws WSDLException


parseDefinitions

protected Definition parseDefinitions(String documentBaseURI,
                                      Element defEl,
                                      Map importedDefs)
            throws WSDLException


parseExtensibilityAttribute

protected Object parseExtensibilityAttribute(Element el,
                                             int attrType,
                                             String attrValue,
                                             Definition def)
            throws WSDLException


parseExtensibilityAttributes

protected void parseExtensibilityAttributes(Element el,
                                            Class parentType,
                                            AttributeExtensible attrExt,
                                            Definition def)
            throws WSDLException


parseExtensibilityElement

protected ExtensibilityElement parseExtensibilityElement(Class parentType,
                                                         Element el,
                                                         Definition def)
            throws WSDLException


parseFault

protected Fault parseFault(Element faultEl,
                           Definition def)
            throws WSDLException


parseImport

protected Import parseImport(Element importEl,
                             Definition def,
                             Map importedDefs)
            throws WSDLException


parseInput

protected Input parseInput(Element inputEl,
                           Definition def)
            throws WSDLException


parseMessage

protected Message parseMessage(Element msgEl,
                               Definition def)
            throws WSDLException


parseOperation

protected Operation parseOperation(Element opEl,
                                   PortType portType,
                                   Definition def)
            throws WSDLException


parseOutput

protected Output parseOutput(Element outputEl,
                             Definition def)
            throws WSDLException


parsePart

protected Part parsePart(Element partEl,
                         Definition def)
            throws WSDLException


parsePort

protected Port parsePort(Element portEl,
                         Definition def)
            throws WSDLException


parsePortType

protected PortType parsePortType(Element portTypeEl,
                                 Definition def)
            throws WSDLException


parseSchema

protected ExtensibilityElement parseSchema(Class parentType,
                                           Element el,
                                           Definition def)
            throws WSDLException


parseSchema

protected ExtensibilityElement parseSchema(Class parentType,
                                           Element el,
                                           Definition def,
                                           ExtensionRegistry extReg)
            throws WSDLException


parseService

protected Service parseService(Element serviceEl,
                               Definition def)
            throws WSDLException


parseTypes

protected Types parseTypes(Element typesEl,
                           Definition def)
            throws WSDLException


readWSDL

public Definition readWSDL(String wsdlURI)
            throws WSDLException
Read the WSDL document accessible via the specified URI into a WSDL definition.
Specified by:
readWSDL in interface WSDLReader

Parameters:
wsdlURI - a URI (can be a filename or URL) pointing to a WSDL XML definition.

Returns:
the definition.


readWSDL

public Definition readWSDL(String documentBaseURI,
                           Document wsdlDocument)
            throws WSDLException
Read the specified WSDL document into a WSDL definition.
Specified by:
readWSDL in interface WSDLReader

Parameters:
documentBaseURI - the document base URI of the WSDL definition described by the document. Will be set as the documentBaseURI of the returned Definition. Can be null, in which case it will be ignored.
wsdlDocument - the WSDL document, an XML document obeying the WSDL schema.

Returns:
the definition described in the document.


readWSDL

public Definition readWSDL(String documentBaseURI,
                           Element definitionsElement)
            throws WSDLException
Read the specified <wsdl:definitions> element into a WSDL definition.
Specified by:
readWSDL in interface WSDLReader

Parameters:
documentBaseURI - the document base URI of the WSDL definition described by the element. Will be set as the documentBaseURI of the returned Definition. Can be null, in which case it will be ignored.
definitionsElement - the <wsdl:definitions> element

Returns:
the definition described by the element.


readWSDL

protected Definition readWSDL(String documentBaseURI,
                              Element definitionsElement,
                              Map importedDefs)
            throws WSDLException


readWSDL

public Definition readWSDL(String documentBaseURI,
                           InputSource inputSource)
            throws WSDLException
Read a WSDL document into a WSDL definition.
Specified by:
readWSDL in interface WSDLReader

Parameters:
documentBaseURI - the document base URI of the WSDL definition described by the document. Will be set as the documentBaseURI of the returned Definition. Can be null, in which case it will be ignored.
inputSource - an InputSource pointing to the WSDL document, an XML document obeying the WSDL schema.

Returns:
the definition described in the document pointed to by the InputSource.


readWSDL

public Definition readWSDL(String contextURI,
                           String wsdlURI)
            throws WSDLException
Read the WSDL document accessible via the specified URI into a WSDL definition.
Specified by:
readWSDL in interface WSDLReader

Parameters:
contextURI - the context in which to resolve the wsdlURI, if the wsdlURI is relative. Can be null, in which case it will be ignored.
wsdlURI - a URI (can be a filename or URL) pointing to a WSDL XML definition.

Returns:
the definition.


readWSDL

public Definition readWSDL(WSDLLocator locator)
            throws WSDLException
Read a WSDL document into a WSDL definition.
Specified by:
readWSDL in interface WSDLReader

Parameters:
locator - A WSDLLocator object used to provide InputSources pointing to the wsdl file.

Returns:
the definition described in the document


setExtensionRegistry

public void setExtensionRegistry(ExtensionRegistry extReg)
Set the extension registry to be used when reading WSDL documents into a WSDL definition. If an extension registry is set, that is the extension registry that will be set as the extensionRegistry property of the definitions resulting from invoking readWSDL(...). Default is null.
Specified by:
setExtensionRegistry in interface WSDLReader

Parameters:
extReg - the extension registry to use for new definitions


setFactoryImplName

public void setFactoryImplName(String factoryImplName)
            throws UnsupportedOperationException
Set a different factory implementation to use for creating definitions when reading WSDL documents. As some WSDLReader implementations may only be capable of creating definitions using the same factory implementation from which the reader was obtained, this method is optional. Default is null.
Specified by:
setFactoryImplName in interface WSDLReader

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


setFeature

public void setFeature(String name,
                       boolean value)
            throws IllegalArgumentException
Sets the specified feature to the specified value.

The supported features are:

Name Description Default Value
javax.wsdl.verbose
If set to true, status messages will be displayed.
true
javax.wsdl.importDocuments
If set to true, imported WSDL documents will be retrieved and processed.
true

All feature names must be fully-qualified, Java package style. All names starting with javax.wsdl. are reserved for features defined by the JWSDL specification. It is recommended that implementation- specific features be fully-qualified to match the package name of that implementation. For example: com.abc.featureName

Specified by:
setFeature in interface WSDLReader

Parameters:
name - the name of the feature to be set.
value - the value to set the feature to.

See Also:
getFeature(String)


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