Core Client Developer Kit

This project assembles a Client Developer Kit (CDK) for developers that wish to interact with the core Astrogrid services (Myspace / VoSpace, Registry, Community).

It contains the necessary delegate jars, plus their dependencies, and example configuration.

Store Clients

The astrogrid store is a distributed networked storage system (link to design docs) Project page There are two ways that a client can interact with a store.

Myspace Tree Model

This interface creates an abstraction similar to the java.io.File class - each file and folder in the store is represented as an object in a tree, which the client code can traverse and manipulate. org.astrogrid.store.tree (javadoc)

NB this interface is a renamed copy of the classes in org.astrogrid.store.adapter.aladin which is still available, but has been deprecated. All clients should transfer to org.astrogrid.store.tree.

Vospace Client

This is a lower-level interface that allows access to a single store location, but no traversal of the store structure. Javadoc

Registry Client

The registry is an xml database containing documents that conform to the VOResource schema (link to design docs). Two clients are provided - one for performing queries, the other for admin / modification of the registry. Both are accessible from the RegistryDelegateFactory. Project page, Javadoc

Community

The community service manages user accounts, authentication and permissions. (need more info here). Project Page

Common Classes

Some common classes (such as Ivorn and User) are defined in a separaete project Project page, Javadoc

Configuration

All astrogrid components use a common configuration system. This allows properties to be set using either JNDI (if available), a configuration file, or System properties. The simplest method is to have a file named astrogrid.properties on the classpath. See the javadoc for further details. This CDK requires the following keys to be set:

org.astrogrid.community.ident
The identifier of the local community. For example org.astrogrid.release
org.astrogrid.registry.query.endpoint
Endpoint of the registry query service. For example http://katatjuta.star.le.ac.uk:8080/astrogrid-registry-SNAPSHOT/services/RegistryQuery
org.astrogrid.registry.admin.endpoint
Endpoint of the registry admin service. For example http://katatjuta.star.le.ac.uk:8080/astrogrid-registry-SNAPSHOT/services/RegistryAdmin
org.astrogrid.community.default.vospace
Registry key for default myspace service for this community. E.g. ivo://org.astrogrid.release/myspace

Development

It's possible to deploy a mini-astrogrid (Astrogrid in a Box) to a single machine. This provides a convenient target to test clients against. Installation Instructions