SPASE Registry Server

The SPASE Registry Server is a web application written in Java which providers resolver, search, render and download services for SPASE XML resource descriptions. It can also chain to other registry servers and aggregate all results, returning all matches in a self-organized network of registry servers.

Try the demonstration registry server.

The Registry Framework is depicted in the figure to right. The metadata which is accessible from the services is stored in the local file system. It can be managed by a revision control system such as "git". There may also be some process that synchronizes the local instances of the metadata. This is external and independent of the registry services.

The registry services then access the metadata to fulfill requests. For example, the "resolver" will locate a resource description in the metadata that matches a given resource ID. The "status" service can report on the contents of the metadata repository. Other services rely on the "resolver" service to fulfill requests. These include "downloader" which will retrieve data described by a resource description, "render" which prepares a resource description stored as XML for viewing in a web browser, and "explorer" which allows tree based navigation of the metadata respository.

The complete list of available services includes:

Download: Retrieve and package all the source files associated with a resource.
Explorer: A graphical tree based interface to the registries.
Connect: A graphical map of connections (associations) between resource descriptions.
Render: Render a resource using a stylesheet.
Resolver: Retrieve a resource description for a given resource ID or generates a list of resources matching a partial resource ID.
Search: Scan a registry for resources containing one or more words.
Status: Retrieve information about a registry.

Most services can also be run from the command-line.

Installation

The Registry Server is packaged as a Web Application which can be installed on an application server such as Tomcat. The steps are:

  1. Download spase-registry-1.2.8.war
  2. Place the "war" file in the web apps folder on your server
The services will be available at the path "/spase-registry-1.2.8" (or whatever name you give the ".war" file).

If you don't have an application server or would like to try the registry servers in a testing environment the SPASE Collection contains the Registry Server in a pre-configured Jetty server which can be run on any system with Java installed.

A bare Jetty server is also available which can be upacked and the "war" file can be installed.

Configuration

The resolver service locates resource descriptions by mapping the "authority" portion of a Resource ID to a location in the local files system, then using the path portion of the resource ID to locate the resource description. The "collator" tool in the Resource Tools can be used to organize a collection of resource descriptions consistant with the requirements for the resolver service.

The authorities known to the services are set in the the "authority.conf" file located in the WEB-INF/conf folder. Each line in an "authority.conf" maps an authority name to a local file system path to the metadata. The format is "authority name <Tab> path". A path that begins with a "." is relative to the installation of the registry server. Lines beginning with a "#" are considered comments and ignored.

An "authority.conf" looks something like:

# Authority name path list
# Maps authority names to local paths
# Relative paths begin with a dot (.) and
# are relative to the service instance (root of webapp)
Example	./metadata/Example

Documentation

On-line class descriptions for the registry server.

Services

Individual services in the Registry Services Package.

Resolver

The resolver service is the central service for the Registery Server. All other services, with the exception of search call the resolver to obtain metadata.

A detail description of each service follows:

Download

Obtains a list of URLs associated with a resource by quering a registry server, then downloads and packages all the source files. The collection of files is packaged into a zip file and written to the output stream.

Registry Explorer

A graphical tree based interface to the registries. The application calls the "resolver" service to populate and navigate through the tree.

Try the Registry Explorer.

Connection Map

A graphical map of connections (associations) between resource descriptions.
Options:

  • id: The resource ID of the starting node. This can be a partial ID (leading path).
  • x: The number of connecting nodes to display. Default: 1
The application calls the "resolver" service to generate and navigate through the map.

Try the Connection Map.

Render

Render a resource using a stylesheet.

Resolver

Resolver retrieves a resource description for a given resource ID or generates a list of resources at a given partial reosurce ID location. Scan a registry for resources containing one or more words.

Status

Status retrieves information about a registry.

Command-line Examples: