| <?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>Adding a port to a service</title> |
| </head> |
| <body id="taddport"><a name="taddport"><!-- --></a> |
| |
| <h1 class="topictitle1">Adding a port to a service</h1> |
| <div><p>A port defines an individual endpoint by specifying a single address |
| for a binding. The port contains a 'binding' attribute that references a binding |
| and an address element that provides a specification for the endpoint.</p> |
| <div class="section"><p>Services are used to group sets of related ports together. Ports |
| within a service have the following relationship:</p> |
| <ul><li>None of the ports communicate with each other (for example, the output |
| of one port is not the input of another).</li> |
| <li>If a service has several ports that share a port type, but employ different |
| bindings or addresses, the ports are alternatives. Each port provides semantically |
| equivalent behavior (within the transport and message format limitations imposed |
| by each binding). </li> |
| <li>You can determine a service's port types by examining its ports. Using |
| this information a user can determine if a given machine supports all the |
| operations needed to complete a given task.</li> |
| </ul> |
| <p>To add a port to a service, follow these steps:</p> |
| </div> |
| <ol><li class="stepexpand"><span>In the Graph view, right-click the service you want to add a port |
| to, then click <strong>Add Child > Port.</strong></span></li> |
| <li class="stepexpand"><span>Type the name of the port in the dialog.</span> Click <strong>Finish</strong>. |
| The name of the port should provide it with a unique name amongst all the |
| ports defined within the service.</li> |
| <li class="stepexpand"><span>A <strong>Binding</strong> defines the message format and protocol details |
| for operations and messages defined by a particular port type.</span> You |
| can either create a new binding for your port, re-use an existing one, or |
| import one. Refer to the related tasks for more details.</li> |
| <li class="stepexpand"><span>Type any information about the port 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 port using the Outline view |
| by right-clicking your service under the <strong>Services</strong> folder and clicking |
| <strong>Add Child > Port</strong>. Your port (regardless of which view you create it |
| in) will appear in both the Graph view and 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 outside Rational Developer products 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 outside Rational Developer products into the workbench and edit them in the WSDL editor.">Editing WSDL files</a></div></div> |
| </div> |
| </body> |
| </html> |