| <?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 http-equiv="Content-Type" content="text/html; charset=utf-8" /> |
| <!-- /******************************************************************************* |
| * 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>Discovering and importing Web services</title> |
| </head> |
| <body id="tdiscov"><a name="tdiscov"><!-- --></a> |
| |
| <h1 class="topictitle1">Discovering Web Services</h1> |
| <div><p>Web services can be located through a public business registry |
| such as the IBM<sup>®</sup> UDDI |
| Business Registry, a private business registry, or a WSIL document. UDDI manages |
| the discovery of Web services by relying on a distributed registry of businesses |
| and their service descriptions implemented in a common XML format.</p> |
| <div class="p"><div class="p">Prerequisites:<ol><li><a href="treg.html">Register with a registry</a></li> |
| <li><a href="tstrtexp.html">Launch the IBM Web Services Explorer</a></li> |
| <li><a href="taddreg.html">Add the registry to the IBM Web Services Explorer</a></li> |
| </ol> |
| </div> |
| </div> |
| <div class="section"><p>Web Services Inspection Language (WSIL) is a service discovery |
| mechanism that is an alternative to UDDI as well as complementary to UDDI. |
| WSIL allows you to go directly to the service provider and ask for the services |
| it provides. For more information on the Web Services Inspection Language |
| specification, refer to <a href="http://www-106.ibm.com/developerworks/webservices/library/ws-wsilspec.html" target="_blank"> www.ibm.com/developerworks/webservices/library/ws-wsilspec.html</a>. |
| For more information on UDDI and the IBM UDDI Business registries, refer to <a href="http://www.ibm.com/services/uddi/index.html" target="_blank">www.ibm.com/services/uddi/index.html</a>.</p> |
| <p>You |
| can discover a Web service in two ways using the Web Services Explorer:</p> |
| </div> |
| <div class="section"><ul><li> <a href="#tdiscov__discover_from_uddi">Discovering a Web service from |
| a UDDI registry</a> </li> |
| <li> <a href="#tdiscov__discover_from_wsil">Discovering a Web service from |
| a WSIL document</a> </li> |
| </ul> |
| </div> |
| </div> |
| <div></div><div class="nested1" xml:lang="en-us" id="discover_from_uddi"><a name="discover_from_uddi"><!-- --></a><h2 class="topictitle2"> Discovering a Web Service from a UDDI Registry</h2> |
| <div><div class="section"><p>The registry contains URL references to Web service WSDL documents. |
| In order to discover a Web service the URL to the Web service WSDL document |
| must be resolvable. To locate Web service descriptions:</p> |
| </div> |
| <ol><li><span>Launch the Web Services Explorer</span></li> |
| <li><span>Click <span class="uicontrol">UDDI Main</span>.</span></li> |
| <li><span>In the Actions pane select a registry from the drop-down list and |
| click <span class="uicontrol">Go</span>.</span></li> |
| <li><span>In the Actions pane toolbar click the <strong>Find</strong> icon <img src="../images/find.gif" alt="A picture of the Find icon." />.</span></li> |
| <li><span>In the Actions pane, enter the name of the query, what you are |
| searching for, the type of search that you want to perform, and any query |
| information: </span><ol type="a"><li class="substepexpand"><span> <strong>Search for</strong> This list allows you to search for |
| businesses, services, or service interfaces. </span> <ul><li> <strong>Businesses</strong> Once you locate a business in the registry, use the |
| icons in the Action pane toolbar to do the following:<ul><li>View and edit business details</li> |
| <li>Get the services associated with that business</li> |
| <li>Publish a service</li> |
| <li>Manage referenced services</li> |
| <li>Manage publisher assertions</li> |
| <li>Add the business to Favorites</li> |
| <li>Unpublish the business</li> |
| </ul> |
| </li> |
| <li> <strong>Services</strong> Once you locate a service in the registry, use the icons |
| in the Action pane toolbar to do the following: <ul><li>View and edit service details</li> |
| <li>Get the business associated with that service</li> |
| <li>Get the service interfaces associated with that service</li> |
| <li>Import the service WSDL file to the Eclipse workbench</li> |
| <li>Import the service WSDL file to the file system</li> |
| <li>Launch the Web Service wizards</li> |
| <li>Add the service to Favorites</li> |
| <li>Unpublish the service</li> |
| </ul> |
| </li> |
| <li> <strong>Service interfaces</strong> Once you locate a service interface in the |
| registry, use the icons in the Action pane toolbar to do the following: <ul><li>View and edit interface details</li> |
| <li>Get the services associated with that service interface</li> |
| <li>Get the businesses associated with that service interface</li> |
| <li>Import the service interface WSDL file to the Eclipse workbench</li> |
| <li>Import the service interface WSDL file to the file system</li> |
| <li>Launch the Web Service wizards</li> |
| <li>Add the service interface to Favorites</li> |
| <li>Unpublish the service interface</li> |
| </ul> |
| </li> |
| </ul> |
| </li> |
| <li class="substepexpand"><span> <strong>Type of search</strong> These radio buttons allow you to |
| specify a simple or advanced search, or a search by a Universal Unique Identifier |
| (UUID). </span> <dl><dt class="dlterm">Simple</dt> |
| <dd>Type the name of the businesses, services, or service interfaces for which |
| you are searching. <strong>Note:</strong> The search set size is set to 100 and the |
| maximum number of returned results is set to 10 by default. If you would |
| like to override the defaults, use the Advanced search.</dd> |
| <dt class="dlterm">Advanced </dt> |
| <dd>Allows you to enter more search options to focus the scope of your search. |
| Select this option if you would like to search for multiple businesses or |
| services.</dd> |
| <dt class="dlterm">UUID </dt> |
| <dd>Allow you to enter the UUID key. The UUID key is the identifier |
| that is associated with the published object.</dd> |
| </dl> |
| </li> |
| </ol> |
| </li> |
| <li><span>Once you have searched and discovered the business service description |
| you desired, select the service or the service interface and click the <strong>Import</strong> icon |
| to: </span><ul><li>import the WSDL document into your Web project</li> |
| <li>import the WSDL document into the WSDL Explorer for testing</li> |
| <li>launch the Web Service Skeleton Creation wizard or Web Service Client |
| wizard directly from the Web Services Explorer.</li> |
| </ul> |
| </li> |
| </ol> |
| </div> |
| </div> |
| <div class="nested1" xml:lang="en-us" id="discover_from_wsil"><a name="discover_from_wsil"><!-- --></a><h2 class="topictitle2"> Discovering a Web Service from a WSIL Document</h2> |
| <div><div class="section"><p>To locate Web service descriptions:</p> |
| </div> |
| <ol><li class="stepexpand"><span>From the Web Services Explorer toolbar, click the <strong>WSIL Page</strong> icon |
| <img src="../images/wsilview.gif" alt="Picture of the WSIL Page icon." />.</span></li> |
| <li class="stepexpand"><span>In the Navigator pane, click <strong>WSIL Main</strong>.</span></li> |
| <li class="stepexpand"><span>In the <strong>URL to document</strong> field of the Actions pane enter |
| the URL to the WSIL document or HTTP document that contains links to a WSIL |
| document. Details on how an HTTP file can contain links to WSIL can be found |
| here: http://www.ibm.com/developerworks/webservices/library/ws-wsilspec.html</span></li> |
| <li class="stepexpand"><span>Once you have located the WSIL document, use the icons in the Action |
| pane toolbar to do the following:</span><ul><li>View WSIL document details</li> |
| <li>List all of the WSDL services associated with that WSIL document</li> |
| <li>List all of the UDDI services associated with that WSIL document</li> |
| <li>List all of the UDDI businesses associated with that WSIL document</li> |
| <li>List all of the WSIL links associated with that WSIL document</li> |
| <li>Import the WSIL document to the file system</li> |
| <li>Add the WSIL document to Favorites</li> |
| </ul> |
| <strong>Important:</strong> If the IBM Web Services Explorer does not display |
| the project that you would like to import your WSDL file to, ensure that you |
| have created the project and/or click the <strong>Refresh</strong> icon.</li> |
| </ol> |
| </div> |
| <div> |
| <div class="linklist"><strong>Related Concepts</strong><br /> |
| |
| <div><a href="../../org.eclipse.jst.ws.doc.user/concepts/cwsinwsa.html"> Tools for Web services development</a></div> |
| <div><a href="../../org.eclipse.jst.ws.doc.user/concepts/cws.html">Web services development</a></div> |
| <div><a href="../concepts/cuddi.html" title="Universal Description, Discovery, and Integration (UDDI) specification defines a way to publish and discover information about Web services.">Universal Description, Discovery, and Integration (UDDI)</a></div></div> |
| |
| <div class="linklist"><strong>Related Tasks</strong><br /> |
| |
| <div><a href="tuddiexp.html" title="Through UDDI and WSIL, other applications can discover WSDL documents and bind with them to execute transactions or perform other business processes.">Publishing Web services and business entities</a></div> |
| <div><a href="tstrtexp.html" title="The Web services tools allows you to launch the Web Services Explorer in several ways.">Launching the Web Services Explorer</a></div> |
| <div><a href="treg.html" title="In order to publish your business entity and Web service to a UDDI registry, you must first register with the registry that you want to use.">Registering with a UDDI registry</a></div> |
| <div><a href="../../org.eclipse.jst.ws.doc.user/tasks/toverws.html"> Developing Web services</a></div></div> |
| |
| <div class="linklist"><strong>Related Reference</strong><br /> |
| |
| <div><a href="../ref/ruddi.html" title="Once you have registered and logged in to the UDDI registry that you want to use, you can register your Web service. Registration of a service involves four core data structure types: business information, service information, binding information, and information describing the specifications for services. The relationship between these data types is described in Figure 1.">Data structure types (UDDI registry)</a></div></div> |
| </div></div> |
| </body> |
| </html> |