fedora.oai
Interface OAIProvider

All Known Implementing Classes:

SampleOAIProvider

public interface OAIProvider

Title: OAIProvider.java

Description:

-----------------------------------------------------------------------------

License and Copyright: The contents of this file are subject to the Mozilla Public License Version 1.1 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at http://www.mozilla.org/MPL/.

Software distributed under the License is distributed on an "AS IS" basis, WITHOUT WARRANTY OF ANY KIND, either express or implied. See the License for the specific language governing rights and limitations under the License.

The entire file consists of original code. Copyright © 2002-2005 by The Rector and Visitors of the University of Virginia and Cornell University. All rights reserved.

-----------------------------------------------------------------------------

Version:

$Id: OAIProvider.java,v 1.9 2005/01/11 20:06:05 cwilper Exp $

Author:

cwilper@cs.cornell.edu

Method Summary

java.util.Set	getAdminEmails() Get the email addresses of administrators of the repository.
java.lang.String	getBaseURL() Get the HTTP endpoint for the OAI-PMH interface.
DateGranularitySupport	getDateGranularitySupport() Get the finest harvesting granularity supported by the repository.
DeletedRecordSupport	getDeletedRecordSupport() Get the manner in which the repository supports the notion of deleted records.
java.util.Set	getDescriptions() Get XML descriptions of the repository.
java.util.Date	getEarliestDatestamp() Get a Date (in UTC) that is the guaranteed lower limit of all datestamps recording changes, modifications, or deletions in the repository.
java.util.List	getHeaders(java.util.Date from, java.util.Date until, java.lang.String metadataPrefix, java.lang.String set) Just like getRecords, but returns Header objects.
java.util.List	getHeaders(java.lang.String resumptionToken) Get the remaining portion of a set of Headers.
long	getMaxHeaders() Get the maximum number of headers that are returned at a time.
long	getMaxRecords() Get the maximum number of records that are returned at a time.
long	getMaxSets() Get the maximum number of sets that are returned at a time.
java.util.Set	getMetadataFormats(java.lang.String id) Get the MetadataFormats supported across the repository or for an individual item in the repository.
java.lang.String	getProtocolVersion() Get the version of the OAI-PMH supported by the repository.
Record	getRecord(java.lang.String identifier, java.lang.String metadataPrefix) Get an individual metadata record from the repository.
java.util.List	getRecords(java.util.Date from, java.util.Date until, java.lang.String metadataPrefix, java.lang.String set) Get the Records in the repository matching the given criteria.
java.util.List	getRecords(java.lang.String resumptionToken) Get the remaining portion of a set of Records.
java.lang.String	getRepositoryName() Get a human readable name for the repository.
java.util.List	getSets() Get the setSpecs, setNames, and setDescriptions of sets in the repository.
java.util.List	getSets(java.lang.String resumptionToken) Get the remaining portion of a set of Sets.
java.util.Set	getSupportedCompressionEncodings() Get the compression encodings supported by the repository.

Method Detail

getRepositoryName

public java.lang.String getRepositoryName()
                                   throws RepositoryException

Get a human readable name for the repository.

Returns:

the repository name.

Throws:

RepositoryException - if an error has occurred.

getBaseURL

public java.lang.String getBaseURL()
                            throws RepositoryException

Get the HTTP endpoint for the OAI-PMH interface.

Returns:

the base URL.

Throws:

RepositoryException - if an error has occurred.

getProtocolVersion

public java.lang.String getProtocolVersion()
                                    throws RepositoryException

Get the version of the OAI-PMH supported by the repository.

Returns:

the protocol version number.

Throws:

RepositoryException - if an error has occurred.

getEarliestDatestamp

public java.util.Date getEarliestDatestamp()
                                    throws RepositoryException

Get a Date (in UTC) that is the guaranteed lower limit of all datestamps recording changes, modifications, or deletions in the repository. A repository must not use datestamps lower than this.

Returns:

the earliest datetime stamp.

Throws:

RepositoryException - if an error has occurred.

getDeletedRecordSupport

public DeletedRecordSupport getDeletedRecordSupport()
                                             throws RepositoryException

Get the manner in which the repository supports the notion of deleted records.

Returns:

manner in which repository supports the notion of deletion.

Throws:

RepositoryException - if an error has occurred.

getDateGranularitySupport

public DateGranularitySupport getDateGranularitySupport()
                                                 throws RepositoryException

Get the finest harvesting granularity supported by the repository.

Returns:

the finest harvesting granularity supported by the repository.

Throws:

RepositoryException - if an error has occurred.

getAdminEmails

public java.util.Set getAdminEmails()
                             throws RepositoryException

Get the email addresses of administrators of the repository. This set must contain at least one item.

Returns:

the email addresses of administrators of the repository.

Throws:

RepositoryException - if an error has occurred.

getSupportedCompressionEncodings

public java.util.Set getSupportedCompressionEncodings()
                                               throws RepositoryException

Get the compression encodings supported by the repository. This set may be empty. Recommended values are those in RFC 2616 Section 14.11

Returns:

the compression encodings supported by the repository.

Throws:

RepositoryException - if an error has occurred.

getDescriptions

public java.util.Set getDescriptions()
                              throws RepositoryException

Get XML descriptions of the repository. Each Set element must be a String containing a description according to some W3C schema, where the xsi:schemaLocation attribute is used on the root element. See http://www.openarchives.org/OAI/2.0/guidelines.htm for guidelines regarding these repository-level descriptions.

Returns:

XML descriptions of the repository.

Throws:

RepositoryException - if an error has occurred.

getRecord

public Record getRecord(java.lang.String identifier,
                        java.lang.String metadataPrefix)
                 throws CannotDisseminateFormatException,
                        IDDoesNotExistException,
                        RepositoryException

Get an individual metadata record from the repository.

Parameters:

identifier - the record identifier.

metadataPrefix - the metadata prefix identifier.

Returns:

an individual metadata record from the repository.

Throws:

CannotDisseminateFormatException

IDDoesNotExistException

RepositoryException - if an error has occurred.

getRecords

public java.util.List getRecords(java.util.Date from,
                                 java.util.Date until,
                                 java.lang.String metadataPrefix,
                                 java.lang.String set)
                          throws CannotDisseminateFormatException,
                                 NoRecordsMatchException,
                                 NoSetHierarchyException,
                                 RepositoryException

Get the Records in the repository matching the given criteria. Any of the arguments (except metadataPrefix) may be null, indicating "any". If the size of the returned list is over getMaxRecords(), the last element is a resumptionToken (a String) which can be used to get the rest of the list.

Parameters:

from - the beginning date of the date range.

until - the ending date of the date range.

metadataPrefix - the metadata prefix.

set - the set of criteria

Returns:

the Records in the repository matching the given criteria.

Throws:

CannotDisseminateFormatException

NoRecordsMatchException

NoSetHierarchyException

RepositoryException - if an error has occurred.

getRecords

public java.util.List getRecords(java.lang.String resumptionToken)
                          throws CannotDisseminateFormatException,
                                 NoRecordsMatchException,
                                 NoSetHierarchyException,
                                 BadResumptionTokenException,
                                 RepositoryException

Get the remaining portion of a set of Records. If the size of the returned list is over getMaxRecords(), the last element is another resumptionToken (a String) which can be used to get the rest of the list.

Parameters:

resumptionToken - a string that can be used to get the rest of the list.

Returns:

the remaining portion of a set of Records.

Throws:

CannotDisseminateFormatException

NoRecordsMatchException

NoSetHierarchyException

BadResumptionTokenException

RepositoryException - if an error has occurred.

getHeaders

public java.util.List getHeaders(java.util.Date from,
                                 java.util.Date until,
                                 java.lang.String metadataPrefix,
                                 java.lang.String set)
                          throws CannotDisseminateFormatException,
                                 NoRecordsMatchException,
                                 NoSetHierarchyException,
                                 RepositoryException

Just like getRecords, but returns Header objects. If the size of the returned list is over getMaxHeaders(), the last element is a resumptionToken (a String) which can be used to get the rest of the list.

Parameters:

from - the beginning date range.

until - the end of the date range.

metadataPrefix - the metadata prefix.

set - the set of criteria.

Returns:

the remaining portion of a set of Header objects.

Throws:

CannotDisseminateFormatException

NoRecordsMatchException

NoSetHierarchyException

RepositoryException - if an error has occurred.

getHeaders

public java.util.List getHeaders(java.lang.String resumptionToken)
                          throws CannotDisseminateFormatException,
                                 NoRecordsMatchException,
                                 NoSetHierarchyException,
                                 BadResumptionTokenException,
                                 RepositoryException

Get the remaining portion of a set of Headers. If the size of the returned list is over getMaxHeaders() the last element is another resumptionToken (a String) which can be used to get the rest of the list.

Parameters:

resumptionToken - a string that can be used to get the rest of the list.

Returns:

the remaining portion of a set of Headers.

Throws:

CannotDisseminateFormatException

NoRecordsMatchException

NoSetHierarchyException

BadResumptionTokenException

RepositoryException - if an error has occurred.

getSets

public java.util.List getSets()
                       throws NoSetHierarchyException,
                              RepositoryException

Get the setSpecs, setNames, and setDescriptions of sets in the repository. Each set has a setSpec, a name, and zero or more descriptions, held by a SetInfo object. If the size of the returned list is over getMaxSets(), the last element is a resumptionToken (a String) which can be used to get the rest of the list.

Returns:

the setSpecs, setNames, and setDescriptions of sets in the repository.

Throws:

NoSetHierarchyException

RepositoryException - if an error has occurred.

getSets

public java.util.List getSets(java.lang.String resumptionToken)
                       throws BadResumptionTokenException,
                              NoSetHierarchyException,
                              RepositoryException

Get the remaining portion of a set of Sets. If the size of the returned list is over getMaxSets(), the last element is another resumptionToken (a String) which can be used to get the rest of the list.

Parameters:

resumptionToken - a string that can be used to get the rest of the list.

Returns:

the remaining portion of a set of Sets.

Throws:

BadResumptionTokenException

NoSetHierarchyException

RepositoryException - if an error has occurred.

getMetadataFormats

public java.util.Set getMetadataFormats(java.lang.String id)
                                 throws IDDoesNotExistException,
                                        NoMetadataFormatsException,
                                        RepositoryException

Get the MetadataFormats supported across the repository or for an individual item in the repository.

Parameters:

id - The item identifier, or null, meaning "the entire repository"

Returns:

the set of metadata formats supported by the repository.

Throws:

IDDoesNotExistException

NoMetadataFormatsException

RepositoryException - if an error has occurred.

getMaxSets

public long getMaxSets()
                throws RepositoryException

Get the maximum number of sets that are returned at a time. A negative value signifies no maximum.

Returns:

the maximum number of sets that are returned at a time.

Throws:

RepositoryException - if an error has occurred.

getMaxRecords

public long getMaxRecords()
                   throws RepositoryException

Get the maximum number of records that are returned at a time. A negative value signifies no maximum.

Returns:

the maximum number of records that are returned at a time.

Throws:

RepositoryException - if an error has occurred.

getMaxHeaders

public long getMaxHeaders()
                   throws RepositoryException

Get the maximum number of headers that are returned at a time. A negative value signifies no maximum.

Returns:

the maximum number of headers that are returned at a time.

Throws:

RepositoryException - if an error has occurred.