"message" - Message Type Definition Element

WSDL Tutorials - Herong's Tutorial Examples

∟"message" - Message Type Definition Element

This section describes 'message', a definition element that defines a message type with one or multiple parts. A part is defined to be of a given data type.

"message" is a top level element of a WSDL 1.1 document. "message" is used to define a message type with one or multiple parts with "part" sub elements. A part is defined to be of a given data type. The syntax of "message" looks like this:

  <wsdl:message name="nmtoken1">
    <wsdl:part name="nmtoken2" element="qname1" type="qname2"/>
    ,..
  </wsdl:message>

Notes on the "message" element:

name="nmtoken1" - Provides a reference name to this message type.
name="nmtoken2" - Provides a reference name to this part.
element="qname1" - Specifies the data type of this part by referring to an "element" defined in the XML Schema included in the "types" element.
type="qname2" - Specifies the data type of this part by referring a to "simpleType" or a "complexType" defined in the XML Schema included in the "types" element.
You can use element="qname1" or type="qname2", no need to use both.

Here is an example of "message" element:

  <wsdl:message name="helloInputMessage">
    <wsdl:part name="helloInputPart" element="hy:HelloRequest"/>
  </wsdl:message>

In this example,

Message type, helloInputMessage, is defined with one part, helloInputPart.
Part, helloInputPart, is defined to be of data type defined earlier in the element, HelloRequest.
To refer to a name defined in the WSDL document, you need to use its qname or qualified name - prefix the name with the target namespace.