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.

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.

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.

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

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

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

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

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

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

]]>