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 JAXWS bundled in libs/JAXWS-RI 2.3.3. 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 11

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 JAXWS-RI 2.3.3 is required to generate the stubs from the provided WSDL.

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