JarCasting
MediaShelf fedora-client
A developer-friendly Java client for the Fedora Commons Repository REST API.
Create a new Fedora object as easily as:
ingest("test:pid").execute(client);
Or, to add a datastream:
File f = new File("/tmp/Hyperballad.mp3");
addDatastream("test:pid", "DS1").controlGroup("M").content(f).execute(client);
Optional properties are just that: optional. And when you do need one, it's clearly labeled rather than lost in an opaque series of null arguments. Compare:
addDatastream("test:pid", "DS2").controlGroup("M")
.dsLocation("http://localhost:8080/fedora/get/fedora-system:ContentModel-3.0/DC")
.mimeType("text/xml").execute(client);
with something like the following:
apim.addDatastream("test:pid", "DS3", null, null, true, "text/xml", null,
"http://localhost:8080/fedora/get/fedora-system:ContentModel-3.0/DC", "M",
"A", null, null, null);
For complete documentation see: http://mediashelf.github.com/fedora-client/
Requirements
- Fedora 3.5 or later (earlier 3.x versions should work as well, minus some features)
- Java 6
Installation
fedora-client is now available via Maven Central. As of version 0.1.8, fedora-client is provided as two artifacts:
- fedora-client-core, which supports Fedora's REST API and riSearch
- fedora-client-messaging, which supports Fedora's Messaging
Both artifacts are also available as -with-dependencies jars, which bundle their respective dependencies in a single jar for use with non-Maven projects.
Building from source
-
Download the source, e.g.
git clone git://github.com/mediashelf/fedora-client.git -
Build the project
cd fedora-client mvn installfedora-client ships with a number of integration tests and will automatically start and stop an instance of Fedora. Set the testing properties (e.g. port) in pom.xml, or to skip the integration tests entirely:
mvn install -DskipTests
License & Copyright
fedora-client is free software: you can redistribute it and/or modify it under the terms of the GNU Lesser General Public License as published by the Free Software Foundation, either version 3 of the License, or (at your option) any later version.
fedora-client is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU Lesser General Public License for more details.
You should have received a copy of the GNU Lesser General Public License along with fedora-client. If not, see http://www.gnu.org/licenses/.
Copyright © 2010-2012 MediaShelf
