edu.ucsb.adl.middleware.rmi
Interface MetadataService

All Superinterfaces:

java.rmi.Remote

All Known Implementing Classes:

MetadataServiceImpl

public interface MetadataService

extends java.rmi.Remote

RMI interface to the ADL metadata service.

Version:

$Header: /export/home/gjanee/middleware/edu/ucsb/adl/middleware/rmi/RCS/MetadataService.java,v 1.3 2003/05/12 18:04:33 gjanee Exp $

$Log: MetadataService.java,v $ Revision 1.3 2003/05/12 18:04:33 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.

Revision 1.2 2001/08/01 18:00:28 gjanee
Added duplicate declarations for the metadata view codes so that RMI clients don't have to access the implementation class edu.ucsb.adl.middleware.MetadataService.

Revision 1.1 2001/02/16 00:15:00 gjanee
Initial revision

Author:

Greg Janée
Alexandria Digital Library

Method Summary

java.lang.String	performMetadataService(java.lang.String view, java.lang.String object) Performs the ADL metadata service.
java.lang.String[]	performViewsService(java.lang.String object) Returns the views supported by a holding within a collection.

Method Detail

performMetadataService

public java.lang.String performMetadataService(java.lang.String view,
                                               java.lang.String object)
                                        throws MiddlewareException,
                                               java.rmi.RemoteException

Performs the ADL metadata service.

Parameters:

view - The metadata view, e.g., "adl:bucket".

object - An object identifier, which should have the form "C:H" where C is the name of a collection (e.g., "adl_catalog") and H is a collection-specific holding identifier.

Returns:

An XML document that is well-formed and valid according to the appropriate DTD.

Throws:

BadRequestException - If any of the arguments is invalid.

NoAuthorizationException - If the request is valid but not allowed.

UnsupportedException - If the request is valid but not supported.

java.rmi.RemoteException - If an RMI error occurs.

InternalErrorException - If the request cannot otherwise be completed.

MiddlewareException

performViewsService

public java.lang.String[] performViewsService(java.lang.String object)
                                       throws MiddlewareException,
                                              java.rmi.RemoteException

Returns the views supported by a holding within a collection.

Parameters:

object - An object identifier, which should have the form "C:H" where C is the name of a collection (e.g., "adl_catalog") and H is a collection-specific holding identifier.

Returns:

The views supported by the holding. The list includes the three standard ADL views.

Throws:

BadRequestException - If object is invalid.

NoAuthorizationException - If the request is valid but not allowed.

java.rmi.RemoteException - If an RMI error occurs.

InternalErrorException - If the request cannot otherwise be completed.

MiddlewareException