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="(C) Copyright 2005" />
 <meta name="DC.rights.owner" content="(C) Copyright 2005" />
 <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 scheme="URI" name="DC.Relation" content="../tasks/tedtwsdl.html" />
 <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/commonltr.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 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 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 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="(C) Copyright 2005" />
	<meta name="DC.rights.owner" content="(C) Copyright 2005" />
	<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 scheme="URI" name="DC.Relation" content="../tasks/tedtwsdl.html" />
	<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/commonltr.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 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 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 into the workbench and edit them in the WSDL editor.">Editing WSDL files</a></div></div>
	</div>

	</body>
	</html>