2
Setting Up for Java Development
This chapter includes these topics:
"Prerequisites" on page 11
"Download the vCloud SDK for Java Package" on page 11
Prerequisites
The vCloud SDK for Java requires JDK 6 or later (the SDK and samples were developed using JDK
1.6.0_14‐b08). This document and the SDK reference documentation assume that you are familiar with the Java
programming language and have access to an installation of VMware Cloud Director.
In addition, you should consider the following:
Although the vCloud SDK for Java javadoc provides information about the vCloud API XML schemas,
which define the objects and operations that the SDK supports, familiarity with the details of the
underlying objects and operations, as described in the vCloud API Programming Guide, can help you
understand the structure of vCloud API objects, and how the methods in this SDK operate on those
objects.
Before you can run the samples, you must use the Cloud Director web console or the vCloud API to create
an organization, catalog, and vDC that the samples can use. The organization must have a user account
with rights to run the samples. The predefined role CatalogAuthor should provide all the necessary
rights. For more information about roles and rights, see the VMware Cloud Director Administratorʹs Guide.
Several of the sample programs, including HellovCloud.java, require you to have an OVF package
available on the client host. This package must be uncompressed, and must specify a single vmdk file. For
more information about OVF, see the vCloud API Programming Guide.
Download the vCloud SDK for Java Package
The vCloud SDK for Java is distributed as a zipped archive. Unzipped, it requires about 14.1 MB of disk space.
The package includes the following files:
The SDK package includes precompiled client‐side libraries (vcloud-java-sdk-1.0.jar,
rest-api-schemas-1.0.0.jar). The vcloud-java-sdk-1.0.jar file contains the vCloud Java SDK
classes and methods. The rest-api-schemas-1.0.0.jar file contains JAXB‐based Java classes for the
resources defined in the vCloud API.
Sample code (vcloud-java-sdk-samples-1.0-sources.jar) demonstrating common use cases
associated with programmatically managing virtual infrastructure. The samples include Java source code,
compiled Java class files, and text examples of program inputs and outputs.
VMware, Inc.
2
11