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" ?>
    xmlns=           ""
    targetNamespace= ""
    xmlns:tns=       ""
    xmlns:stns =     ""
    xmlns:wsoap=     ""
    xmlns:soap=      ""
    xmlns:wsdlx=     "" >


Each of these name spaces are explained below.


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:


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.


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).


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.


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


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


Points to the WSDL Extensions URI.

Jakob Jenkov

Featured Videos

Java ForkJoinPool

P2P Networks Introduction


Java Persistence
Close TOC
All Tutorial Trails
All Trails
Table of contents (TOC) for this tutorial trail
Trail TOC
Table of contents (TOC) for this tutorial
Page TOC
Previous tutorial in this tutorial trail
Next tutorial in this tutorial trail