20 JSR 172: Web Services Support

20.1 Generating Stub Files from WSDL Descriptors

The NetBeans IDE provides a stub generator that automates creating source code for accessing web services that conform to the J2ME Web Services Specification. You can add stubs to any MIDP application.

The following is a general procedure for adding stubs:

1. In the Projects window, expand the tree for a project.

2. Launch the Java ME Web Service Client wizard:

   Right-click on the Source Packages node and select New > Java ME Web Service Client...

3. In the New Java ME Webservice Client page, you can either:

   • Click "Running Web Service and enter the URL for the WSDL", then click Retrieve WSDL.

     Or,

   • Click "Specify the Local filename for the retrieved WSDL" and browse to a file on your system.

   In either case, you must enter a Package name (if it is not supplied), then click Finish. The new package appears in the project and includes an interface file and a stub file.

4. You can now edit your source files to call the content the stub provides, then build and run.

   See Section 20.2, "Creating a New Mobile Web Service Client" for a step by step process, or see Section 20.3, "Run JSR172Demo" and view the demo source files.

20.2 Creating a New Mobile Web Service Client

This sample procedure creates a new project and adds a web service client. However, you can add a web service client to any MIDP project, it does not have to be new.

If you are using a proxy server, you must configure the emulator's proxy server settings as described in Section 3.5, "Configuring the Web Browser and Proxy Settings".

1. Select File > New Project, choose the Java ME category, and the Mobile Application project type, and click Next.

   
   Description of the illustration wsc-proj.gif
   
   

2. Name your project and ensure Create Hello MIDlet is checked. Click Next.

   
   Description of the illustration wsc-nameloc.gif
   
   

3. Ensure that SDK 3.2 is the platform and choose a device. Click Next.

   
   Description of the illustration wsc-plat.gif
   
   

4. Right-click on the Source Packages node and select New > Java ME Web Service Client...

   
   Description of the illustration wsc-new-wsc.gif
   
   

5. In the New Java ME Webservice Client page:

   • Click Running Web Service and in the WSDL URL field, enter:

     http://www.xmlme.com/WSShakespeare.asmx?WSDL

     Click Retrieve WSDL.

   • The Package name is wsshakespeare.

   Click Finish.

   
   Description of the illustration wsc-cli-info.gif
   
   

   The new package appears in the Source Packages tree and includes Shakespeare.java and Shakespeare_Stub.java.

6. Edit HelloMIDlet.java as follows:

   • At the beginning, replace the default import declarations with:

     import javax.microedition.lcdui.*;
     import javax.microedition.midlet.*;
     import wsshakespeare.*; 
     

   • Locate the startApp() method and replace its contents with the following code:

     String text;Shakespeare s = new Shakespeare_Stub(); try {     text = s.getSpeech("Romeo"); } catch (java.rmi.RemoteException rex) {     text = "error";     System.out.println(rex.getMessage()); } TextBox t = new TextBox("Hello", text, 2048, 0); final Command exitCommand = new Command("Exit", Command.EXIT, 1); t.addCommand(exitCommand); t.setCommandListener(new CommandListener() {     public void commandAction(Command c, Displayable d) {       if (c == exitCommand) {    notifyDestroyed();       }     } }); Display.getDisplay(this).setCurrent(t);
     

7. Build and run the project. You see a quote from Shakespeare's Romeo and Juliet on the device screen.

   You can vary the above procedure to use a local WSDL file. Open the following web page in a browser:

   http://www.xmlme.com/WSShakespeare.asmx?WSDL

   Save it to a local file. For example, C:\ws\WSShakespeare.wsdl. Follow the procedure above, except at Step 4, specify the local file name.

20.3 Run JSR172Demo

JSR172Demo shows how to access a web service from a MIDlet. The web service in this demo is running on an Internet server, and it conforms to the J2ME Web Services Specification. The client is the MIDlet running in the emulator

If you are using a proxy server, you must configure the emulator's proxy server settings as described in Section 3.5, "Configuring the Web Browser and Proxy Settings".

Set Up the GlassFish Server

This demo requires the Oracle GlassFish server.

• If you installed a full version of NetBeans you probably have a GlassFish installation. Choose Tools > Servers and choose Glassfish to view the defaults.

• If you do not have Glassfish, it can be downloaded from:

  http://www.oracle.com/technetwork/java/javaee/downloads

Set Up Environment Variables

Set the following environment variables:

JAVA_HOME=Java-installation-path

GLASSFISH_HOME=GlassFish-installation-path

Run the Demo Scripts

The scripts in the \server subdirectory assume that your server has a domain named "domain1" in which the service is automatically deployed. If you do not have a domain named domain1, set up this domain or edit run.bat and specify a domain you already have. Run the scripts:

demo_directory\JSR172Demo\server\build.bat

demo_directory\JSR172Demo\server\run.bat

Verify the Web Service

• Start the Glassfish service.

• In a browser, open the following URL:

  http://localhost:8080/serverscript/serverscript

You see a page titled Web Services that displays information about the service including links to the WSDL file corresponding to the localhost url.

Run the MIDlet in the Emulator

JSR172Demo contains a single MIDlet named Server Script. Launch it and follow the prompts. You can browse through fictitious news headlines, all of which are retrieved from the web service.