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>
 <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 &gt; 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 &gt; 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>
	<?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>