fedora.server.oai
Class FedoraOAIProvider

java.lang.Object
  fedora.server.oai.FedoraOAIProvider

All Implemented Interfaces:

OAIProvider

public class FedoraOAIProvider
extends java.lang.Object
implements OAIProvider

Simple FieldSearch-based OAI provider.

Version:

$Id: FedoraOAIProvider.java 5220 2006-11-20 13:52:20Z cwilper $

Author:

cwilper@cs.cornell.edu

Constructor Summary

FedoraOAIProvider(java.lang.String repositoryName, java.lang.String repositoryDomainName, java.lang.String localname, java.lang.String relpath, java.util.Set adminEmails, java.util.Set friendBaseURLs, java.lang.String namespaceID, long maxSets, long maxRecords, long maxHeaders, FieldSearch fieldSearch)

Method Summary

java.util.Set	getAdminEmails() Get the email addresses of administrators of the repository.
java.lang.String	getBaseURL(java.lang.String protocol, java.lang.String port) 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.

Methods inherited from class java.lang.Object

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

Constructor Detail

FedoraOAIProvider

public FedoraOAIProvider(java.lang.String repositoryName,
                         java.lang.String repositoryDomainName,
                         java.lang.String localname,
                         java.lang.String relpath,
                         java.util.Set adminEmails,
                         java.util.Set friendBaseURLs,
                         java.lang.String namespaceID,
                         long maxSets,
                         long maxRecords,
                         long maxHeaders,
                         FieldSearch fieldSearch)

Method Detail

getRepositoryName

public java.lang.String getRepositoryName()

Description copied from interface: OAIProvider

Get a human readable name for the repository.

Specified by:

getRepositoryName in interface OAIProvider

Returns:

the repository name.

getBaseURL

public java.lang.String getBaseURL(java.lang.String protocol,
                                   java.lang.String port)

Description copied from interface: OAIProvider

Get the HTTP endpoint for the OAI-PMH interface.

Specified by:

getBaseURL in interface OAIProvider

Returns:

the base URL.

getProtocolVersion

public java.lang.String getProtocolVersion()

Description copied from interface: OAIProvider

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

Specified by:

getProtocolVersion in interface OAIProvider

Returns:

the protocol version number.

getEarliestDatestamp

public java.util.Date getEarliestDatestamp()

Description copied from interface: OAIProvider

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.

Specified by:

getEarliestDatestamp in interface OAIProvider

Returns:

the earliest datetime stamp.

getDeletedRecordSupport

public DeletedRecordSupport getDeletedRecordSupport()

Description copied from interface: OAIProvider

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

Specified by:

getDeletedRecordSupport in interface OAIProvider

Returns:

manner in which repository supports the notion of deletion.

getDateGranularitySupport

public DateGranularitySupport getDateGranularitySupport()

Description copied from interface: OAIProvider

Get the finest harvesting granularity supported by the repository.

Specified by:

getDateGranularitySupport in interface OAIProvider

Returns:

the finest harvesting granularity supported by the repository.

getAdminEmails

public java.util.Set getAdminEmails()

Description copied from interface: OAIProvider

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

Specified by:

getAdminEmails in interface OAIProvider

Returns:

the email addresses of administrators of the repository.

getSupportedCompressionEncodings

public java.util.Set getSupportedCompressionEncodings()

Description copied from interface: OAIProvider

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

Specified by:

getSupportedCompressionEncodings in interface OAIProvider

Returns:

the compression encodings supported by the repository.

getDescriptions

public java.util.Set getDescriptions()

Description copied from interface: OAIProvider

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.

Specified by:

getDescriptions in interface OAIProvider

Returns:

XML descriptions of the repository.

getRecord

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

Description copied from interface: OAIProvider

Get an individual metadata record from the repository.

Specified by:

getRecord in interface OAIProvider

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

Description copied from interface: OAIProvider

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.

Specified by:

getRecords in interface OAIProvider

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

Description copied from interface: OAIProvider

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.

Specified by:

getRecords in interface OAIProvider

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

Description copied from interface: OAIProvider

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.

Specified by:

getHeaders in interface OAIProvider

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

Description copied from interface: OAIProvider

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.

Specified by:

getHeaders in interface OAIProvider

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

Description copied from interface: OAIProvider

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.

Specified by:

getSets in interface OAIProvider

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

Description copied from interface: OAIProvider

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.

Specified by:

getSets in interface OAIProvider

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 NoMetadataFormatsException,
                                        IDDoesNotExistException,
                                        RepositoryException

Description copied from interface: OAIProvider

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

Specified by:

getMetadataFormats in interface OAIProvider

Parameters:

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

Returns:

the set of metadata formats supported by the repository.

Throws:

NoMetadataFormatsException

IDDoesNotExistException

RepositoryException - if an error has occurred.

getMaxSets

public long getMaxSets()
                throws RepositoryException

Description copied from interface: OAIProvider

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

Specified by:

getMaxSets in interface OAIProvider

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

Description copied from interface: OAIProvider

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

Specified by:

getMaxRecords in interface OAIProvider

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

Description copied from interface: OAIProvider

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

Specified by:

getMaxHeaders in interface OAIProvider

Returns:

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

Throws:

RepositoryException - if an error has occurred.