org.ws4d.java.description.wsdl

Interface WSDLBindingBuilder

All Known Implementing Classes:

SOAP12DocumentLiteralHTTPBindingBuilder, SOAPDocumentLiteralHTTPBindingBuilder

public interface WSDLBindingBuilder

Method Summary

Modifier and Type	Method and Description
WSDLBinding	buildBinding(QName name, QName type)
WSDLBinding	getBinding() Returns the resulting binding after processing all binding-specific information within a WSDL binding definition.
java.lang.String	getNamespace() Returns the namespace URI, which uniquely characterizes the specific binding for which this binding builder is responsible.
void	parseBindingExtension(QName bindingName, QName portType, ElementParser parser) Reads an extension element to a binding WSDL definition from the supplied element parser parser.
void	parseFaultExtension(java.lang.String faultName, ElementParser parser, java.lang.String operationName) Reads an extension element to a fault element within a WSDL binding definition from the supplied element parser parser.
void	parseInputExtension(java.lang.String inputName, ElementParser parser, java.lang.String operationName) Reads an extension element to an input element within a WSDL binding definition from the supplied element parser parser.
java.lang.String	parseOperationExtension(java.lang.String operationName, ElementParser parser) Reads an extension element to an operation element within a WSDL binding definition from the supplied element parser parser.
void	parseOutputExtension(java.lang.String outputName, ElementParser parser, java.lang.String operationName) Reads an extension element to an output element within a WSDL binding definition from the supplied element parser parser.
WSDLPort	parsePortExtension(java.lang.String portName, QName bindingName, ElementParser childParser) Parses an extension section within a WSDL port definition and returns a WSDLPort instance representing the port together with its extension.
void	setWSDL(WSDL wsdl)

Method Detail

getNamespace

java.lang.String getNamespace()

Returns the namespace URI, which uniquely characterizes the specific binding for which this binding builder is responsible.

Returns:

the binding-specific URI for this binding builder

parseBindingExtension

void parseBindingExtension(QName bindingName,
                           QName portType,
                           ElementParser parser)
                    throws UnsupportedBindingException

Reads an extension element to a binding WSDL definition from the supplied element parser parser.

Parameters:

bindingName - the fully qualified name of the surrounding binding element

portType - the fully qualified name of the port type to which the surrounding binding refers

parser - the element parser from which to obtain the binding extension element

Throws:

UnsupportedBindingException - in case a binding extension is found during parsing which doesn't conform to the expectations of this binding builder instance

parseOperationExtension

java.lang.String parseOperationExtension(java.lang.String operationName,
                                         ElementParser parser)
                                  throws UnsupportedBindingException

Reads an extension element to an operation element within a WSDL binding definition from the supplied element parser parser.

Parameters:

operationName - the local name of the surrounding operation element

parser - the element parser from which to obtain the operation-related binding extension element

Returns:

soapAction of Binding Operation

Throws:

UnsupportedBindingException - in case a operation-related binding extension is found during parsing which doesn't conform to the expectations of this binding builder instance

parseInputExtension

void parseInputExtension(java.lang.String inputName,
                         ElementParser parser,
                         java.lang.String operationName)
                  throws UnsupportedBindingException

Reads an extension element to an input element within a WSDL binding definition from the supplied element parser parser.

Parameters:

inputName - the local name of the surrounding input element

parser - the element parser from which to obtain the input-related binding extension element

Throws:

UnsupportedBindingException - in case an input-related binding extension is found during parsing which doesn't conform to the expectations of this binding builder instance

parseOutputExtension

void parseOutputExtension(java.lang.String outputName,
                          ElementParser parser,
                          java.lang.String operationName)
                   throws UnsupportedBindingException

Reads an extension element to an output element within a WSDL binding definition from the supplied element parser parser.

Parameters:

outputName - the local name of the surrounding output element

parser - the element parser from which to obtain the output-related binding extension element

Throws:

UnsupportedBindingException - in case an output-related binding extension is found during parsing which doesn't conform to the expectations of this binding builder instance

parseFaultExtension

void parseFaultExtension(java.lang.String faultName,
                         ElementParser parser,
                         java.lang.String operationName)
                  throws UnsupportedBindingException

Reads an extension element to a fault element within a WSDL binding definition from the supplied element parser parser.

Parameters:

faultName - the local name of the surrounding fault element

parser - the element parser from which to obtain the fault-related binding extension element

Throws:

UnsupportedBindingException - in case a fault-related binding extension is found during parsing which doesn't conform to the expectations of this binding builder instance

getBinding

WSDLBinding getBinding()

Returns the resulting binding after processing all binding-specific information within a WSDL binding definition. This method should be called after processing all extensibility elements of the WSDL binding definition by means of the following methods parseBindingExtension(QName, QName, ElementParser) , parseOperationExtension(String, ElementParser) , WSDLBindingBuilder#parseInputExtension(String, ElementParser), WSDLBindingBuilder#parseOutputExtension(String, ElementParser) and WSDLBindingBuilder#parseFaultExtension(String, ElementParser) . Otherwise, it should return null.

Returns:

the resulting binding or null, if still no binding was processed

parsePortExtension

WSDLPort parsePortExtension(java.lang.String portName,
                            QName bindingName,
                            ElementParser childParser)

Parses an extension section within a WSDL port definition and returns a WSDLPort instance representing the port together with its extension.

Parameters:

portName - the name of the port

bindingName - the name of the binding to which the port refers

childParser - the element parser from which to obtain the extension information

Returns:

a concrete WSDL port instance containing any extensibility information found during parsing

buildBinding

WSDLBinding buildBinding(QName name,
                         QName type)

setWSDL

void setWSDL(WSDL wsdl)