The JavaTM Web Services Tutorial
Home
TOC
PREV TOP NEXT

Running the Samples

The JAXM Reference Implementation (RI) is an implementation of the JAXM API plus an implementation of a messaging provider. The RI also includes basic implementations of ebXML and SOAP-RP profiles, which run on top of SOAP. When an enterprise shops for a messaging provider, one of the main considerations is which profiles the messaging provider supports.

The RI also provides some simple examples of JAXM applications that you can run and also a Provider Administration tool that makes it easy to configure the messaging provider.

Before running the samples that run in a container or using the Provider Administration tool, you need to start up Tomcat. These are the steps to follow:

  1. Type the following at the command line:
    Unix:
       cd $JWSDP_HOME/bin	
       startup.sh
     
    
    Windows:
       cd %JWSDP_HOME%\bin	
       startup.bat
     
    
  2. Open a browser window and set it to
       http://localhost:8080/index.html
     
    
  3. On the page that comes up, click on one of the sample programs listed. Then follow the instructions in the new window that comes up.

The Sample Programs

The sample programs illustrate various kinds of applications you can write with the JAXM API. Once Tomcat is running, you can run the following sample programs provided with the RI simply by setting your browser to the appropriate URL and following the instructions on the Web page that comes up. Note that the Simple and Translator examples log messages sent and received to the bin directory of your Java WSDP installation. These messages are the XML that is sent over the wire, which will be easier to understand after you have gone through the tutorial.

There are two other sample programs, jaxm-uddiping and jaxm-standalone, that do not run in Tomcat. To run them, go to the <JWSDP_HOME>/samples/jaxm directory, where you will find the directories uddiping and standalone. Each directory contains a README file that explains what to do.

The last part of the JAXM tutorial modifies the code in UddiPing.java and also explains in detail how to run it. You might find it more convenient to wait until you have reached that section before trying to run the jaxm-uddiping and jaxm-standalone samples.

The preceding list presented the sample applications according to what they do. You can also look at the sample applications as examples of the three possible types of JAXM clients:

The Provider Administration Tool

The Provider Administration tool makes it easy to configure a messaging provider. You will find a link to it on the same index.html page that has links to the samples. The Provider Administration tool requires a user name and password for authentication. To use it, follow these steps:

  1. Set your browser window to
       http://localhost:8080/index.html
     
    
  2. Click on the link "JAXM Provider Administration Tool". A window will come up with text boxes for your user name and password. Enter the same user name and password you supplied to the installation wizard when you installed this release of the Java WSDP.
  3. Follow the instructions given on the page that comes up.

The Provider Administration tool is normally used by System Administrators, but others may use it as well. Exploring this tool gives you more of an idea of what a messaging provider needs to know. The following list gives the ways you can use the tool to set the messaging provider's properties.

Home
TOC
PREV TOP NEXT