Tutorial: Web Service Client

Introduction

This tutorial shows how to generate the Web Service Clients needed to use the playground web service interfaces. This is an alternative to downloading playground.jar as mentioned in the other tutorials. The tutorial shows how to create the stubs for the send SMS Parlay X web service. Creating stubs for the other playground assets is done in the exact same way - however, using a different URL. The URL to the other playground WSDL files will be provided in the playgronud Lab introductory email which you will receive when your access to the Lab is approved. As a prerequisite we assume that you are familiar with the following technologies:

  • HTML
  • XML, SOAP and Web Services
  • Eclipse - as an environment for Java and web service development
  • Java, inclusive basic HTTP/URL handling
  • SMS messaging

Follow the steps below to create a client which invokes the SendSms web service.

Place the cursor over this icon to expand screenshots from Eclipse.

  1. Download and install the Eclipse IDE (Web Tools Platform).
  2. Create a new project by selecting File | New | Java Project from the menu bar. This initiates the "New Java Project" wizard.
  3. Give the project a name, and choose your preferences on Java version and project organization. In this tutorial, we named the project "Playground Services". The default values are used for all other selections.
  4. Push "Finish" to continue and close the wizard. The project is created, and the next steps describe how to start adding the required content to your project.
  5. Next, generate a web service client by selecting File | New | Other | Web Service Client from the menu bar. Click "Next" to initiates the "Web Service Client" wizard. ;
  6. Paste the link to the service definition (for send SMS: http://playgroundlab.telenor.com:9032/ParlayXSendSms_0_2v1_WS?WSDL), and choose "Develop Client". The default values are used for all other selections. Press "Finish" to generate the stubs for the send SMS Parlay X web service
  7. You can now see the stubs in the eclipse package explorer, the stubs you get from send SMS Parlay X web service are marked in a light blue color. If you generate stubs for all the Playground assets you get a list similar to the one shown here: