| <?xml version="1.0" encoding="utf-8"?> | |
| <!--Arbortext, Inc., 1988-2005, v.4002--> | |
| <!DOCTYPE task PUBLIC "-//OASIS//DTD DITA Task//EN" | |
| "task.dtd"> | |
| <task id="twsclienta" xml:lang="en-us"> | |
| <title>Creating a Web service client using Ant tasks</title> | |
| <titlealts> | |
| <searchtitle>Creating an Axis runtime Web service client from a WSDL file | |
| using command line tools</searchtitle> | |
| </titlealts> | |
| <shortdesc>If you have a WSDL file you can use Ant through the Eclipse workspace | |
| to generate a Web service client using the Axis run-time environment.</shortdesc> | |
| <taskbody> | |
| <prereq>Before creating the Web service client you must:<ul> | |
| <li>complete the prerequisites listed in: <xref href="cwsaxisant.dita"></xref></li> | |
| <li>create or import a WSDL file into the dynamic Web project you created.</li> | |
| </ul></prereq> | |
| <context>In order to create the Web service client you need to modify the | |
| Ant file and the Ant properties file.</context> | |
| <steps> | |
| <step><cmd>Edit the Ant file (<userinput>wsgen.xml</userinput>) that you imported | |
| in the prerequisite steps. Ensure that it points to the client Ant properties | |
| file: it should contain a line stating <userinput><property file="axisclient.properties"/></userinput>.</cmd> | |
| <info>Save any changes that you have made.</info></step> | |
| <step><cmd>Edit the <userinput>axisclient.properties</userinput> file that | |
| you imported in the prerequisite steps.</cmd> | |
| <substeps> | |
| <substep><cmd>Ensure that the scenarioType parameter is set to client.</cmd> | |
| </substep> | |
| <substep><cmd>Set the workspace parameter so that it points to the location | |
| of your WSDL file.</cmd></substep> | |
| <substep><cmd>All other parameters are optional and should be deleted if not | |
| explicitly set. The default values for the remaining parameters will be retrieved | |
| from the dynamic project settings. For additional information on how to set | |
| these parameters refer to: <xref href="rwsclienta.dita"></xref></cmd></substep> | |
| </substeps> | |
| <info>Save the <userinput>axisclient.properties</userinput> file.</info></step> | |
| <step><cmd>Right-click <userinput>wsgen.xml</userinput> and select <menucascade> | |
| <uicontrol>Run As</uicontrol><uicontrol>Ant Build...</uicontrol></menucascade></cmd> | |
| </step> | |
| <step><cmd>In the dialog that opens, select the <uicontrol>JRE</uicontrol> tab | |
| and select <uicontrol>Run in the same JRE as the workspace</uicontrol>.</cmd> | |
| <info>Click <uicontrol>Apply</uicontrol> and then click <uicontrol>Run</uicontrol>.</info> | |
| </step> | |
| <step><cmd>Once your Web service has been generated the console displays a <userinput>Build | |
| Successful</userinput> message.</cmd></step> | |
| </steps> | |
| <result>The following files will have been created and placed in the dynamic | |
| Web project's WebContent\wsdl folder:<ul> | |
| <li><i>Service_name</i>SOAP.wsdl </li> | |
| </ul>The following files will have been created and placed in the dynamic | |
| Web project's WebContent\WEB-INF folder:<ul> | |
| <li>undeploy.wsdd</li> | |
| <li>deploy.wsdd </li> | |
| </ul>The following files will have been created and placed under the dynamic | |
| Web project's src folder. Depending on the WSDL file on which the Web service | |
| client is based, the files for your Web service client may be different:<ul> | |
| <li><i>Service_name</i>Proxy.java</li> | |
| <li>get<i>Service_name</i>.java</li> | |
| <li>get<i>Service_name</i>Locator.java</li> | |
| <li>get<i>Service_name</i>Soap.java</li> | |
| <li>get<i>Service_name</i>SoapProxy.java</li> | |
| <li>get<i>Service_name</i>SoapStub.java</li> | |
| </ul> </result> | |
| </taskbody> | |
| </task> |