OAI Provider for Fedora 4

Implements Open Archives Protocol Version 2.0 using Fedora 4 as the backend.

Implementation details

The OAI Provider exposes an endpoint at /oai which accepts OAI conforming HTTP requests. A Fedora object containing the set information is created at /oai/setspec. For Set creation an endpoint at /oai/sets is exposed which accepts HTTP POST requests containing serialized Set information adhering to the OAI schema.

The provider depends on the fcrepo-dc-generator for creating a default oai_dc responses.

For advanced use-cases the provider depends on links to FedoraBinary instances and OAI Set objects to generate OAI responses. A graph linking a Fedora Object to it's OAI metadata should look like this:

                                             +----------+
                                             | MyObject | 
                                             +----------+
                                             /          \
                                            /            \
                                 hasOaiMarc21Record   isPartOfOaiSet
                                          /                \
                                         /                  \
                               +----------------+      +----------+
                               | MyMarc21Binary |      |   MySet  |
                               +----------------+      +----------+

Additional Metadata record types

The oaiprovider supports oai_dc out if the box, but users are able to add their own metadata format definitions to oai.xml.

Installation

Currently installation involves copying files by hand to an exploded fcrepo4 web application

The following dependencies have to be copied to Fedora 4's lib directory

• JAX-B Implementation 2.2.7
• JAX-B Core 2.2.7

#> wget -P /path/to/fcrepo/WEB-INF/lib http://central.maven.org/maven2/com/sun/xml/bind/jaxb-impl/2.2.7/jaxb-impl-2.2.7.jar
#> wget -P /path/to/fcrepo/WEB-INF/lib http://central.maven.org/maven2/com/sun/xml/bind/jaxb-core/2.2.7/jaxb-core-2.2.7.jar

Build and copy the oai provider to the Fedora 4's lib directory

#> git clone https://github.com/fcrepo4-labs/fcrepo4-oaiprovider.git
#> cd fcrepo4-oaiprovider
#> mvn package
#> cp target/fcrepo-oaiprovider-4.0.0-beta-04-SNAPSHOT.jar /path/to/fcrepo/WEB-INF/lib/

To overwrite defaults, optionally copy the oai.xml Spring configuration to Fedora 4's config directory

#> cp fcrepo4-oaiprovider/src/main/resources/spring/oai.xml /path/to/fcrepo/WEB-INF/classes/spring/

Add <import resource="classpath:/spring/oai.xml"/> to Fedora 4's master.xml configuration file

#> vim /path/to/fcrepo/WEB-INF/classes/spring/master.xml

After restarting Fedora 4 the OAI Provider is available at /oai

Example

In order to get some results, a couple of objects can be created:

#> curl -X POST http://localhost:8080/fcrepo/rest -H "Slug:foo""
#> curl -X POST http://localhost:8080/fcrepo/rest -H "Slug:bar""

Try the various responses from the oai provider:

#> curl http://localhost:8080/fcrepo/rest/oai?verb=ListMetadataFormats
#> curl "http://localhost:8080/fcrepo/rest/oai?verb=GetRecord&identifier=MyObject&metadataPrefix=oai_dc"
#> curl "http://localhost:8080/fcrepo/rest/oai?verb=ListRecords&metadataPrefix=oai_dc"
#> curl "http://localhost:8080/fcrepo/rest/oai?verb=ListIdentifiers&metadataPrefix=oai_dc"
#> curl "http://localhost:8080/fcrepo/rest/oai?verb=ListSets"
#> curl "http://localhost:8080/fcrepo/rest/oai?verb=ListIdentifiers&metadataPrefix=oai_dc&set=MyOAISet"

More examples can be found in Integration Tests