Sun Microsystems Sun StorageTek 5800 - Manual (Page 27)

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.
Java API
Chapter 2 • Sun StorageTek 5800 System Java Client API 27