docs/org.eclipse.wst.wsdl.ui.doc.user/tasks/taddport.html - webservices/webtools.webservices - Git at Google

 <?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="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="Web services, adding WSDL ports, WSDL files, ports" name="DC.subject" />
 <meta content="Web services, adding WSDL ports, WSDL files, 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, complete the following 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> </span></li>

 <li class="stepexpand"><span>Fill in the <strong>Name</strong> for 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>Select a <strong>Binding</strong> and <span class="uicontrol">Protocol</span> for
 the port, and enter the address of the port into the <span class="uicontrol">Address</span> field.
 Click <span class="uicontrol">Finish</span>.</span> To select the new port, click
 the port in the service object. You can change the information you entered
 about this port any time in the <span class="uicontrol">General</span> pane.
 </li>

 <li class="stepexpand"><span>Type any information about the port you want the user to read in
 the <strong>Documentation</strong> pane of the Properties view.</span></li>

 <li class="stepexpand"><span>To manage extensions, click the <strong>Extensions</strong> pane. You can
 either add, sort, or remove extensions. </span></li>

 </ol>

 <div class="section"><p>You can create a new binding for your port, re-use an existing
 one, or import one. A <strong>Binding</strong> defines the message format and protocol
 details for operations and messages defined by a particular port type. For
 more information, see <a href="tsetbind.dita">Setting a binding</a> .</p>
 <p>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>
	<?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="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="Web services, adding WSDL ports, WSDL files, ports" name="DC.subject" />
	<meta content="Web services, adding WSDL ports, WSDL files, 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, complete the following 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> </span></li>

	<li class="stepexpand"><span>Fill in the <strong>Name</strong> for 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>Select a <strong>Binding</strong> and <span class="uicontrol">Protocol</span> for
	the port, and enter the address of the port into the <span class="uicontrol">Address</span> field.
	Click <span class="uicontrol">Finish</span>.</span> To select the new port, click
	the port in the service object. You can change the information you entered
	about this port any time in the <span class="uicontrol">General</span> pane.
	</li>

	<li class="stepexpand"><span>Type any information about the port you want the user to read in
	the <strong>Documentation</strong> pane of the Properties view.</span></li>

	<li class="stepexpand"><span>To manage extensions, click the <strong>Extensions</strong> pane. You can
	either add, sort, or remove extensions. </span></li>

	</ol>

	<div class="section"><p>You can create a new binding for your port, re-use an existing
	one, or import one. A <strong>Binding</strong> defines the message format and protocol
	details for operations and messages defined by a particular port type. For
	more information, see <a href="tsetbind.dita">Setting a binding</a> .</p>
	<p>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>