javax.wsdl.xml
Interface WSDLReader

public interface WSDLReader

This interface 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.

Component:

WSDL-API interfaces

Method Summary

ExtensionRegistry	getExtensionRegistry() Get the extension registry, if one was set.
java.lang.String	getFactoryImplName() Get the factoryImplName, if one was set.
boolean	getFeature(java.lang.String name) Gets the value of the specified feature.
Definition	readWSDL(java.lang.String wsdlURI) Read the WSDL document accessible via the specified URI into a WSDL definition.
Definition	readWSDL(java.lang.String documentBaseURI, org.w3c.dom.Document wsdlDocument) Read the specified WSDL document into a WSDL definition.
Definition	readWSDL(java.lang.String documentBaseURI, org.w3c.dom.Element definitionsElement) Read the specified <wsdl:definitions> element into a WSDL definition.
Definition	readWSDL(java.lang.String documentBaseURI, org.xml.sax.InputSource inputSource) Read a WSDL document into a WSDL definition.
Definition	readWSDL(java.lang.String contextURI, java.lang.String wsdlURI) Read the WSDL document accessible via the specified URI into a WSDL definition.
Definition	readWSDL(WSDLLocator wsdllocator) 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(java.lang.String factoryImplName) Set a different factory implementation to use for creating definitions when reading WSDL documents.
void	setFeature(java.lang.String name, boolean value) Sets the specified feature to the specified value.

Method Detail

setFeature

public void setFeature(java.lang.String name,
                       boolean value)
                throws java.lang.IllegalArgumentException

Sets the specified feature to the specified value.

The minimum features that must be supported are:

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

Parameters:

name - the name of the feature to be set.

value - the value to set the feature to.

Throws:

java.lang.IllegalArgumentException - if the feature name is not recognized.

See Also:

getFeature(String)

getFeature

public boolean getFeature(java.lang.String name)
                   throws java.lang.IllegalArgumentException

Gets the value of the specified feature.

Parameters:

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

Throws:

java.lang.IllegalArgumentException - if the feature name is not recognized.

See Also:

setFeature(String, boolean)

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.

Parameters:

extReg - the extension registry to use for new definitions

getExtensionRegistry

public ExtensionRegistry getExtensionRegistry()

Get the extension registry, if one was set. Default is null.

setFactoryImplName

public void setFactoryImplName(java.lang.String factoryImplName)
                        throws java.lang.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.

Parameters:

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

Throws:

java.lang.UnsupportedOperationException - if this method is invoked on an implementation which does not support it.

getFactoryImplName

public java.lang.String getFactoryImplName()

Get the factoryImplName, if one was set. Default is null.

readWSDL

public Definition readWSDL(java.lang.String wsdlURI)
                    throws WSDLException

Read the WSDL document accessible via the specified URI into a WSDL definition.

Parameters:

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

Returns:

the definition.

Throws:

WSDLException

readWSDL

public Definition readWSDL(java.lang.String contextURI,
                           java.lang.String wsdlURI)
                    throws WSDLException

Read the WSDL document accessible via the specified URI into a WSDL definition.

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.

Throws:

WSDLException

readWSDL

public Definition readWSDL(java.lang.String documentBaseURI,
                           org.w3c.dom.Element definitionsElement)
                    throws WSDLException

Read the specified <wsdl:definitions> element into a WSDL definition.

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.

Throws:

WSDLException

readWSDL

public Definition readWSDL(java.lang.String documentBaseURI,
                           org.w3c.dom.Document wsdlDocument)
                    throws WSDLException

Read the specified WSDL document into a WSDL definition.

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.

Throws:

WSDLException

readWSDL

public Definition readWSDL(java.lang.String documentBaseURI,
                           org.xml.sax.InputSource inputSource)
                    throws WSDLException

Read a WSDL document into a WSDL definition.

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.

Throws:

WSDLException

readWSDL

public Definition readWSDL(WSDLLocator wsdllocator)
                    throws WSDLException

Read a WSDL document into a WSDL definition.

Parameters:

wsdllocator - A WSDLLocator object used to provide Readers pointing to the wsdl file.

Returns:

the definition described in the document

Throws:

WSDLException