blob: c53655ffb96852007f41c35f425fc3b6f3d87cb5 [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>
<head>
<!-- /*******************************************************************************
* Copyright (c) 2000, 2005 IBM Corporation and others.
* All rights reserved. This program and the accompanying materials
* are made available under the terms of the Eclipse Public License v1.0
* which accompanies this distribution, and is available at
* http://www.eclipse.org/legal/epl-v10.html
*
* Contributors:
* IBM Corporation - initial API and implementation
*******************************************************************************/ -->
<link rel="stylesheet" type="text/css" href="../../org.eclipse.wst.doc.user/common.css" />
<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>
<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 outside Rational Developer products into the workbench and edit them in the WSDL editor.">Editing WSDL files</a></div>
</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="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="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 outside Rational Developer products into the workbench and edit them in the WSDL editor.">Editing WSDL files</a></div></div>
</div></div>
</body>
</html>