"description" - The Root Element

WSDL Tutorials - Herong's Tutorial Examples

∟"description" - The Root Element

This section describes 'description', the root element of a WSDL document. The target namespace and other namespaces should be provided at the root element level.

"description" is the root element of a WSDL 2.0 document. The syntax of "description" looks like this:

<wsdl:description
  targetNamespace="tns_uri"
  xmlns:tns="tns_uri"
  xmlns:wsdl="http://www.w3.org/ns/wsdl"
  xmlns:xxxx="other_uri" ...>
  ...
</wsdl:description>

Notes on the "description" element:

targetNamespace="tns_uri" - Required. Provides a target namespace for all reference names defined in this WSDL document. tns_uri must be an absolute URI.
xmlns:tns="tns_uri" - Provides a namespace prefix for the target namespace for all reference names defined in this WSDL document. tns_uri must be the same one provided in the targetNamespace="tns_uri".
xmlns:wsdl="http://www.w3.org/ns/wsdl" - Provides a namespace prefix for all element names used in the WSDL core language.
xmlns:xxxx="other_uri" - Provides other namespace prefixes for element names imported from other languages as WSDL extensions.

Here is an example of "description" element:

<wsdl:description xmlns:wsdl="http://www.w3.org/ns/wsdl"
  xmlns:wsoap= "http://www.w3.org/ns/wsdl/soap"
  xmlns:hy="https://www.herongyang.com/Service/"
  targetNamespace="https://www.herongyang.com/Service/">
  ...
</wsdl:description>