| <?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" /> |
| </head> |
| <body id="twsdlexp"><a name="twsdlexp"><!-- --></a> |
| |
| <h1 class="topictitle1">Exploring WSDL using the WSDL Explorer</h1> |
| <div><div class="p">Prerequisites: To use the WSDL Explorer, you must have a valid URL |
| for a WSDL document.</div> |
| <div class="section">The WSDL Explorer allows you to explore, and test WSDL documents. |
| The following actions are available in the WSDL Explorer:<ul><li>Import WSDL to the Workbench: <img src="../images/mptwsdlicon.gif" alt="Import WSDL to the Workbench icon" /></li> |
| <li>Import WSDL to your file system: <img src="../images/fswsdlicon.gif" alt="Import WSDL to your file system icon" /></li> |
| <li>Launch the Web Service Wizard: <img src="../images/wswizicon.gif" alt="Launch the Web Service Wizard icon" /></li> |
| <li>Add WSDL to Favorites: <img src="../images/wsdlfavicon.gif" alt="Add WSDL to Favorites icon" /></li> |
| <li>Show WSDL details: <img src="../images/wsdldtlicon.gif" alt="WSDL Details icon" /></li> |
| </ul> |
| </div> |
| </div> |
| <div></div><div class="nested1" xml:lang="en-us" id="d0e47"><a name="d0e47"><!-- --></a><h2 class="topictitle2">Launching the WSDL Explorer</h2> |
| <div><div class="section"><p>To launch the WSDL Explorer, complete the following steps:</p> |
| </div> |
| <ol><li><span> <a href="tstrtexp.html">Launch the Web Services Explorer</a>.</span></li> |
| <li><span>Switch to the WSDL Explorer by clicking the icon in the upper right-hand |
| corner <img src="../images/wsdlicon.gif" alt="Icon to launch the WSDL Explorer" />.</span></li> |
| </ol> |
| </div> |
| </div> |
| <div class="nested1" xml:lang="en-us" id="d0e64"><a name="d0e64"><!-- --></a><h2 class="topictitle2">Importing a WSDL file to your workspace</h2> |
| <div><div class="section"><p>To import the WSDL file to the Workbench:</p> |
| </div> |
| <ol><li><span>Click this icon: <img src="../images/mptwsdlicon.gif" alt="Import WSDL to the Workbench icon" />.</span></li> |
| <li><span>Select the project into which you want to import the WSDL.</span></li> |
| <li><span>If you want to generate a WSIL file from the WSDL, select <strong>Import |
| as a service reference to a WSIL document</strong>.</span></li> |
| <li><span>Click <strong>Go</strong>.</span></li> |
| </ol> |
| </div> |
| </div> |
| <div class="nested1" xml:lang="en-us" id="d0e90"><a name="d0e90"><!-- --></a><h2 class="topictitle2">Importing a WSDL file to your file system</h2> |
| <div><div class="section"><p>To import the WSDL file to your file system, click this icon: |
| <img src="../images/fswsdlicon.gif" alt="Import WSDL to your file system icon" />. Specify where you want the WSDL file saved on your system.</p> |
| </div> |
| </div> |
| </div> |
| <div class="nested1" xml:lang="en-us" id="d0e96"><a name="d0e96"><!-- --></a><h2 class="topictitle2">Launching the Web services wizard</h2> |
| <div><div class="section"><p>To launch the Web Service Wizard, click this icon: <img src="../images/wswizicon.gif" alt="Launch the Web Service Wizard icon" />. You can select if you want to create |
| a Web service client or a Skeleton Web service from the WSDL file. Click <strong>Go</strong> to |
| launch the wizard.</p> |
| </div> |
| </div> |
| </div> |
| <div class="nested1" xml:lang="en-us" id="d0e105"><a name="d0e105"><!-- --></a><h2 class="topictitle2">Adding a WSDL file to your favorites</h2> |
| <div><div class="section"><p>To add the WSDL file to Favorites, click this icon: </p> |
| <p>. |
| The Status pane displays that the WSDL was successfully added to your list |
| of favorites. </p> |
| </div> |
| </div> |
| </div> |
| <div class="nested1" xml:lang="en-us" id="d0e110"><a name="d0e110"><!-- --></a><h2 class="topictitle2">Exploring WSDL documents using the WSDL Explorer:</h2> |
| <div><ol><li class="stepexpand"><span>Select WSDL Main in the Navigator pane, enter or browse to an existing |
| WSDL URL in the right-hand pane, and click <strong>Go</strong>. Note that the Explorer |
| will only allow you to browse for WSDL files that reside in the <samp class="codeph">WebContent/WSDL</samp> folder |
| of a project. To explore WSDL files stored in other locations within your |
| workspace, type the name of the WSDL file or select the file in the workspace, |
| right-click and select <span class="menucascade"><span class="uicontrol">Web Services </span> > <span class="uicontrol"> Launch |
| Web Services Explorer</span></span>. For this example the WSDL |
| being used is a Web Service which returns a temperature for any entered zip |
| code. <br /><img src="../images/wsdlexp.gif" alt="" /><br /> |
| The following nodes will be added to the WSDL tree: </span> <ul><li>The WSDL node: <img src="../images/wsdlnode.gif" alt="WSDL node icon" /></li> |
| <li>The service node (which represents a service element within the WSDL file): |
| <img src="../images/servnode.gif" alt="Service node icon" /></li> |
| <li>The binding node: <img src="../images/bindnode.gif" alt="Binding node icon" /></li> |
| <li>The operation node: <img src="../images/opnode.gif" alt="Operation node icon" /></li> |
| </ul> |
| </li> |
| <li class="stepexpand"><span>Clicking the Service node in the Navigator pane (in this example |
| this would be the <tt class="sysout">TemperatureService</tt> node) displays |
| all the bindings for this service, as well as their type and a brief description |
| of the binding if the WSDL provider has included one in the Actions pane. |
| Three types of bindings are supported: SOAP, HTTP Get, and HTTP Post. <br /><img src="../images/wsdlservdet.gif" alt="" /><br /> The WSDL |
| used in this example only has one binding, <tt class="sysout">TemperatureBinding</tt>, |
| which is represented as the <tt class="sysout">TemperaturePortType</tt> node |
| in the WSDL tree in the Navigator pane.</span></li> |
| <li class="stepexpand"><span>Clicking a displayed binding or its node displays the WSDL binding |
| details in the Actions pane. This includes the operations and endpoints available |
| for this service. <br /><img src="../images/wsdlbnddetl.gif" alt="" /><br /> In this view you can add or remove endpoints for the service. To |
| add an endpoint, click <strong>Add</strong>, enter the URL for the endpoint, and click |
| <strong>Go</strong>. The Status pane should say that the endpoints were successfully |
| updated. To remove an endpoint, select its checkbox, and click <strong>Remove</strong>.</span></li> |
| </ol> |
| <div class="section"><div class="note"><span class="notetitle">Note:</span> When the |
| Web Services Explorer loads WSDL files that use multiple inline schemas, warning |
| messages will be generated for types that are referenced across these schemas. |
| The warning message will be similar to: <samp class="codeph">Reference of type <<em>qualified_type_name</em>> |
| isn't resolved.</samp></div> |
| </div> |
| </div> |
| <div> |
| <div class="linklist"><strong>Related Concepts</strong><br /> |
| |
| <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="../../org.eclipse.jst.ws.doc.user/tasks/toverws.html"> Developing Web services</a></div>--> |
| </div> |
| </div></div> |
| </body> |
| </html> |