Deployment and testing

Seems like we're ready to deploy and test the Web service. In this section, we package our Web service for deployment, deploy it, and test it using Representational State Transfer (REST) and the client you've built.

Creating a deployment package of your Web service

Before you can run the stand-alone server and test the Web service, you need to package your code in a WAR file for deployment:

• Select the WSDL file in the Navigator view
• Click SOA > Generate Deploy Package

That creates a deployable WAR file at WebContent/ScientificCalculator.war in your project.

Now you're good to move on and run the stand-alone Web server.

Back to top

Running the stand-alone Web server

The development framework comes with a stand-alone Web server, which allows you to perform testing of your Web service within the Eclipse framework.

Note that the STP plug-in has created a couple preconfigured run configurations. To run the server:

1. Double-click the Java interface in the Navigator view
2. Click Run > Run
3. Select Java Application > ScientificCalculatorServer_server_com.ibm.dw.scicalc, as shown in Figure 7
4. Click Run

The server should then run and let you know it's ready.

Now point your browser to http://localhost:8080/ScientificCalculator/services/ScientificCalculatorService?wsdl and you should see the WSDL. Next, we test the Web service in a browser using REST.

Back to top

Testing using REST

With a browser pointed to the WSDL of the Web service, you can now test operations on it. Point your browser to http://localhost:8080/ScientificCalculator/services/ScientificCalculatorService/square?square0=4.5.

Notice that we're calling the square operation with 4.5 as the parameter. You'll get a file of type soap+xml, that will show 20.25 as the result, as shown in the SOAP message that gets returned below.

                    
<soap:Envelope
     xmlns:soap="http://www.w3.org/2003/05/soap-envelope">
  <soap:Body>
    <ns2:return xmlns:ns2="http://scicalc.dw.ibm.com/"
                xmlns="http://www.w3.org/2005/08/addressing/wsdl">
      20.25
    </ns2:return>
  </soap:Body>
</soap:Envelope>

You can see the answer is 20.25. Feel free to test out the other operations using REST. Next, we do a more regressive test using your client.

Back to top

Testing by running the client code

Now that you know your service is up and functional with a REST test, you can perform a more rigorous and all-encompassing test using your client. To run the client:

1. Double click the Java interface in the Navigator view
2. Click Run > Run
3. Select Java Application > ScientificCalculatorClient_client_com.ibm.dw.scicalc
4. Select the Arguments tab
5. Replace the "Program arguments" pane with http://localhost:8080/ScientificCalculator/services/ScientificCalculatorService?wsdl, as shown in Figure 9
6. Click Run

After clicking Run, the client will run and execute each operation in the console, as shown below.

You can see the server output of the client's execution by switching to its console, as shown below.

There you are! You have a completely functional Web service. Next, we do a final test by deploying the Web service on Apache Tomcat.

Back to top

Deploying and testing on Apache Tomcat

Before you begin setting up Tomcat inside of Eclipse, you first need to copy some jars over to Tomcat's shared/lib directory by doing the following: Copy all jars except cxf-integration-jbi-*.jar (note the asterisk being a wildcard), or cxf-integration-jbi-2.0-incubator-RC-SNAPSHOT.jar for this tutorial, from CXF-Runtime-install-directory/lib to Tomcat-install-directory/shared/lib.

OK -- you're ready to move on and deploy the package on Tomcat using the Eclipse DTP. You'll begin by creating a new connector (the first four steps are also for if you want to optional start the Tomcat server within Eclipse):

1. Click File > New > Other
2. Open the Server folder and select Server
3. Select, under the Apache folder, Tomcat v5.5 Server
4. Click Finish
5. Now click File > New > Other
6. Open the Connection Profiles folder and select Connection Profile
7. Select Tomcat Connection Profile
8. Click Next
9. Enter a name, Tomcat 5.5, and click Next
10. Browse for the directory you installed Tomcat to (C:\apps\tomcat-5.5.20 for this tutorial)
11. Click Finish

To deploy on Tomcat, start the Tomcat server by running startup.bat (Windows®) or startup.sh (Linux®). Once Tomcat is running, deploy your Web service by:

1. Selecting the WAR file in the Navigator view
2. Right-clicking it and selecting Deploy, as shown below
   
   
   Figure 12. Server output
   
   
   
3. Click the connection profile you made, Tomcat 5.5, and click OK
4. If you've deployed before, you'll get a warning message, as shown in Figure 13. Click OK
   
   
   Figure 13. Possible ignorable warning message
   
   
   

Now run the client as before, and you should get exactly the same output shown in Figure 10. Tomcat's standard output should also display what's shown in Figure 11.

We have built and tested a Web service successfully using the Eclipse STP plug-in.

9 of 13 | Previous | Next

Comments

Back to top

Table of contents

• Before you start
• Introduction
• Installing and creating an STP project
• Creating the Java interface
• Generating WSDL
• Code generation from WSDL
• Defining the service implementation
• Defining the client code
• Deployment and testing
• Summary
• Download
• Resources
• About the author

---

9 of 13 | Previous | Next

Next steps from IBM

Rational Tester for SOA Quality is an automated web services testing and SOA testing tool that supports Web services SOAP, HTTP(S), JMS, WS-Security, UDDI, and RESTful standards.

---

• Try: The no-charge Rational Service Tester for SOA Quality helps quality assurance professionals validate web service based SOA application..
• Article: See the whats new with Rational Service Tester for SOA Quality, and its Generic Service Client, which provides a single client to interact with any SOA service type.
• Tutorial: Get hands-on experience with this Transport for SOAP feature tutorial using Rational Tester for SOA Quality.
• Buy: Rational Service Tester for SOA Quality

Dig deeper into Open source on developerWorks

Try IBM PureSystems. No charge.

Experience today!

---

Get started with the cloud-based trial and pattern development kit.