blob: dbd031e483ba3eeb1bc547ee0d66d1e8a3ce15ad [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="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>