Web Services Description Language - Wikipedia, the free encyclopedia

http://en.wikipedia.org/wiki/Web_Services_Description_Language[4/11/2014 8:33:24 AM]

Web Services Description
Language
Filename
extension
. wsdl
Internet media
type
appl i cat i on/ wsdl +xml
Developed by World Wide Web
Consortium
Contained by XML
Standard(s) 2.0 Recommendation
From Wikipedia, the free encyclopedia
This article is about an information technology specification. For the radio station, see WSDL (FM).
The Web Services Description Language (WSDL) is an
XML-based interface description language that is used for
describing the functionality offered by a web service. The
acronym is also used for any specific WSDL description of a
web service (also referred to as a WSDL file), which provides
a machine-readable description of how the service can be
called, what parameters it expects, and what data structures it
returns. It thus serves a purpose that corresponds roughly to
that of a method signature in a programming language.
The current version of WSDL is WSDL 2.0. The meaning of the
acronym has changed from version 1.1 where the D stood for
Definition.
Contents [hide]
1 Description
2 Example WSDL file
3 History
4 See also
5 References
6 External links
The WSDL
describes services
as collections of network endpoints, or ports. The WSDL
specifications provides an XML format for documents for this
purpose. The abstract definitions of ports and messages are
separated from their concrete use or instance, allowing the
reuse of these definitions. A port is defined by associating a
network address with a reusable binding, and a collection of
Web Services Description Language
Description [edit]
Article
Talk
Read
Edit
View history
Create account
Log in
Personal tools
Namespaces
Variants
Views
Actions
Search
Search
Main page
Contents
Featured content
Current events
Random article
Donate to Wikipedia
Wikimedia Shop
Help
About Wikipedia
Community portal
Recent changes
Contact page
What links here
Related changes
Upload file
Special pages
Permanent link
Page information
Data item
Cite this page
Create a book
Download as PDF
Printable version

Catal
etina
Deutsch
Espaol

Franais
Navigation
Interaction
Tools
Print/export
Languages
Go
Web Services Description Language - Wikipedia, the free encyclopedia
http://en.wikipedia.org/wiki/Web_Services_Description_Language[4/11/2014 8:33:24 AM]
ports defines a service. Messages are abstract descriptions of
the data being exchanged, and port types are abstract
collections of supported operations. The concrete protocol and
data format specifications for a particular port type constitutes a
reusable binding, where the operations and messages are then
bound to a concrete network protocol and message format. In
this way, WSDL describes the public interface to the Web service.
WSDL is often used in combination with SOAP and an XML Schema to provide Web services over the
Internet. A client program connecting to a Web service can read the WSDL file to determine what
operations are available on the server. Any special datatypes used are embedded in the WSDL file in the
form of XML Schema. The client can then use SOAP to actually call one of the operations listed in the WSDL
file using for example XML over HTTP.
The current version of the specification is 2.0; version 1.1 has not been endorsed by the W3C but version
2.0 is a W3C recommendation.
[1]
WSDL 1.2 was renamed WSDL 2.0 because of its substantial differences
from WSDL 1.1. By accepting binding to all the HTTP request methods (not only GET and POST as in
version 1.1), the WSDL 2.0 specification offers better support for RESTful web services, and is much simpler
to implement.
[2][3]
However support for this specification is still poor in software development kits for Web
Services which often offer tools only for WSDL 1.1.
[dubious discuss]
Furthermore, the latest version (version
2.0) of the Business Process Execution Language (BPEL) only supports WSDL 1.1.
WSDL
1.1
Term
WSDL
2.0
Term
Description
Service Service
Contains a set of system functions that have been exposed to the Web-based
protocols.
Port Endpoint
Defines the address or connection point to a Web service. It is typically represented
by a simple HTTP URL string.
Binding Binding
Specifies the interface and defines the SOAP binding style (RPC/Document) and
transport (SOAP Protocol). The binding section also defines the operations.
PortType Interface
Defines a Web service, the operations that can be performed, and the messages that
are used to perform the operation.
Operation Operation
Defines the SOAP actions and the way the message is encoded, for example, "literal."
An operation is like a method or function call in a traditional programming language.
Representation of concepts defined by
WSDL 1.1 and WSDL 2.0 documents.

Bahasa Indonesia
slenska
Italiano

Magyar
Bahasa Melayu
Nederlands

Norsk bokml
Polski
Portugus
Romn

Slovenina
Suomi
Svenska

Edit links
Web Services Description Language - Wikipedia, the free encyclopedia
http://en.wikipedia.org/wiki/Web_Services_Description_Language[4/11/2014 8:33:24 AM]
Message n/a
Typically, a message corresponds to an operation. The message contains the
information needed to perform the operation. Each message is made up of one or
more logical parts. Each part is associated with a message-typing attribute. The
message name attribute provides a unique name among all messages. The part
name attribute provides a unique name among all the parts of the enclosing
message. Parts are a description of the logical content of a message. In RPC binding,
a binding may reference the name of a part in order to specify binding-specific
information about the part. A part may represent a parameter in the message; the
bindings define the actual meaning of the part. Messages were removed in WSDL
2.0, in which XML schema types for defining bodies of inputs, outputs and faults are
referred to simply and directly.
Types Types
Describes the data. The XML Schema language (also known as XSD) is used (inline
or referenced) for this purpose.
<?xml ver si on=" 1. 0" encodi ng=" UTF- 8" ?>
<description xml ns=" ht t p: / / www. w3. or g/ ns/ wsdl "
xml ns: t ns=" ht t p: / / www. t msws. com/ wsdl 20sampl e"
xml ns: wht t p=" ht t p: / / schemas. xml soap. or g/ wsdl / ht t p/ "
xml ns: wsoap=" ht t p: / / schemas. xml soap. or g/ wsdl / soap/ "
t ar get Namespace=" ht t p: / / www. t msws. com/ wsdl 20sampl e" >

<!-- Abstract type -->
<types>
<xs:schema xml ns: xs=" ht t p: / / www. w3. or g/ 2001/ XMLSchema"
xml ns =" ht t p: / / www. t msws. com/ wsdl 20sampl e"
t ar get Namespace=" ht t p: / / www. exampl e. com/ wsdl 20sampl e" >

<xs:element name=" r equest " > . . . </xs:element>
<xs:element name=" r esponse" > . . . </xs:element>
</xs:schema>
</types>

<!-- Abstract interfaces -->
<interface name=" I nt er f ace1" >
<fault name=" Er r or 1" el ement =" t ns: r esponse" />
<operation name=" Opp1" pat t er n=" ht t p: / / www. w3. or g/ ns/ wsdl / i n- out " >
<input messageLabel =" I n" el ement =" t ns: r equest " />
<output messageLabel =" Out " el ement =" t ns: r esponse" />
</operation>
</interface>

<!-- Concrete Binding Over HTTP -->
<binding name=" Ht t pBi ndi ng" i nt er f ace=" t ns: I nt er f ace1"
t ype=" ht t p: / / www. w3. or g/ ns/ wsdl / ht t p" >
<operation r ef =" t ns: Get " wht t p: met hod=" GET" />
</binding>

<!-- Concrete Binding with SOAP-->
<binding name=" SoapBi ndi ng" i nt er f ace=" t ns: I nt er f ace1"
t ype=" ht t p: / / www. w3. or g/ ns/ wsdl / soap"
wsoap: pr ot ocol =" ht t p: / / www. w3. or g/ 2003/ 05/ soap/ bi ndi ngs/ HTTP/ "
wsoap: mepDef aul t =" ht t p: / / www. w3. or g/ 2003/ 05/ soap/ mep/ r equest - r esponse" >
<operation r ef =" t ns: Get " />
</binding>

<!-- Web Service offering endpoints for both bindings-->
<service name=" Ser vi ce1" i nt er f ace=" t ns: I nt er f ace1" >
Example WSDL file [edit]
Web Services Description Language - Wikipedia, the free encyclopedia
http://en.wikipedia.org/wiki/Web_Services_Description_Language[4/11/2014 8:33:24 AM]
<endpoint name=" Ht t pEndpoi nt "
bi ndi ng=" t ns: Ht t pBi ndi ng"
addr ess=" ht t p: / / www. exampl e. com/ r est / " />
<endpoint name=" SoapEndpoi nt "
bi ndi ng=" t ns: SoapBi ndi ng"
addr ess=" ht t p: / / www. exampl e. com/ soap/ " />
</service>
</description>
WSDL 1.0 (Sept. 2000) was developed by IBM, Microsoft, and Ariba to describe Web Services for their
SOAP toolkit. It was built by combining two service description languages: NASSL (Network Application
Service Specification Language) from IBM and SDL (Service Description Language) from Microsoft.
WSDL 1.1, published in March 2001, is the formalization of WSDL 1.0. No major changes were introduced
between 1.0 and 1.1.
WSDL 1.2 (J une 2003) was a working draft at W3C, but has become WSDL 2.0. According to W3C: WSDL
1.2 is easier and more flexible for developers than the previous version. WSDL 1.2 attempts to remove non-
interoperable features and also defines the HTTP 1.1 binding better. WSDL 1.2 was not supported by most
SOAP servers/vendors.
WSDL 2.0 became a W3C recommendation on J une 2007. WSDL 1.2 was renamed to WSDL 2.0 because it
has substantial differences from WSDL 1.1. The changes are the following:
Added further semantics to the description language
Removed message constructs
Operator overloading not supported
PortTypes renamed to interfaces
Ports renamed to endpoints
Web Application Description Language
SOAP
1. ^ "Web Services Description Language (WSDL) Version 2.0 Part 1: Core Language" . Retrieved 2007-06-27.
2. ^ "Web Services Description Language (WSDL) Version 2.0 Part 2: Adjuncts" .
3. ^ "WITW WSDL 2.0 HTTP Binding" .
WSDL 1.0 Specification
WSDL 1.1 Specification
History [edit]
See also [edit]
References [edit]
External links [edit]
Web Services Description Language - Wikipedia, the free encyclopedia
http://en.wikipedia.org/wiki/Web_Services_Description_Language[4/11/2014 8:33:24 AM]
[hide] V T E
WSDL 2.0 Specification Part 0: Primer (Latest Version)
WSDL 2.0 Specification Part 1: Core (Latest Version)
WSDL 2.0 Specification Part 2: Adjuncts (Latest Version)
Web Services Description Working Group
XML protocol activity
J SR-110: J ava APIs for WSDL
J SR 172: J ava ME Web Services Specification
Online WSDL Validator
Online WSDL browser and test client
W3Schools WSDL 1.1 tutorial
WSDL programmatic visualization with Linguine Maps
SSDL - The SOAP Service Description Language
WSDL J ava Bindings for XMLBeans and J AXB.
W3C Working Draft
World Wide Web Consortium
Products and
standards
Recommendations
Canonical XML CDF CSS DOM Geolocation API HTML ITS
MathML OWL P3P PLS RDF RDF Schema SISR SKOS SMIL
SOAP SRGS SSML SVG SPARQL Timed Text VoiceXML
Web Storage WSDL XForms XHTML XHTML+RDFa XInclude
XLink XML XML Base XML Encryption XML Events
XML Information Set XML namespace XML Schema XML Signature
XOP XPath 1.0, 2.0 XPointer XProc XQuery XSL XSL-FO
XSLT (elements)
Notes XAdES XHTML+SMIL XUP
Working drafts
CCXML CURIE HTML5 InkML J SON-LD RIF SCXML
SMIL Timesheets sXBL WICD XFDL XFrames XBL
XMLHttpRequest
Guidelines Web Content Accessibility Guidelines
Initiative
Multimodal Interaction Activity Markup Validation Service
Web Accessibility Initiative WebPlatform
Deprecated C-HTML HDML J SSS PGML VML XHTML+MathML+SVG
Organizations
World Wide Web Foundation SVG Working Group CSS Working Group
HTML Working Group WebOnt W3C Device Description Working Group WHATWG
Software Agora Argo Arena Amaya CERN httpd Libwww Line Mode Browser
Conference-related IW3C2 World Wide Web Conference WWW1
Categories: XML-based standards Web service specifications Web services
World Wide Web Consortium standards
This page was last modified on 9 April 2014 at 11:57.
Web Services Description Language - Wikipedia, the free encyclopedia
http://en.wikipedia.org/wiki/Web_Services_Description_Language[4/11/2014 8:33:24 AM]
Privacy policy About Wikipedia Disclaimers Contact Wikipedia Developers Mobile view
Text is available under the Creative Commons Attribution-ShareAlike License; additional terms may apply. By using this
site, you agree to the Terms of Use and Privacy Policy. Wikipedia is a registered trademark of the Wikimedia
Foundation, Inc., a non-profit organization.