| <?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 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" /> |
| <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="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="Web services, bindings, creating, setting WSDL bindings, WSDL" name="DC.subject" /> |
| <meta content="Web services, bindings, creating, setting WSDL bindings, WSDL" name="keywords" /> |
| <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/common.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 binding by right clicking in any blank space |
| in the Design view and selecting <span class="uicontrol">Add Binding</span>. 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, complete the following |
| steps:</p> |
| </div> |
| |
| <ol> |
| <li class="stepexpand"><span>In the Design view, right-click your port and click <strong>Set Binding |
| > New Binding</strong>.</span></li> |
| |
| <li class="stepexpand"><span>In the <strong>Name</strong> field, type the name of the binding.</span> The |
| name should be unique among all bindings defined within the enclosing WSDL |
| document. Click <strong>OK.</strong> To select the new binding, click the binding object. |
| </li> |
| |
| <li class="stepexpand"><span>Type any information about the binding you want the user to read |
| in the <strong>Documentation</strong> pane.</span></li> |
| |
| </ol> |
| |
| <div class="section"><div class="note"><span class="notetitle">Note:</span> A <strong>PortType</strong> is a named set of abstract operations and |
| the abstract messages involved. You can either create a new port type for |
| your binding, reuse an existing one, or import one. For more information, |
| see <a href="../tasks/tsetprtt.dita">Setting a Port Type</a>.</div> |
| <div class="tip"><span class="tiptitle">Tip:</span> You can also create a new binding |
| for your port using the Outline view. Right click on the <span class="uicontrol">Bindings</span> folder |
| and select <span class="uicontrol">Add Binding</span>.</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, complete the following steps:</p> |
| </div> |
| |
| <ol> |
| <li><span>In the Design view, select your port.</span></li> |
| |
| <li><span>In the Properties view, click the <strong>General</strong> pane.</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, complete the following steps:</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 the required binding information. If you are modifying |
| an existing binding, select the <span class="uicontrol">Overwrite existing binding information</span> check |
| box.</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, complete the following |
| steps:</div> |
| |
| <ol> |
| <li><span>In the Design view, right-click your port and click <strong>Set Binding |
| > Existing Binding.</strong></span></li> |
| |
| <li><strong>Optional: </strong><span>In the <strong>Name</strong> field, type a search string |
| to filter the list or leave the field blank to view all.</span></li> |
| |
| <li><span>You can import a binding by selecting one of the following options:</span> |
| <ul> |
| <li><strong>Workspace</strong>: lists the bindings available in your workspace.</li> |
| |
| <li><strong>Enclosing Project</strong>: lists the bindings available in the project |
| that contains your file.</li> |
| |
| <li><strong>Current Resource</strong>: lists the binding types available in your |
| current file.</li> |
| |
| <li><strong>Working Sets</strong>: lists the bindings available in a specified set |
| of files. To specify a working set, click <strong>Choose</strong>. You can select files |
| from an existing working set or create a new working set. Once you have selected |
| the files, click <strong>OK</strong>.</li> |
| |
| </ul> |
| |
| </li> |
| |
| <li><span>The bindings will be listed. Select one and click <strong>OK</strong>. In |
| the Design view, click the binding object.</span></li> |
| |
| <li><span>In the Properties view, type any information about the binding |
| you wish the user to read in the <strong>Documentation</strong> pane.</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 into the workbench and edit them in the WSDL editor.">Editing WSDL files</a></div></div> |
| </div> |
| </div> |
| |
| |
| </body> |
| </html> |