Tech and Media Labs
This site uses cookies to improve the user experience.




WSDL 2.0 - description

Jakob Jenkov
Last update: 2014-05-23

The WSDL description element is the root element of a WSDL 2.0 file. The description element begin tag usually contains a set of name space declarations which are used throughout the WSDL file.

Here is an example description element:

<?xml version="1.0" encoding="utf-8" ?>
<description
    xmlns=           "http://www.w3.org/ns/wsdl"
    targetNamespace= "http://jenkov.com/MyService"
    xmlns:tns=       "http://jenkov.com/MyService"
    xmlns:stns =     "http://jenkov.com/MyService/schema"
    xmlns:wsoap=     "http://www.w3.org/ns/wsdl/soap"
    xmlns:soap=      "http://www.w3.org/2003/05/soap-envelope"
    xmlns:wsdlx=     "http://www.w3.org/ns/wsdl-extensions" >

</description>

Each of these name spaces are explained below.

xmlns

The xmlns attribute sets the default name space of the description element. The default name space is thus applied to all elements inside the description element, which does not explicitly declare another name space for themselves.

The default name space is set to a standard value for WSDL files: http://www.w3.org/ns/wsdl

targetNameSpace

This attribute contains the name space of your web service. You can choose this name space freely, but there is a convention saying that the URI should point to the WSDL of the service.

xmlns:tns

This name space should be set to the same URI as the targetNameSpace attribute. That way you can refer to the target name space via this name space prefix (tns).

xmlns:stns

This name space attribute declares the Schema Target Name Space URI. In other words, it should point to the URI for the XML schema's name space, of the schema you declare for your web service types, in the types element.

xmlns:wsoap

Points to the WSDL SOAP URI. Used in the bindings element of the WSDL.

xmlns:soap

Points to the SOAP URI of the SOAP version the web service described by the WSDL is using.

xmlns:wsdlx

Points to the WSDL Extensions URI.

Jakob Jenkov




Copyright  Jenkov Aps
Close TOC