# vCenter Single Sign On SDK: JAX-WS Samples Readme |
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.8. 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. ## 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.
Copyright © 2011-2016 VMware, Inc. All rights not expressly granted herein are reserved. | Last updated: 15 Nov 2016 | VMware Single Sign On SDK