| <!doctype html public "-//w3c//dtd html 4.0 transitional//en"> |
| <html> |
| <head> |
| <meta http-equiv="Content-Type" content="text/html; charset=iso-8859-1"> |
| <meta name="GENERATOR" content="Mozilla/4.75 [en] (Windows NT 5.0; U) [Netscape]"> |
| </head> |
| <body> |
| |
| <h1> |
| Bottom up Java Web Service - Axis</h1> |
| |
| <p>Run wsant.bat which invokes the wsgen.xml Ant file and generates a Java web service |
| bottom up from input Java source.</p> |
| |
| <h2>Instructions:</h2> |
| |
| <ol> |
| <li>Start WTP.</li> |
| <li>Create a dynamic web project called <b>buProject</b> with an Apache Tomcat target server. |
| <b>File > New > Web > Dynamic Web Project</b>. </li> |
| <li>Import <b>wtp.Converter</b> to the <b>src</b> folder of <b>buProject</b>. |
| <a href="../axis_bujava/converter.zip"> Converter.zip</a></li> |
| <li>Check the Servers view and make sure that the server is started.</li> |
| <li>Exit the workbench.</li> |
| <li>Navigate to the <b>plugins</b> directory of your WTP installation. Change to the |
| <b>org.eclipse.wst.command.env</b> plugin and go to the <b>ant</b> folder. |
| For example: <code>D:\wtp1110\eclipse\plugins\org.eclipse.wst.command.env_1.0.0\ant</code></li> |
| <li>The following files should exist there: |
| <ul> |
| <b> |
| <li>wsant.bat</li> |
| <li>wsgen.xml</li> |
| <li>axisservice.properties</li> |
| <li>axisclient.properties</li> |
| </b> |
| </ul></li> |
| <li> Open and edit the <b>wsgen.xml</b> Ant script so that |
| <code>property file="axisservice.properties"</code></li> |
| <li>Save the <b>wsgen.xml</b> file.</li> |
| <li>Edit the <b>axisservice.properties</b> file. Check that <code>scenarioType=service</code> |
| and <code>InitialSelection=/buProject/src/wtp/Converter.java</code>. If your default server |
| and runtime are set in the preferences as Tomcat and Axis you can safely remove all other |
| properties from the file. Otherwise, set: <code>Service.RuntimeId=org.eclipse.jst.ws.axis.creation.axisWebServiceRT</code> |
| and <code>Service.ServerId=org.eclipse.jst.server.tomcat.50</code> and remove the remaining properties. Defaults |
| will be used for unset properties.</li> |
| <li>Save the <b>axisservice.properties</b> file. </li> |
| <li>Edit the <b>wsant.bat</b> file. Set the local environment variables to reflect your system |
| configuration inluding the location of your JRE, the Eclipse <b>startup.jar</b> and the workspace |
| containing the web project and <b>Converter.java</b> file. |
| </li> |
| <li>Run <b>wsant.bat</b>.</li> |
| <li>Look at the <b>wsgen.txt</b> file for output. Look for a <code>BUILD SUCCESSFUL</code> message and no exceptions. |
| <li>At the command line or back in WTP, navigate to the workspace to check the contents of the Java source folder |
| and the <b>WebContent\wsdl</b> folder in the <b>buProject</b>. Check to see that <b>Converter.wsdl</b> was |
| created. |
| Also verify that the deployment descriptors were generated in the WEB-INF\ConverterService\WTP folder: |
| <ul> |
| <b> |
| <li>deploy.wsdd</li> |
| <li>deploy.wsdd.bak</li> |
| <li>undeploy.wsdd</li> |
| </b> |
| </ul> |
| </li> |
| <li>Test the web service using the Web Services Explorer.</li> |
| </ol> |
| </body> |
| </html> |
