Introduction

The goal of this article is to explain how to test a Web Service designed for IBM WebSphere Application Server 7.0 using IBM Rational Application Developer and IBM Rational Service Tester 8.x or IBM Rational Performance Tester with SOA extension.

This document will demonstrate:

• How to create a Web Service (invoker) with Rational Application Developer;
• How to create a stub of a Web Service with Rational Application Developer which is call in a first step;
• How to test a Web Service calling a stubbed Web Service with Rational Service Tester or Rational Performance Tester SOA extension.

Back to top

Prerequisites

Before following the instructions in this article, you must install the following products:

• Rational Application Developer 7.5.2 (minimal version)
• WebSphere Application Server 7.0
• Either Rational Service Tester 8.1.0.3 (minimal version) or Rational Performance Tester 8.1.0.3 with the SOA Extension

Back to top

Creation of two web services with Rational Application Developer

To illustrate this example, we will create two web services:

1. A quotation service: this is the web service that will be replaced with a stub. This service provides a quotation rate for each market.
2. An intermediate invoker service: this is the web service under test, which uses the quotation service to select the best quotation among several markets.

In addition, you will need a client that can call the invoker service.

Creation of quotation web service to stub

1. Open Rational Application Developer:
   Start > All Programs > IBM Software Delivery Platform > IBM Rational Application Developer 7.5 > IBM Rational Application Developer
2. Open the J2EE Perspective:
   Click Windows > Open Perspective > Other > Java EE
   When prompted, specify a workspace location.
3. Create a new dynamic Web project and then create a new WSDL File:
   File > New > Dynamic Web Project

4. Select WebSphere Application Server 7.

5. Click Finish.
6. Enter the Project name and target runtime such as on next figure.

7. Click Finish.
8. Create a new WSDL file
   File > New > Web Services > WSDL

9. Click Next.
10. Specify a file name, for example: Quotation1.wsdl

11. Click Next.

12. Click Finish.
13. Use the WSDL editor to create the following WSDL.
    Replace the name of the operation NewOperation with ProvideQuotation1 and switch to View > Advanced.

14. Click on the arrow to specify the input data and define following input elements:

15. Click the Output value arrow to specify the output data.

You have now defined the web service that you want to stub. We will define now the web service invoker in next section.

Creation of the web service for invocation

You can use the existing quotation web service to create another web service that will be used to invoke it.

1. Create a new dynamic web service named: QuotationInvoker

2. Click New to create a new EAR project.
   Specify the project name, for example: QuotationInvokerWebServiceEAR

3. Click Finish.

You should see the following window:

4. Click Finish.
5. In the QuotationInvoker project, create a new WSDL file with the name:
   QuotationInvoker.wsdl File > New > Web Services > WSDL

6. Click Next.
7. Change the target namespace to the following value:

8. Click Finish.
9. Specify the Web Service WSDL as in the following diagram, with an operation named: GetBestQuotation.

10. Define the Input parameter: Define a String for the endpoint. This endpoint value is used for providing the endpoint that the web service will use.

11. Define the output value returns two values:
    place_market
    quotation

12. Select the WSDL and generate the skeleton java code: Right-click > Web services > Generate Java Bean Skeleton
    Ensure that enabled web service runtime is: IBM WebSphere JAX-RPC Enable Publish the Web Service

13. Click Next twice.

14. Click Finish.

The following code is generated:

Creation of a client for the QuotationWebService1 web service to call

1. You can use the QuotationWebService1 Web Service to generate a dedicated client for the service.
   To do this, you can generate a client from the Quotation1.wsdl file.
   To generate the skeleton: right click the WSDL file and select Web Service > Generate Client
   Copy-paste the code into the Web Service invoker.

2. Ensure that Web Service runtime is set to IBM WebSphere JAX-RPC.

3. Click Finish.
4. This generates the Java source code:

Populating and using the web service invoker

1. In the QuotationInvoker project src folder, copy-paste the org.example.www package source code from QuotationWebService1 to obtain the following result in the invoker:

2. Replace the implementation code in QuotationInvokerSOAPImpl with the following code:

import java.rmi.RemoteException;

import org.example.www.Quotation1_PortTypeProxy;

public class QuotationInvokerSOAPImpl implements 
        org.QuotationInvoker.www.QuotationInvoker_PortType{
    public void getBestQuotation(java.lang.String endP, 
            javax.xml.rpc.holders.StringHolder place_market, 
            javax.xml.rpc.holders.DoubleHolder quotation) 
            throws java.rmi.RemoteException {
        
    	// Display on the console
    	System.err.println("endpoint : " + endP);
    	Quotation1_PortTypeProxy proxy = new Quotation1_PortTypeProxy();
    	proxy.setEndpoint(endP);
   
		double quoteNY = 0.0 ;
		double quoteParis = 0.0 ; 
		try {
	    	System.err.println(">>>");
	    	quoteNY = proxy.provideQuotation1("New York", "gold") ;
	    	System.err.println("quote New York= " + quoteNY);
	    	quoteParis = proxy.provideQuotation1("Paris", "gold") ;
	    	System.err.println("quote Paris= " + quoteParis);
		} catch (RemoteException e) {
			// NOP
			e.printStackTrace();
		}
    	
    	// Computation of best quote
		if (quoteNY > quoteParis)
		{
			place_market.value = "New York";
			quotation.value = quoteNY;
		}
		else
		{
			place_market.value = "Paris";
			quotation.value = quoteParis;			
		}
		
		}
    }

Get the QuotationInvoker.wsdl file for testing

3. Copy the QuotationInvoker.wsdl file from the Rational Application Developer workspace l to a temporary directory, for example: C:\wsdl

4. Copy the WSDL file of the Web Service that you want to stub into the same temporary directory for example: C:\wsdl

Back to top

Preparation of the stub with IBM Rational Service Tester or with IBM Rational Performance Tester SOA Extension

The section demonstrates how to stub the call to the Web Service proxy.provideQuotation1 in Rational Service Tester because the associated java code has not been implemented yet.

Project creation on RST or RPT SOA extension

1. Start Rational Service Tester or Rational Performance Tester with the SOA extension.
2. Start > All Programs > IBM Software Delivery Platform > IBM Rational Service Tester > IBM Rational Service Tester – Full Eclipse

3. Create a service test project
   File > New > Service Test Project

4. Click Finish.
5. At this point, Cancel the creation of a new test from recording.

Creation of a stub for Quotation Web Service

Now it is required to write the stub of the Web ServiceQuotation1 to simulate the behaviour of the operation ProvideQuotation1

1. Click on Create a Service Stub icon

2. Then click the Import From File button.

3. Select the WSDL file from the temporary directory, for example: c:\wsdl\Quotation1.wsdl

4. Click OK.

5. Then click Next.

6. Click Finish.
7. Now, we will specify the behaviour of the stub: Specify the default stub response of quote to -1.0

8. Define a new stub Equals Case:
   • Right-click DefaultCase and select Insert > Stub Equals Case.

In the Body of the request set the following values by selecting stub case name=Equals case:

market_place = New York
metal_name = gold

In the response, select the ProvideQuotation1 parameter of the equal case and set it to 100.0

9. Create another equal case with the following values:
   market_place=Paris
   metal_name=gold
   For this input, set the response to 105.0
   You should have the stub behaviour set as follows:

10. Save the stub.

Starting the local stub server

1. Click on Deploy button in the stub editor.

2. This creates a stub server on the local machine. Start the stub on the local machine by clicking the green arrow button

3. In the stub monitor view, copy the URL of the WSDL of the Quotation1_Stub1 Web Service. You can import this WSDL into the Generic Service Client to test the stub.

Testing the locally deployed stub with the Generic Service Client

1. Click the Generic Service Client (GSC) icon

2. Click on Add WSDL file
   Select Import from URL.

3. Paste the URL of the WSDL file copied from the stub monitor view.

4. Click OK.
5. Test the default case
   
   Keep the default value for market_place and metal_name and click the Invoke button.

6. Check that the response is –1.0

7. Test the values New York gold
   Click the Edit Data button
   Set market_place to New York
   Set metal_name to gold
   Click Invoke
   Check that the response is 100.0
8. Test the values: Paris, gold
   Click the Edit Data button
   Set market_place to Paris
   Set metal_name to gold
   Click Invoke
   Check that the response is 105.0

Get the deployed QuotationInvoker Web Service WSDL file from the WebSphere Application Server 7.0 server

Before testing the Web Service invoker deployed on the WebSphere Application Server, you must get the associated/published QuotationInvokerWebServiceEAR WSDL file.

1. Open the administrative console of the WebSphere server: Start > All Programs > IBM WebSphere > Application Server 7.0 > Profiles > AppServ01 > Administrative console
   Extend Applications and Application Types nodes
   Select WebSphere enterprise applications
   Click on QuotationInvokerWebServiceEAR

2. Publish the WSDL file and copy it into the temporary folder, for example: c:\wsdl

Back to top

Testing the QuotationInvoker Web Service with Rational Service Tester or Rational Performance Tester SOA Extension

Test recording

1. In Rational Service Tester or Rational Performance Tester, click the New test from recording button.

2. Select the Web Service recording using Generic Service Client.

3. Click Next.
4. Select TestQuotation and keep the default test file name.

5. Click Next.
6. Select Accept and click Finish.

7. In the Generic Service Client, click the Add WSDL button.
8. Select Import from file and select the WSDL file that you exported from WebSphere: c:\wsdl\QuotationInvoker.wsdl

9. Click OK.
10. Specify the end point of the deployed stub. Copy it from the stub monitor view.

11. Paste into the endPparameter in the Generic Service Client.

12. Click Invoke.
13. You receive the response with the best quotation.

Paris has the best quotation value.

14. You can change the behaviour of the stub by updating the value return for Paris from 105.0 to 95.0
    To do this, open the stub behaviour and simply change the return value for Paris to 95.0 and save the stub. The stub is automatically redeployed with new behaviour.
    
    In the Generic Service Client click Invoke again.
    Now, the best quotation is for the New York market place.
    

15. Now, in the Call History list, delete the first call corresponding to the Paris best quotation response.

16. Click the Stop recording button

17. Answer Yes to open the generated test suite
18. Select the response for GetBestQuotation and add an equal verification point.

Executing the generated test suite

1. Click the Run button of the test suite or right click on the test suite and request a run. The test is executed

Generating a functional test report

1. You can request the generation of a functional test report of the previous execution. Right click the result and select Generate Functional Report.

2. Click Next.
3. Select, for example, Service Test – Full (XSL)

4. Click Finish.

The functional report is generated:

This report also includes test log data:

Resources

Learn

• Explore the Rational Performance Tester page on IBM developerWorks, for links to technical information for software developers and testers and to related IBM software.
  
  
• Explore the Rational Service Tester for SOA Quality on IBM developerWorks, for links to technical information for software developers and testers and to related IBM software.
  
  
• Rational Service Tester: http://www-01.ibm.com/software/awdtools/tester/service/.
  
  
• Learn about other applications in the IBM Rational Software Delivery Platform, including collaboration tools for parallel development and geographically dispersed teams, plus specialized software for architecture management, asset management, change and release management, integrated requirements management, process and portfolio management, and quality management.
  
  
• Visit the Rational software area on developerWorks, for technical resources and best practices for Rational Software Delivery Platform products.
  
  
• Learn about other applications in the IBM Rational Software Delivery Platform, including collaboration tools for parallel development and geographically dispersed teams, plus specialized software for architecture management, asset management, change and release management, integrated requirements management, process and portfolio management, and quality management.
  
  
• Learn more on the Rational Performance Tester product page.
  
  
• In the SOA and web services area on developerWorks, get the resources you need to advance your skills.
  
  
• Browse the technology bookstore for books on these and other technical topics.
  
  

Get products and technologies

• Download IBM product evaluation versions or explore the online trials in the IBM SOA Sandbox and get your hands on application development tools and middleware products from DB2®, Lotus®, Rational®, Tivoli®, and WebSphere®.
  
  

Discuss

• Check out developerWorks blogs and get involved in the developerWorks community.
  
  

About the author

Rate this article

Comments

Back to top

Table of contents

• Introduction
• Prerequisites
• Creation of two web services with Rational Application Developer
• Preparation of the stub with IBM Rational Service Tester or with IBM Rational Performance Tester SOA Extension
• Testing the QuotationInvoker Web Service with Rational Service Tester or Rational Performance Tester SOA Extension
• Resources
• About the author
• Comments

Next steps from IBM

• Try: Rational Application Developer for WebSphere Software
• Buy: Rational Application Developer for WebSphere Software

Dig deeper into SOA and Web services on developerWorks

Try IBM PureSystems. No charge.

Experience today!

---

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

Special offers