vCenter Single Sign On SDK: JAX-WS Samples Readme

  Readme for the vSphere Management SDK

This document describes how to run the VMware sample code that uses the JAX-WS bindings for the vCenter Single Sign On API. The samples have been developed to work with the JAX-WS bundled with the JDK 1.6. They are located in sub-directories contained in the following vSphere Management SDK directory:

    SDK/sso/java/JAXWS/samples/com/vmware/sso/client/

The following sections contain information about building and running the JAX-WS vSphere API samples.

• JAVAHOME Environment Variable
• Converting Shell Scripts for Linux
• Samples usage
• Generating Stubs from WSDL

JAVAHOME Environment Variable

You must set the JAVAHOME environment variable to the base directory of a JDK 1.6, preferably b22.

Converting Shell Scripts for Linux

The vCenter Single Sign On SDK includes the following shell scripts in the SDK/sso/java/JAXWS/ directory.

• run.sh - Runs a sample in linux.
• run.bat - Runs a sample in windows.

The shell files in the distribution kit have DOS-style line endings. These do not work when running these scripts on Linux. Use the Linux command dos2unix to convert these files before you use them.

To run these scripts, set the Execute permission on the files:

    chmod u+awx *.sh

Samples usage

All samples print a usage summary if you do not specify any options or if you specify --help on the command line.

You can also find usage information for all samples in the JAX-WS Samples Reference Documentation. Each package has a class summary that describes one or more samples.

Generating Stubs from WSDL and Compiling Samples

The following version of tools are required in order to generate the stubs from the provided WSDL.

• JDK 1.6
• JAX-WS 2.2 API

Note that JDK 1.6 includes the JAX-WS 2.1 API. It does not include the JAX-WS 2.2 API which is required to generate stubs. For information about using JAX-WS 2.2 with JDK 1.6, see the following guides:

• Metro Guide - Using JAX-WS 2.x / Metro 1.x/2.0 with Java SE 6
• Unofficial JAXB Guide - Migrating JAXB 2.0 applications to JavaSE 6

You can generate the JAXWS stubs from the shipped WSDL by using the wsimport tool. After the stubs have been generated, you can compile the shipped samples by adding these stubs to the classpath.