blob: 0af7ff48e88728ab8b607d44b1848c7c941a4e7b [file] [log] [blame]
<?xml version="1.0" encoding="UTF-8"?><!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html lang="en-us" xml:lang="en-us">
<head>
<meta content="text/html; charset=utf-8" http-equiv="Content-Type" />
<meta name="copyright" content="Copyright (c) 2000, 2008 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-2.0/. Contributors: IBM Corporation - initial API and implementation" />
<meta name="DC.rights.owner" content="(C) Copyright 2000, 2008" />
<meta content="public" name="security" />
<meta content="index,follow" name="Robots" />
<meta http-equiv="PICS-Label" content='(PICS-1.1 "http://www.icra.org/ratingsv02.html" l gen true r (cz 1 lz 1 nz 1 oz 1 vz 1) "http://www.rsac.org/ratingsv01.html" l gen true r (n 0 s 0 v 0 l 0) "http://www.classify.org/safesurf/" l gen true r (SS~~000 1))' />
<meta content="reference" name="DC.Type" />
<meta name="DC.Title" content="Web Services Description Language (WSDL) reference" />
<meta name="abstract" content="A WSDL document defines services as collections of network endpoints, or ports. In WSDL, the abstract definition of endpoints and messages is separated from their concrete network deployment or data format bindings. This allows the reuse of abstract definitions: messages, which are abstract descriptions of the data being exchanged, and port types which are abstract collections of operations." />
<meta name="description" content="A WSDL document defines services as collections of network endpoints, or ports. In WSDL, the abstract definition of endpoints and messages is separated from their concrete network deployment or data format bindings. This allows the reuse of abstract definitions: messages, which are abstract descriptions of the data being exchanged, and port types which are abstract collections of operations." />
<meta content="WSDL files, reference, Web services, WSDL reference" name="DC.subject" />
<meta content="WSDL files, reference, Web services, WSDL reference" name="keywords" />
<meta scheme="URI" name="DC.Relation" content="../concepts/cwsdl.html" />
<meta scheme="URI" name="DC.Relation" content="../concepts/cws.html" />
<meta scheme="URI" name="DC.Relation" content="../concepts/cwsdl.html" />
<meta scheme="URI" name="DC.Relation" content="../tasks/toverws.html" />
<meta scheme="URI" name="DC.Relation" content="../../org.eclipse.jst.ws.consumption.ui.doc.user/tasks/tuddiexp.html" />
<meta content="XHTML" name="DC.Format" />
<meta content="rwsdl" name="DC.Identifier" />
<meta content="en-us" name="DC.Language" />
<link href="../../org.eclipse.wst.doc.user/common.css" type="text/css" rel="stylesheet" />
<title>Web Services Description Language (WSDL) reference</title>
</head>
<body id="rwsdl"><a name="rwsdl"><!-- --></a>
<h1 class="topictitle1">Web Services Description Language (WSDL) reference</h1>
<div><p>A WSDL document defines services as collections of network endpoints,
or ports. In WSDL, the abstract definition of endpoints and messages is separated
from their concrete network deployment or data format bindings. This allows
the reuse of abstract definitions: messages, which are abstract descriptions
of the data being exchanged, and port types which are abstract collections
of operations. </p>
<div class="section"><p>The concrete protocol and data format specifications for a particular
port type constitutes a reusable binding. A port is defined by associating
a network address with a reusable binding, and a collection of ports define
a service. Hence, a WSDL document uses the following elements in the definition
of network services:</p>
<ul>
<li> <span class="uicontrol">Types</span>: a container for data type definitions using
some type system (such as XSD).</li>
<li> <span class="uicontrol">Message</span>: an abstract, typed definition of the
data being communicated.</li>
<li> <span class="uicontrol">Operation</span>: an abstract description of an action
supported by the service.</li>
<li> <span class="uicontrol">Port Type</span>: an abstract set of operations supported
by one or more endpoints.</li>
<li> <span class="uicontrol">Binding</span>: a concrete protocol and data format specification
for a particular port type. The binding is usually SOAP and the encoding and
data formatting regulations used (also known as the style) is usually literal
(this includes document/literal, and sometimes rpc/literal).</li>
<li> <span class="uicontrol">Port</span>: a single endpoint defined as a combination
of a binding and a network address.</li>
<li> <span class="uicontrol">Service</span>: a collection of related endpoints.</li>
</ul>
<p>For more information on WSDL, refer to </p>
<p><a href="http://www.w3.org/TR/wsdl" target="_blank">www.w3.org/TR/wsdl</a></p>
<p>The
various WSDL elements can be structured in many ways. It can be in one single
WSDL file or in multiple WSDL files.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="../concepts/cwsdl.html" title="Web Services Description Language (WSDL) is a standard specification for describing networked, XML-based services. It provides a simple way for service providers to describe the basic format of requests to their systems regardless of the underlying run-time implementation.">Web Services Description Language (WSDL)</a></div>
</div>
<div class="linklist"><strong>Related Concepts</strong><br />
<div><a href="../concepts/cws.html" title="A Web service is a set of related application functions that can be programmatically invoked over the Internet. Businesses can dynamically mix and match Web services to perform complex transactions with minimal programming. Web services allow buyers and sellers all over the world to discover each other, connect dynamically, and execute transactions in real time with minimal human interaction.">Web services overview</a></div>
<div><a href="../concepts/cwsdl.html" title="Web Services Description Language (WSDL) is a standard specification for describing networked, XML-based services. It provides a simple way for service providers to describe the basic format of requests to their systems regardless of the underlying run-time implementation.">Web Services Description Language (WSDL)</a></div></div>
<div class="linklist"><strong>Related Tasks</strong><br />
<div><a href="../tasks/toverws.html"> Developing Web
services</a></div>
<div><a href="../../org.eclipse.jst.ws.consumption.ui.doc.user/tasks/tuddiexp.html"> Using the Web Services Explorer</a></div></div>
</div>
</body>
</html>