blob: c93de37a7cd6b0f68be6cab18ed9377e45e82e67 [file] [log] [blame]
<?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, 2009 IBM Corporation and others. All rights reserved. This program and the accompanying materials are made available under the terms of the Eclipse Public License v2.0 which accompanies this distribution, and is available at https://www.eclipse.org/legal/epl-2.0/. Contributors: IBM Corporation - initial API and implementation" />
<meta name="DC.rights.owner" content="(C) Copyright 2000, 2009" />
<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="Exploring WSDL using the WSDL Explorer" />
<meta content="WSDL files, exploring, Web services, exploring WSDL files" name="DC.subject" />
<meta content="WSDL files, exploring, Web services, exploring WSDL files" name="keywords" />
<meta content="XHTML" name="DC.Format" />
<meta content="twsdlexp" 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>Exploring WSDL using the WSDL Explorer</title>
</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>Show WSDL details: <img src="../images/wsdldtlicon.gif" alt="WSDL Details icon" /></li>
<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>
</ul>
</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: <img src="../images/wsdlfavicon.gif" alt="Add WSDL to Favorites 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> &gt; <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 &lt;<em>qualified_type_name</em>&gt;
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>