| <?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="tsampappa" xml:lang="en-us"> |
| <title>Generating a <tm tmclass="special" tmowner="Sun Microsystems, Inc." |
| tmtype="tm" trademark="Java">Java</tm> client proxy and a sample application |
| from a WSDL document using the Axis run-time environment</title> |
| <titlealts> |
| <searchtitle>Generating a Java client proxy and a sample application from |
| a WSDL document using the Axis run-time environment</searchtitle> |
| </titlealts> |
| <shortdesc>The Web Service Client wizard assists you in generating a <tm tmclass="special" |
| tmowner="Sun Microsystems, Inc." tmtype="tm" trademark="Java">Java</tm> bean |
| proxy and a sample application. The sample Web application demonstrates how |
| to code a proxy file.</shortdesc> |
| <prolog><metadata> |
| <keywords><indexterm>Web services<indexterm>Axis runtime environment<indexterm>creating |
| a Web service client</indexterm></indexterm></indexterm><indexterm>Axis runtime |
| environment<indexterm>creating a Web service client</indexterm></indexterm> |
| <indexterm>Web service clients<indexterm>creating with the Axis runtime environment</indexterm></indexterm> |
| </keywords> |
| </metadata></prolog> |
| <taskbody> |
| <prereq><p>Prerequisites:</p><ol> |
| <li conref="twsbeana.dita#twsbeana/createtomcatlink"></li> |
| <li>Discover and import a WSDL document into the Web project. You can only |
| use a WSDL file that contains a service element.</li> |
| </ol></prereq> |
| <context>To generate a <tm tmclass="special" tmowner="Sun Microsystems, Inc." |
| tmtype="tm" trademark="Java">Java</tm> client proxy and a sample application |
| from a discovered WSDL document:</context> |
| <steps> |
| <step><cmd>Switch to the J2EE perspective (<uicontrol>Window > Open Perspective |
| > J2EE</uicontrol>).</cmd></step> |
| <step><cmd>In the Navigator view, select the Web project in which you want |
| to generate a sample application.</cmd></step> |
| <step><cmd>Click <uicontrol>File > New > Other</uicontrol>. Select <uicontrol>Web |
| Services</uicontrol> in order to display the various Web service wizards. |
| Select the <uicontrol>Web Service Client</uicontrol> wizard. Click <uicontrol>Next</uicontrol>.</cmd> |
| </step> |
| <step><cmd>Web Services page: </cmd> |
| <substeps> |
| <substep><cmd>Enter the URI to the WSDL, WSIL, or HTML file that will be used |
| to generate the client.</cmd></substep> |
| <substep><cmd>Select the type of proxy to be generated</cmd></substep> |
| <substep><cmd>Select the stages of Web services development that you want |
| to complete using the slider:</cmd><info><ul> |
| <li>Develop: this will create the client code</li> |
| <li>Assemble: </li> |
| <li>Deploy: this will create the deployment code for the client</li> |
| <li>Install: this will install the client on the chosen server</li> |
| <li>Start: this will start the server once the client has been installed on |
| it</li> |
| <li>Test: this will provide various options for testing the client</li> |
| </ul></info></substep> |
| <substep><cmd>Select your server: the default server is displayed. If you |
| want to deploy your client to a different server click the link to specify |
| a different server.</cmd></substep> |
| <substep><cmd>Select your runtime: the default runtime is displayed. If you |
| want to deploy your client to a different runtime click the link to specify |
| a different runtime.</cmd></substep> |
| <substep><cmd>Select the client project: the project containing the project |
| selected in your workspace is displayed. To select a different project and |
| EAR click on the project link.</cmd><info>Ensure that the project selected |
| as the Client Web Project is different from the Service Web Project, or the |
| service will be overwritten by the client's generated artifacts.</info></substep> |
| <substep><cmd>Monitor the Web service: this will send the Web service traffic |
| through the TCP/IP Monitor, which allows you to watch the SOAP traffic generated |
| by the Web service and to test this traffic for WS-I compliance. Alternately |
| you can manually set up a TCP/IP monitor as described in <xref href="../../org.eclipse.wst.wsi.ui.doc.user/tasks/tmonitor.dita" |
| scope="peer">Using the TCP/IP Monitor to test Web services</xref></cmd></substep> |
| </substeps> |
| </step> |
| <step><cmd>Web Service Proxy page: This panel shows the options for the proxy. |
| It lists the folder where the proxy will be generated, and you can optionally |
| create custom mappings between namespaces and packages.</cmd></step> |
| <step><cmd>Web Service Namespace to Package Mappings page: if you selected |
| <uicontrol>Define custom mapping for namespace to package</uicontrol> on |
| the previous page, you can enter your custom mapping pairs on this page by |
| clicking <uicontrol>Add</uicontrol>.</cmd></step> |
| <step><cmd>Web Service Client Test page: This page displays if you selected |
| to test your client. Select the test facility that you will use to test the |
| proxy, and the methods that you want included in the proxy. Note that the |
| Universal Test Client (UTC) is only compatible with Web service clients deployed |
| on <tm tmclass="ibm" tmowner="IBM Corporation" tmtype="reg" trademark="WebSphere">WebSphere</tm> servers.</cmd> |
| </step> |
| <step><cmd>Click <uicontrol>Finish</uicontrol>. If you have selected to test |
| the proxy, the test client will open in a browser window.</cmd></step> |
| </steps> |
| <result><p>The generated <tm tmclass="special" tmowner="Sun Microsystems, Inc." |
| tmtype="tm" trademark="Java">Java</tm> bean proxy provides a remote procedure |
| call interface to the Web service. The sample Web application demonstrates |
| how to code the proxy file.</p><p>Once you have generated your <tm tmclass="special" |
| tmowner="Sun Microsystems, Inc." tmtype="tm" trademark="Java">Java</tm> client |
| proxy, you may test the methods of the Web service through the proxy using |
| Web Services sample JSPs or the Universal test client.</p><ul outputclass="wsclienttestoptions"> |
| <li>If you have selected to test the generated proxy using Web service JSPs, |
| the proxy is launched in a Web browser at the following URL: <codeph>http://localhost: <varname>port</varname>/ <varname>WebProject</varname>Client/sample<i |
| >BeanName</i>/ <varname>WebServiceName</varname>/TestClient.jsp</codeph> You |
| can use this sample application to test the Web service by selecting a method, |
| entering a value for the method, and clicking <uicontrol>Invoke</uicontrol>. |
| The result of the method will display in the results pane.</li> |
| <li>If you have selected to test the Web service using the Web Services Explorer, |
| the Explorer will open. Select the operation you want to test, enter the required |
| information, and click <b>Go</b>. The result will display in the Status pane.</li> |
| </ul><p>For more information on creating a Web project, refer to the Web application |
| development documentation.</p></result> |
| </taskbody> |
| <related-links> |
| <linklist><title>Related Concepts</title> |
| <link href="../../org.eclipse.jst.ws.doc.user/concepts/cwsinwsa.dita" scope="peer"> |
| <linktext> Tools for Web services development</linktext></link> |
| <link href="../../org.eclipse.jst.ws.doc.user/concepts/cws.dita" scope="peer"> |
| <linktext>Web services development</linktext></link> |
| </linklist> |
| <linklist><title>Related Tasks</title> |
| <link href="../../org.eclipse.jst.ws.consumption.ui.doc.user/tasks/tuddiexp.dita" |
| scope="peer"><linktext> Using the Web Services Explorer</linktext></link> |
| </linklist> |
| <linklist><title>Related Reference</title> |
| <link href="../../org.eclipse.jst.ws.doc.user/ref/rwsdl.dita" scope="peer"> |
| <linktext>WSDL documents</linktext></link> |
| </linklist> |
| </related-links> |
| </task> |