1
About the vCloud SDK for Java
The VMware vCloud API provides support for developers who are building interactive clients of VMware
Cloud Director using a RESTful application development style. vCloud API clients and servers communicate
over HTTP, exchanging representations of vCloud objects. These representations take the form of XML
elements. HTTP GET requests are used to retrieve the current representation of an object, HTTP POST and
PUT requests are used to create or modify an object, and HTTP DELETE requests are typically used to delete
an object.
The vCloud SDK for Java is a Java language binding for the vCloud API. It uses the JAXB framework to create
Java classes for the resources defined in the vCloud API XML schemas. The vCloud SDK for Java provides
classes and methods that encapsulate the interfaces, objects, and operations supported by the vCloud API
while preserving its RESTful programming style and compatibility with the HTTP protocol family.
This vCloud SDK for Java Developer's Guide provides information about setting up the SDK in a development
environment, and information about running the sample applications included in the SDK.
This chapter includes these topics:
"vCloud SDK for Java Design" on page 7
"vCloud Object Taxonomy" on page 7
vCloud SDK for Java Design
The vCloud SDK for Java provides object‐specific methods for creating, updating, retrieving, and deleting
objects defined by the vCloud API. It also includes wrapper classes that provide:
Helpers for REST communication and Java object representation of the XML resources defined by the
vCloud API.
Helper methods that can assist in client development
Every wrapper class has methods that access vCloud API resources using a reference. A reference object
contains the href, resource type, and name properties. Static methods get resources directly by passing the
reference, and act as constructors or factories for SDK wrapper objects.
N
The vCloud SDK for Java does not provide object lifecycle management. Every wrapper object
OTE
represents the resource at the time of the GET operation. If a client makes multiple GET requests for the same
resource, the client receives multiple representations of the resource wrapped in the helper object. There is no
automatic refresh of the client‐side representation. It is the client's responsibility to make new requests to get
the latest values. To avoid memory leaks, the client must dispose of objects that are not in use.
vCloud Object Taxonomy
The vCloud SDK for Java defines a set of objects common to cloud computing environments. Figure
illustrates the principal object types.
VMware, Inc.
1
1‐1
7