MetadataDriver

Overview

Package

Class

Tree

Deprecated

Index

Help

PREV CLASS NEXT CLASS

FRAMES NO FRAMES

SUMMARY: NESTED | FIELD | CONSTR | METHOD

DETAIL: FIELD | CONSTR | METHOD

edu.ucsb.adl.middleware.rmi
Class MetadataDriver

java.lang.Object
  |
  +--edu.ucsb.adl.middleware.rmi.MetadataDriver

All Implemented Interfaces:: MetadataDriver

public final class MetadataDriver
extends java.lang.Object
implements MetadataDriver

Proxy driver for the ADL metadata service. This driver establishes an RMI connection to a remote middleware server and thereby provides access to a (single) remote collection. The remote collection name is renamed to the local collection name in returned metadata reports (well, in the standard ADL reports, anyway).

This class reads the following properties from the RMI proxy driver configuration file rmi-proxy-driver.conf. Property values may be indirectly specified using the notation @P where P is the name of another property (see ExtendedProperties for more information).

remote_collection_name: The name of the remote collection, e.g., "adl_catalog".
registry: The URL of the RMI registry to use, e.g., "rmi://piru.alexandria.ucsb.edu".
metadata.name: The RMI name of the remote metadata service, e.g., "/edu/ucsb/adl/middleware/rmi/MetadataService".

Version:

$Header: /export/home/gjanee/middleware/edu/ucsb/adl/middleware/rmi/RCS/MetadataDriver.java,v 1.7 2006/06/24 05:16:22 gjanee Exp $

$Log: MetadataDriver.java,v $ Revision 1.7 2006/06/24 05:16:22 gjanee
Added method createDriverInternal.

Revision 1.6 2004/09/23 18:15:51 gjanee
Rewrite to use classes edu.ucsb.adl.middleware.ExtendedProperties and edu.ucsb.adl.middleware.XmlUtils.

Revision 1.5 2004/03/05 23:39:38 gjanee
Added support for multiple middleware instances. A middleware instance is represented by a Global object that is tied to a main middleware configuration file. All service objects now maintain a reference to the appropriate Global object. Instance-wide variables formerly coded as class variables are now held by the Global object; various methods that return instance-wide variables now accept a Global object as an argument. The Global object is now passed to all service drivers.

Revision 1.4 2003/05/12 19:55:34 gjanee
Added support for arbitrary, per-collection and per-holding metadata views. Specifically, changed the view argument data type from an enumeration to a string. Added method performViewsService. Switched to the new identifier renamers that do not require DTD URLs.

Revision 1.3 2002/09/28 20:49:08 gjanee
Configuration file renames. Renamed the RMI proxy driver configuration file to rmi-proxy-driver.conf.

Revision 1.2 2001/08/20 17:56:12 gjanee
Switched to the new configuration file structure. In the new structure, an entirely collection-independent "main" configuration file refers to a directory of subdirectories, one subdirectory per collection; each subdirectory holds a collection-specific middleware configuration file in addition to any configuration files required by the collection driver.

Revision 1.1 2001/03/16 04:58:49 gjanee
Initial revision

Author:

Greg Janée
Alexandria Digital Library

Method Summary

static edu.ucsb.adl.middleware.rmi.MetadataDriver createDriver(edu.ucsb.adl.middleware.Global global, java.io.File directory, java.lang.String collection)
          Creates a MetadataDriver for a collection.

static edu.ucsb.adl.middleware.rmi.MetadataDriver createDriverInternal(edu.ucsb.adl.middleware.Global global, java.io.File directory, java.lang.String collection)
          Creates a MetadataDriver for a collection.

void destroy()
          Frees all resources held by the driver.

java.lang.String performMetadataService(java.lang.String view, java.lang.String collection, java.lang.String holding)
          Performs the ADL metadata service, i.e., returns a view of the metadata for a holding within the collection.

java.lang.String[] performViewsService(java.lang.String collection, java.lang.String holding)
          Returns a list of the views supported by a holding within the collection.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Method Detail

createDriver

public static edu.ucsb.adl.middleware.rmi.MetadataDriver createDriver(edu.ucsb.adl.middleware.Global global,
                                                                      java.io.File directory,
                                                                      java.lang.String collection)
                                                               throws InternalErrorException

Creates a MetadataDriver for a collection.

Parameters:: global - Unused.; directory - The pathname of the directory containing the RMI proxy driver configuration file.; collection - The name of the collection, e.g., "adl_catalog".
Returns:: A MetadataDriver.
Throws:: InternalErrorException - If any error is encountered.

createDriverInternal

public static edu.ucsb.adl.middleware.rmi.MetadataDriver createDriverInternal(edu.ucsb.adl.middleware.Global global,
                                                                              java.io.File directory,
                                                                              java.lang.String collection)
                                                                       throws InternalErrorException