| <?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, 2006 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, 2006" /> |
| <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="Adding a port to a service" /> |
| <meta name="abstract" content="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." /> |
| <meta name="description" content="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." /> |
| <meta content="WSDL, adding ports, Web services, adding WSDL ports" name="DC.subject" /> |
| <meta content="WSDL, adding ports, Web services, adding WSDL ports" name="keywords" /> |
| <meta scheme="URI" name="DC.Relation" content="../concepts/cwsdled.html" /> |
| <meta scheme="URI" name="DC.Relation" content="tcrtwsdl.html" /> |
| <meta scheme="URI" name="DC.Relation" content="tedtwsdl.html" /> |
| <meta content="XHTML" name="DC.Format" /> |
| <meta content="taddport" 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>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 Design view, right-click the service you want to add a port |
| to, then click <strong>Add Port.</strong> To select the new port, click the port in |
| the service object.</span></li> |
| |
| <li class="stepexpand"><span>In the Properties view, click the <strong>General</strong> pane. In the <strong>Name</strong> field, |
| type the name of the port.</span> 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 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>In the <strong>Address</strong> field, type the address of the port.</span> |
| </li> |
| |
| <li class="stepexpand"><span>Type any information about the port you want the user to read in |
| the <strong>Documentation</strong> pane.</span></li> |
| |
| <li class="stepexpand"><span>To manage extensions, click the <strong>Extensibility</strong> pane. You |
| can either add, sort, or remove extensions. </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 |
| Port</strong>. Your port (regardless of which view you create it in) will appear |
| in both the Design view and the Outline view.</p> |
| </div> |
| |
| </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> |
| |
| </body> |
| </html> |