org.ws4d.java.wsdl
Interface WSDLBindingBuilder

All Known Implementing Classes:
SOAP12DocumentLiteralHTTPBindingBuilder

public interface WSDLBindingBuilder


Method Summary
 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)
          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)
          Reads an extension element to an input element within a WSDL binding definition from the supplied element parser parser.
 void 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)
          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.
 

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

void 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
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)
                         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)
                          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)
                         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) , parseInputExtension(String, ElementParser), parseOutputExtension(String, ElementParser) and 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