blob: 8df3388c7189a75bede64c5c7d3105cdf2a3e6a2 [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="(C) Copyright 2005" />
<meta name="DC.rights.owner" content="(C) Copyright 2005" />
<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="task" name="DC.Type" />
<meta name="DC.Title" content="Setting a binding" />
<meta name="abstract" content="A binding is a top level WSDL object that provides a concrete specification regarding the transmission of messages to and from a web service. A binding references exactly one port type. The structure of a binding corresponds very closely to that of the port type. The binding contains extensibility elements (for example, soap, http, and mime) that specify protocol specific details. Each port within a service references exactly one binding." />
<meta name="description" content="A binding is a top level WSDL object that provides a concrete specification regarding the transmission of messages to and from a web service. A binding references exactly one port type. The structure of a binding corresponds very closely to that of the port type. The binding contains extensibility elements (for example, soap, http, and mime) that specify protocol specific details. Each port within a service references exactly one binding." />
<meta content="XHTML" name="DC.Format" />
<meta content="tsetbind" name="DC.Identifier" />
<meta content="en-us" name="DC.Language" />
<link href="../../org.eclipse.wst.doc.user/commonltr.css" type="text/css" rel="stylesheet" />
<title>Setting a binding</title>
</head>
<body id="tsetbind"><a name="tsetbind"><!-- --></a>
<h1 class="topictitle1">Setting a binding</h1>
<div><p>A binding is a top level WSDL object that provides a concrete specification
regarding the transmission of messages to and from a web service. A binding
references exactly one port type. The structure of a binding corresponds very
closely to that of the port type. The binding contains extensibility elements
(for example, soap, http, and mime) that specify protocol specific details.
Each port within a service references exactly one binding.</p>
<div class="section"><p>You can create a new binding, reuse an existing one, or import
one.</p>
</div>
</div>
<div class="nested1" id="createnewbind"><a name="createnewbind"><!-- --></a>
<h2 class="topictitle2">Creating a new binding</h2>
<div>
<div class="section"><p>To create a new binding for your port, follow these steps:</p>
</div>
<ol>
<li class="stepexpand"><span>In the Graph view, right-click your port and click <strong>Set Binding</strong>.</span>
</li>
<li class="stepexpand"><span>Select the <strong>Create a new binding</strong> radio button.</span></li>
<li class="stepexpand"><span>Type the name of the binding in <span class="uicontrol">Name</span> field.</span>
The name should be unique among all bindings defined within the enclosing
WSDL document. Click <strong>Finish.</strong></li>
<li class="stepexpand"><span>In order to see the binding you need to ensure the hide/show binding
button <img src="../images/show-hide-binding.gif" alt="hide/show binding button" /> is toggled so that bindings are showing.</span></li>
<li class="stepexpand"><span>A <strong>Port Type</strong> is a named set of abstract operations and the
abstract messages involved.</span> You can either create a new port type
for your binding, reuse an existing one, or import one. Refer to the related
tasks for more details.</li>
<li class="stepexpand"><span>Type any information about the binding you want the user to read
in the <strong>Documentation</strong> field.</span></li>
</ol>
<div class="section"><p> <strong>Tip</strong>: You can also create a new binding for your port using
the Outline view.</p>
</div>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="../tasks/tedtwsdl.html" title="Once you have created a WSDL file, you can edit it in the WSDL editor. You can also import WSDL files you have created into the workbench and edit them in the WSDL editor.">Editing WSDL files</a></div>
</div>
</div>
</div>
<div class="nested1" id="reusebinding"><a name="reusebinding"><!-- --></a>
<h2 class="topictitle2">Reusing a binding for a port</h2>
<div>
<div class="section"><p>To reuse a binding for your port, follow these steps:</p>
</div>
<ol>
<li><span>In the Graph view, select your port.</span></li>
<li><span>From the <strong>Binding</strong> drop down list, select the binding you
want to use.</span></li>
</ol>
</div>
</div>
<div class="nested1" id="regeneratingabinding"><a name="regeneratingabinding"><!-- --></a>
<h2 class="topictitle2">Regenerating a binding</h2>
<div>
<div class="section">To regenerate a binding:</div>
<ol>
<li><span>Right-click the binding you want to regenerate.</span></li>
<li><span>Select <span class="uicontrol">Generate Binding Content</span>.</span></li>
<li><span>Specify an required binding information. If you are modifying an
existing binding, ensure that you select <span class="uicontrol">Overwrite existing binding
information</span>.</span></li>
</ol>
</div>
</div>
<div class="nested1" id="impbinding"><a name="impbinding"><!-- --></a>
<h2 class="topictitle2">Import an existing binding</h2>
<div>
<div class="section">To import an existing binding for your port, follow these steps:</div>
<ol>
<li><span>In the Graph view, right-click your port and click <strong>Set Binding.</strong></span>
</li>
<li><span>Click the <strong>Import binding from a file</strong> check box. Click <strong>Browse</strong>.</span>
</li>
<li><span>Select the file that contains the binding you want to use. Click
<strong>OK</strong>.</span></li>
</ol>
</div>
<div>
<div class="familylinks">
<div class="parentlink"><strong>Parent topic:</strong> <a href="../tasks/tedtwsdl.html" title="Once you have created a WSDL file, you can edit it in the WSDL editor. You can also import WSDL files you have created into the workbench and edit them in the WSDL editor.">Editing WSDL files</a></div>
</div>
<div class="linklist"><strong>Related concepts</strong><br />
<div><a href="../concepts/cwsdled.html" title="The WSDL editor allows you to easily and graphically create, modify, view, and validate WSDL files.">Editing WSDL files with the WSDL Editor</a></div></div>
<div class="linklist"><strong>Related tasks</strong><br />
<div><a href="tcrtwsdl.html" title="You can create a new, empty WSDL file, then edit it using the WSDL editor.">Creating a new WSDL file</a></div>
<div><a href="tedtwsdl.html" title="Once you have created a WSDL file, you can edit it in the WSDL editor. You can also import WSDL files you have created into the workbench and edit them in the WSDL editor.">Editing WSDL files</a></div></div>
</div>
</div>
</body>
</html>