Sun Microsystems 5800 manual Java Client Application Deployment, Java API Packages

Java API

Updating Client View of the Schema

In the Java client API, the schema is fetched when the NameValueObjectArchive class is instantiated. If the schema has changed, the client application needs to create a new NameValueArchive. A local copy of the schema is used for some metadata operations.

Java Client Application Deployment

Java applications using the 5800 system Java API reference the honeycomb-client.jar library. You must include this library in your classpath when running your application. The 5800 system Java API was designed to run on Java v1.4, so you need to run your client applications with a Java environment of v1.4 or greater.

Java API

The 5800 system Java client library provides a simple way of communicating with 5800 system clusters. It provides programatic access to the 5800 system network protocol, which operates over HTTP. You can implement most applications using a handful of these classes, but access to “expert” features is also included.

This section discusses the following topics:

■“Java API Packages” on page 27

■“Java API Documentation” on page 27

■“Basic Concepts” on page 28

■“Key Classes” on page 28

■“NameValueObjectArchive Application Access” on page 30

Java API Packages

The Java API is implemented in two packages:

■com.sun.honeycomb.client

Provides the base classes required to interact with a 5800 system cluster.

■com.sun.honeycomb.common

Contains classes for server-side exceptions.

Java API Documentation

The Java API documentation (Javadoc) is located in the SDK java/doc/htdocs directory, and can be accessed using a browser.

Chapter 2 • Sun StorageTek 5800 System Java Client API 27