| <html> |
| <head> |
| <meta |
| http-equiv="Content-Type" |
| content="text/html; charset=UTF-8"> |
| <meta |
| http-equiv="Content-Type" |
| content="text/html; charset=iso-8859-1"> |
| <link |
| rel="stylesheet" |
| href="../../default_style.css" |
| type="text/css"> |
| <link |
| rel="stylesheet" |
| href="stylesheets/wtp.css" |
| type="text/css"> |
| <title>Eclipse WTP Tutorials - Creating Top Down Web Service via Apache Axis2</title> |
| </head> |
| <body> |
| <table |
| width="100%" |
| cellspacing="5" |
| cellpadding="2" |
| border="0"> |
| <col width="16"> |
| <col width="*"> |
| <tbody> |
| <tr> |
| <td |
| valign="top" |
| align="right"> </td> |
| <td valign="top"> |
| <table |
| width="100%" |
| cellspacing="5" |
| cellpadding="2" |
| border="0"> |
| <tbody> |
| <tr> |
| <td |
| width="60%" |
| align="left"><font |
| class="indextop" |
| size="5"> <b>Eclipse WTP Tutorials - Creating Top Down Web Service via Apache |
| Axis2</b> </font></td> |
| <td width="40%"><img |
| width="207" |
| hspace="50" |
| height="129" |
| align="middle" |
| src="images/wtplogosmall.jpg" |
| alt=""></td> |
| <br> |
| </tr> |
| </tbody> |
| </table> |
| </td> |
| </tr> |
| <tr> |
| <td |
| valign="top" |
| align="right"> </td> |
| <td valign="top"> |
| <table |
| width="100%" |
| cellspacing="5" |
| cellpadding="2" |
| border="0"> |
| <col width="16"> |
| <col width="*"> |
| <tbody> |
| <tr> |
| <td |
| valign="top" |
| align="right"> </td> |
| <td valign="top"> |
| <p><b> <a href="mailto:sandakith@wso2.com">By Lahiru Sandakith</a> </b> <br> |
| <a href="http://www.wso2.org">WSO2 Inc.</a> <br> |
| June 29, 2007 <br> |
| <br> |
| </p> |
| </td> |
| </tr> |
| <tr> |
| <td |
| valign="top" |
| bgcolor="#0080c0" |
| align="left" |
| colspan="2"><b> <font |
| face="Arial,Helvetica" |
| color="#ffffff"> Introduction </font> </b></td> |
| </tr> |
| <tr> |
| <td |
| valign="top" |
| align="right"> </td> |
| <td valign="top"> |
| <p><br> |
| This tutorial is meant to demonstrate the use of the newly introduced <b>Axis2</b> Web Services |
| tools in the Web Tools Platform Project using the <b>WTP 2.0</b> drivers. Also this tutorial |
| shows how to create a simple top-down Web service from a WSDL file and test that with the WSE |
| (Web Service Explorer). The WSDL file in this scenario calculates the area of an rectangle and |
| its the same WSDL that used in the Axis web services tutorials.</p> |
| <br> |
| </td> |
| </tr> |
| <tr> |
| <td |
| valign="top" |
| bgcolor="#0080c0" |
| align="left" |
| colspan="2"><b> <font |
| face="Arial,Helvetica" |
| color="#ffffff"> Set Up </font> </b></td> |
| </tr> |
| <tr> |
| <td |
| valign="top" |
| align="right"> </td> |
| <td valign="top">Before creating the Web service, there are two prerequisites: |
| <ol> |
| <li><a href="http://www.eclipse.org/webtools/releases/2.0/">Install Latest Eclipse |
| WTP 2.0 integration driver</a></li> |
| <li><a |
| href="http://www.eclipse.org/webtools/jst/components/ws/1.5/tutorials/InstallTomcat/InstallTomcat.html">Configure |
| Apache Tomcat inside Eclipse WTP</a></li> |
| </ol> |
| </td> |
| </tr> |
| <tr> |
| <td |
| valign="top" |
| bgcolor="#0080c0" |
| align="left" |
| colspan="2"><b> <font |
| face="Arial,Helvetica" |
| color="#ffffff"> Creating a top down Java bean Web service and Web service client |
| using Axis2 WTP Tools </font> </b></td> |
| </tr> |
| <tr> |
| <td |
| valign="top" |
| align="right"> </td> |
| <td valign="top"> |
| <p>This tutorial need a Axis2 runtime. You can download the latest axis2 binary distribution |
| from <a href="http://ws.apache.org/axis2/download.cgi">here</a> . <br> |
| <b>Note :</b> Currently Axis2 version 1.2 is the supported version for the Web Services |
| Scenarios.</p> |
| <ol> |
| <li>Download the latest Axis2 runtime from the above link and extract it.</li> |
| <br> |
| <li>Now we point Eclipse WTP to downloaded Axis2 Runtime. Open <b>Window -> |
| Preferences -> Web Services -> Axis2 Emitter</b></li> |
| <br> |
| <img |
| border="0" |
| src="images/1_n.png" |
| alt=""> |
| <br> |
| <p>Select the Axis2 Runtime tab and point to the correct Axis2 runtime location. |
| Alternatively at the Axis2 Preference tab you can set the default setting that will come up |
| on the Web Services Creation wizards. For the moment we will accept the default settings.</p> |
| <li>Click OK. <br> |
| <br> |
| </li> |
| <li>Next we need to create a project with the support of Axis2 features. Open <b>File |
| -> New -> Other... -> Web -> Dynamic Web Project</b></li> |
| <br> |
| <img |
| border="0" |
| src="images/a1.png" |
| alt=""> |
| <br> |
| <p>Click next</p> |
| <li>Select the name Axis2WSTest as the Dynamic web project name(You can specify any |
| name you prefer), and select the configured tomcat runtime as the target runtime</li> |
| <br> |
| <img |
| border="0" |
| src="images/a2.png" |
| alt=""> |
| <br> |
| <p>Click next</p> |
| <li>Select the Axis2 Project Facet</li> |
| <br> |
| <img |
| border="0" |
| src="images/a3_n.png" |
| alt=""> |
| <br> |
| <p>Click next</p> |
| <li>Select the Axis2 Project Facet</li> |
| <br> |
| <img |
| border="0" |
| src="images/a4.png" |
| alt=""> |
| <br> |
| <p>Click Finish</p> |
| <li>This will create a dynamic web project in the workbench</li> |
| <br> |
| <img |
| border="0" |
| height="100%" |
| width="100%" |
| src="images/b1.png" |
| alt=""> |
| <br> |
| <br> |
| <br> |
| <li>Create a folder called WSDL on the Axis2WSTest project. Import the file <a |
| href="code/AreaService.wsdl">AreaService.wsdl</a> into Axis2WSTest/wsdl.</li> |
| <br> |
| <img |
| border="0" |
| height="100%" |
| width="100%" |
| src="images/g1.png" |
| alt=""> |
| <br> |
| <p>Build the Project, if its not auto build.</p> |
| <li>Now we are going to invoke the web service creation wizard with respect to the |
| newly imported WSDL. By selecting AreaService.wsdl source the Open File -> New -> |
| Other... -> Web Services -> Web Service</li> |
| <br> |
| <img |
| border="0" |
| src="images/g3.png" |
| alt=""> |
| <br> |
| <p>Click next</p> |
| <li>Because of the wizard was invoked related to a correct WSDL the correct web |
| services scenario will be picked automatically with the correct service definition. Also the |
| configuration must be automatically set to the correct server, web service runtime and the |
| service project. Make sure that you have selected the scale until to the start service. Also |
| make sure you have the exact same items for the Server, Web Service Runtime and Service |
| Project. Else make appropriate changes to select them as displayed below.</li> |
| <br> |
| <img |
| border="0" |
| src="images/g4.png" |
| alt=""> |
| <br> |
| <p>Click next</p> |
| <li>This page is the skeleton JAVA bean configuration page. if you have a custom |
| preferences you can edit the configuration as needed, for the moment default will do.</li> |
| <br> |
| <img |
| border="0" |
| src="images/g5_n.png" |
| alt=""> |
| <br> |
| <p>Click next</p> |
| <li>This page is the start server page. Click on the start server. This will start the |
| server runtime.</li> |
| <br> |
| <img |
| border="0" |
| src="images/g6.png" |
| alt=""> |
| <br> |
| <p>Click next</p> |
| <li>This page is the web services publication page, accept the defaults.</li> |
| <br> |
| <img |
| border="0" |
| src="images/g7.png" |
| alt=""> |
| <br> |
| <p>Click Finish. You will see the newly created skeleton page gets pop up in the Editor. |
| If you need you can edit the skeleton to include your area service logic. But for the moment |
| We will accept the defaults settings.</p> |
| <br> |
| <li>Here after the skeleton generation the user need to fill the nessesary parts of the |
| service skeleton with the bussiness logic. In this example the CalculatedRectArea method |
| TODO plus the exception must be replace with appropriate logic. For that we need some |
| changes in the build system to auto reflect the change in the deployed service. One thing is |
| we need to make sure that Build Automatically is enabled in the Project Menu. Then we need |
| to change the output location of the project to the location where the service is deployed |
| in the local web service runtime attached to the project. As in this example to the folder |
| WebContent -> axi2-web -> WEB-INF -> services -> Axis2TestWs directory.</li> |
| <br> |
| <img |
| border="0" |
| src="images/sk_1.png" |
| alt=""> |
| <br> |
| <p></p> |
| <br> |
| <li>So now we have done the nessesary thing to auto deploy our TD created web service. |
| Now we go ahead and implement the skeleton. Replave the TODO plus the exception with the |
| following logic foe calculating the Area. <pre>org.tempuri.areaservice.Area area = new org.tempuri.areaservice.Area(); area.setArea( parameters.getParameters().getHeight() * parameters.getParameters().getWidth(); return area;</pre> |
| </li> |
| <br> |
| <img |
| border="0" |
| src="images/sk_2.png" |
| alt=""> |
| <br> |
| <p>Tigger a auto build after saving. You will notice in the console that the service |
| getting re deployed in the server.</p> |
| <br> |
| <li>Now we can run the Dynamic Web Project on the server to see our top down created |
| web service running on axis2 server. For that Select the Axis2WSTest dynamic web project and |
| select Run -> Run As -> Run on Server</li> |
| <br> |
| <img |
| border="0" |
| src="images/d1.png" |
| alt=""> |
| <br> |
| <p>Click Next.</p> |
| <li>Make sure you have the Axis2WSTest dynamic web project on the Configured project.</li> |
| <br> |
| <img |
| border="0" |
| src="images/d2.png" |
| alt=""> |
| <br> |
| <p>Click Next.</p> |
| <li>This page is the web services publication page, accept the defaults.</li> |
| <br> |
| <img |
| border="0" |
| src="images/d3.png" |
| alt=""> |
| <br> |
| <p>Click Finish.</p> |
| <li>By doing the above test the Axis2 server webapp will be automatically deployed on |
| the configured servlet container and will display the axis2 home page.</li> |
| <br> |
| <img |
| border="0" |
| height="100%" |
| width="100%" |
| src="images/d5.png" |
| alt=""> |
| <br> |
| <br> |
| <li>By selecting services can view the available services. The newly created |
| AreaService will be available there.</li> |
| <br> |
| <img |
| border="0" |
| height="100%" |
| width="100%" |
| src="images/g8.png" |
| alt=""> |
| <br> |
| <br> |
| <li>If you need to test the newly creating AreaService with the WSE. at the first page |
| of the skeleton scenario you can increase the slider to the test lever so that the created |
| service can be tested against the Web Services Explorer.</li> |
| <br> |
| <img |
| border="0" |
| src="images/wse_1.png" |
| alt=""> |
| <br> |
| <br> |
| <li>So after the normal pagers it will add another additional page to select the test |
| facility. Select the Web Service Explorer</li> |
| <br> |
| <img |
| border="0" |
| src="images/wse_2.png" |
| alt=""> |
| <br> |
| <br> |
| <li>Now For testing of the newly created AreaService with the WSE, at the end of the |
| scenario it will launch the Web Services Explorer with the nessesary configuration loaded so |
| that user can invoke the service easily.</li> |
| <br> |
| <img |
| border="0" |
| height="100%" |
| width="100%" |
| src="images/wse_3.png" |
| alt=""> |
| <br> |
| <br> |
| <li>Please refer the <a |
| href="http://www.eclipse.org/webtools/jst/components/ws/1.0/tutorials/WebServiceExplorer/WebServiceExplorer.html">Using |
| Web Service Explorer to test a Web service</a> for more details. <br> |
| <br> |
| <br> |
| <br> |
| </li> |
| </ol> |
| </td> |
| </tr> |
| <tr> |
| <td |
| valign="top" |
| bgcolor="#0080c0" |
| align="left" |
| colspan="2"><b> <font |
| face="Arial,Helvetica" |
| color="#ffffff"> Summary </font> </b></td> |
| </tr> |
| <tr> |
| <td |
| valign="top" |
| align="right"> </td> |
| <td valign="top"> |
| <p>The Web Service wizard is orchestrating the end-to-end generation, assembly, deployment, |
| installation and execution of the Web service, Web service client. In this scenario, we |
| completed the top-down web service creation scenario using WTP web services tools. Most of the |
| time the wizard will pick reasonable defaults according to the basic high-level choices. After |
| completing this scenario, the WSDL for the AreaService Web service can be found in Clicking on |
| the available services converter service link Now that your Web service is running, there are a |
| few interesting things you can do with this WSDL file. Examples:</p> |
| <ul> |
| <li>You can choose Web Services -> Test with Web Services Explorer to test the |
| service.</li> |
| <li>You can choose Web Services -> Publish WSDL file to publish the service to a |
| public UDDI registry.</li> |
| <li>You choose New -> Other... -> Web Services -> Web Service Client to |
| generate a Web service client.</li> |
| </ul> |
| <p></p> |
| </td> |
| </tr> |
| <tr> |
| <td |
| valign="top" |
| bgcolor="#0080c0" |
| align="left" |
| colspan="2"><b> <font |
| face="Arial,Helvetica" |
| color="#ffffff"> Resources </font> </b></td> |
| </tr> |
| <tr> |
| <td |
| valign="top" |
| align="right"> </td> |
| <td valign="top"> |
| <p>You can also refer the Axis web services creation wizards.</p> |
| <ul> |
| <li><a |
| href="http://www.eclipse.org/webtools/jst/components/ws/1.0/tutorials/WebServiceExplorer/WebServiceExplorer.html">Using |
| Web Service Explorer to test a Web service</a></li> |
| <li><a |
| href="http://www.eclipse.org/webtools/jst/components/ws/1.5/tutorials/BottomUpWebService/BottomUpWebService.html">Creating |
| Bottom Up Web Service via Axis</a></li> |
| <li><a |
| href="http://www.eclipse.org/webtools/jst/components/ws/1.5/tutorials/TopDownWebService/TopDownWebService.html">Creating |
| Top Down Web Service via Axis</a></li> |
| <li><a |
| href="http://www.eclipse.org/webtools/jst/components/ws/1.5/tutorials/WebServiceClient/WebServiceClient.html">Consuming |
| Web service using Web Service Client via Axis</a></li> |
| </ul> |
| <p></p> |
| </td> |
| </tr> |
| </tbody> |
| </table> |
| </td> |
| </tr> |
| </tbody> |
| </table> |
| </body> |
| </html> |
