Google Git
Sign in
eclipse / gerrit / www.eclipse.org / webtools / 234cfcb3f2518248dcded22b99723f675990164e / . / jst / components / ws / M3 / tutorials / TopDownWebService.html
blob: eaa422df7b9561f9fbd737e70049d3bcacef712e [file] [log] [blame]
<html>
<head>
<META http-equiv="Content-Type" content="text/html; charset=UTF-8">
<meta content="text/html; charset=iso-8859-1" http-equiv="Content-Type">
<link type="text/css" href="../../../../../..//default_style.css" rel="stylesheet">
<link type="text/css" href="../../../../../..//webtools/wtp.css" rel="stylesheet">
<title>Top Down Web Service Tutorial</title>
</head>
<body>
<table border="0" cellpadding="2" cellspacing="5" width="100%">
<tbody>
<tr>
<td align="left" width="60%"><font class="indextop">Top Down Web Service Tutorial</font>
<br>
<font class="indexsub">Top Down Web Service Tutorial</font></td><td width="40%"><img src="../../../../../..//webtools/images/wtplogosmall.jpg" align="middle" height="129" hspace="50" width="207"></td>
</tr>
</tbody>
</table>
<table border="0" cellpadding="2" cellspacing="5" width="100%">
<col width="16">
<col width="*">
<tbody>
<tr>
<td align="right" valign="top">&nbsp;</td><td valign="top">
<p>
<b>By Kathy Chan</b>
<br>
Feb 25, 2005
<br>
<br>
</p>
</td>
</tr>
<tr>
<td colspan="2" align="left" bgcolor="#0080c0" valign="top"><b><font color="#ffffff" face="Arial,Helvetica">Introduction</font></b></td>
</tr>
<tr>
<td align="right" valign="top">&nbsp;</td><td valign="top">
<br>
</td>
</tr>
<tr>
<td align="right" valign="top">&nbsp;</td><td valign="top">
<p>
This document is a one of a series of tutorials to
demonstrate the use of the Web Services tools in the Web
Tools Platform Project.
</p>
</td>
</tr>
<tr>
<td align="right" valign="top">&nbsp;</td><td valign="top">
<p>
This tutorial shows how to create a simple top-down Web
service from a WSDL file. The WSDL file in this scenario
calculates the area of an rectangle.
</p>
</td>
</tr>
<tr>
<td align="right" valign="top">&nbsp;</td><td valign="top">
<br>
</td>
</tr>
<tr>
<td colspan="2" align="left" bgcolor="#0080c0" valign="top"><b><font color="#ffffff" face="Arial,Helvetica">Getting Started</font></b></td>
</tr>
<tr>
<td align="right" valign="top">&nbsp;</td><td valign="top">
<br>
</td>
</tr>
<tr>
<td align="right" valign="top">&nbsp;</td><td valign="top">
<p>
Follow the instruction at
<a href="GettingStartedWebService.html">
Getting Started with Web Service
</a>
before proceeding with the tutorial.
</p>
</td>
</tr>
<tr>
<td align="right" valign="top">&nbsp;</td><td valign="top">
<br>
</td>
</tr>
<tr>
<td colspan="2" align="left" bgcolor="#0080c0" valign="top"><b><font color="#ffffff" face="Arial,Helvetica">Set Up</font></b></td>
</tr>
<tr>
<td align="right" valign="top">&nbsp;</td><td valign="top">
<br>
</td>
</tr>
<tr>
<td align="right" valign="top">&nbsp;</td><td valign="top">
<p>
Before creating the Web service, there are two
prerequisites:
<ol>
<li>
<a href="InstallTomcat.html">
Install Apache Tomcat
</a>
</li>
<li>Create a Web project</li>
<ol>
<li>
Open
<b>
File -&gt; New -&gt; Other... -&gt; Web -&gt; J2EE Web
Project
</b>
to create a new Web project named
<tt>AreaProject</tt>
.
</li>
<li>
Enter
<tt>AreaProject</tt>
into the
<b>Name</b>
field.
</li>
<li>
Choose a
<b>Servlet version</b>
of
<b>2.3</b>
.
</li>
<li>
Choose a
<b>Target server</b>
of
<b>Apache Tomcat v4.1</b>
.
</li>
<li>
Deselect
<b>Add module to an EAR project</b>
. Result:
</li>
<br>
<img border="0" SRC="resources/TopDownWebService/image2C7.JPG">
<li>
Click
<b>Finish</b>
.
</li>
</ol>
</ol>
</p>
</td>
</tr>
<tr>
<td colspan="2" align="left" bgcolor="#0080c0" valign="top"><b><font color="#ffffff" face="Arial,Helvetica">Create a top down Java bean Web service</font></b></td>
</tr>
<tr>
<td align="right" valign="top">&nbsp;</td><td valign="top">
<ol>
<li>
Import the file
<a href="resources/TopDownWebService/AreaService.wsdl">AreaService.wsdl</a>
into AreaProject/WebContent.
</li>
<li>Select the <b>AreaService.wsdl</b> file.</li>
<li>
Open File -&gt; New -&gt; Other... -&gt; Web Services -&gt; Web
Service.
</li>
<li>
In the Web service type combo, select
<b>Skeleton Java bean Web Service</b>
.
</li>
<li>
Select
<b>Overwrite files without warning</b>
. Result:
</li>
<br>
<img border="0" SRC="resources/TopDownWebService/imageJ3A.JPG">
<li>
Click
<b>Next</b>
. Result:
</li>
<br>
<img border="0" src="resources/TopDownWebService/image0R7.JPG">
<li>
Click
<b>Next</b>
to get to the
<b>Service Deployment Configuration Page</b>
. Result:
</li>
<br>
<img border="0" src="resources/TopDownWebService/imageIB0.JPG">
<li>
If you want to choose a server different
from the one defaulted by the wizard, click the
<b>Edit</b>
button to:
<a href="SelectServer.html">
select a server
</a>
</li>
<li>
Click
<b>Finish</b>.
</li>
<li>
It will take about one minute for the wizard to assemble
the Web service projects, start Apache Tomcat and deploy
the projects to Tomcat. Once finished, the Java
implementation file
<b>AreaServiceSOAPImpl.java</b>
will appear in the browser view. Fill in
<b>parameters.getHeight()*parameters.getWidth()</b>
as the return value and save the file.
</li>
<br>
<img border="0" SRC="resources/TopDownWebService/imageQB2.JPG">
</ol>
</td>
</tr>
<tr>
<td align="right" valign="top">&nbsp;</td><td valign="top">
<p>
Follow the instruction at
<a href="WebServiceClient.html">
Creating Web Service Client
</a>
to create a Web service client to test this Web service.
</p>
</td>
</tr>
</tbody>
</table>
</body>
</html>