SOAP Versions

The JADE Web services framework supports SOAP version 1.1 and version 1.2. A JADE Web service consumer creates request messages using the SOAP version that matches the version specified in the imported WSDL.

When you generate the WSDL for a JADE Web service provider you can choose whether the provider expects incoming messages to be formatted according to the SOAP 1.2 standard or the earlier SOAP 1.1 standard. For more details about the specifying the SOAP version, see "Defining a Web Services Provider Application", later in this chapter.

If a Web service provider is running and an incoming message for a SOAP version different from that specified is processed, a Version Mismatch SOAP error is returned and the message is not processed. If the version of the SOAP request message is as expected, the request message is processed and a response is generated using the same SOAP version.

You can import WSDL definitions for both SOAP 1.1 and SOAP 1.2. In that case, a separate JadeWebServiceConsumer subclass is created using the service name for each service definition in the WSDL file if the service contains one port definition.

For service definitions containing more than one port definition, a JadeWebServiceConsumer subclass is created using the port name for each port definition.

Each port definition is bound to SOAP 1.1 or to SOAP 1.2, so that each consumer processes all messages using this SOAP version, although different JadeWebServiceConsumer subclasses can use differing SOAP versions.

When you select a JadeWebServiceConsumer subclass in the Class List of the JADE development environment Class Browser, the SOAP level (that is, SOAP 1.1 consumer or SOAP 1.2 consumer) for that class is displayed in the editor pane with the other class details.