Page History

...

This document will walk you through getting the code, building the webapp, and exercising the REST API.

Prerequisites

Fedora 4 requires Java 7 8 and Maven 3 (only for building the project). Check that you have them installed before proceeding:

...

And build the project (the first time you build Fedora 4 may take some time and bandwidth to download all the development dependencies):

...

The webapp can be run from a bundled instance of jetty. The application will listen on port 8080 by default.
If you would like to run the webapp on a different port, you can add the "jetty.port" option in your maven command (e.g. mvn -Djetty.port=8181 jetty:run)

Code Block

$ cd fcrepo-webapp
$ MAVEN_OPTS="-Xmx512m" mvn jetty:run
[...]
TRACE 10:50:43.845 (SessionProvider) Returning new InjectableSession...
DEBUG 10:50:43.845 (InjectableSession) Initializing an InjectableSession with SessionFactory org.fcrepo.session.SessionFactory@5a3c8525.
TRACE 10:50:43.846 (SessionProvider) Returning new InjectableSession...
DEBUG 10:50:43.846 (InjectableSession) Initializing an InjectableSession with SessionFactory org.fcrepo.session.SessionFactory@5a3c8525.
2013-07-01 10:50:44.027:INFO:oejs.AbstractConnector:Started SelectChannelConnector@0.0.0.0:8080
[INFO] Started Jetty Server
[INFO] Starting scanner at interval of 2 seconds.

There's a nice, friendly HTML interface waiting for you at http://localhost:8080/rest/

REST API Examples

The REST API documentation provides a full listing of the features and functions of the REST API. Here are some examples to get you started:

Code Block

$ curl "http://localhost:8080/rest/"
@prefix dcpremis:    <http://purlwww.loc.orggov/dcpremis/termsrdf/>v1#> .
@prefix nttest:  <info:fedora/test/> .
@prefix memento:  <http://wwwmementoweb.jcp.org/jcr/nt/1.0>ns#> .
@prefix foafrdfs:  <http://xmlnswww.w3.comorg/foaf2000/0.1/>01/rdf-schema#> .
@prefix testwebac:  <info<http://fedora.info/definitions/testv4/>webac#> .
@prefix fedora-internalacl:  <info:fedora/fedora-system:def/internal#><http://www.w3.org/ns/auth/acl#> .
@prefix imagens001:  <http://www.modeshape.org/images/1.0>localhost:8080/rest/ktest/> .
@prefix xsxsi:    <http://www.w3.org/2001/XMLSchema>XMLSchema-instance> .
@prefix xmlxmlns:   <http://www.w3.org/XML2000/1998xmlns/namespace>> .
@prefix fedorarelsextrdf:  <info:fedora/fedora-system:def/relations-external#><http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix mixfedora:   <http://wwwfedora.jcp.orginfo/jcrdefinitions/mixv4/1.0>repository#> .
@prefix modexml:  <http://www.modeshapew3.org/1.0>XML/1998/namespace> .
@prefix svebucore:    <http://www.jcpebu.orgch/metadata/jcrontologies/svebucore/1.0>ebucore#> .
@prefix xsildp:   <http://www.w3.org/2001ns/XMLSchema-instance>ldp#> .
@prefix fedoraxs: <info:fedora/> .
<http://localhost:8080/rest/>
        www.w3.org/2001/XMLSchema> .
@prefix fedoraconfig:  <http://microformatsfedora.orginfo/definitions/wiki/rel-sitemap>
                v4/config#> .
@prefix foaf:  <http://xmlns.com/foaf/0.1/> .
@prefix dc:  <http://purl.org/dc/elements/1.1/> .

<http://localhost:8080/rest/sitemap> ;>
        <http://www.whatwg.org/specs/web-apps/current-work/#link-type-search>
fedora:lastModified            "2018-05-30T20:51:11.833Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ;
        <http://localhost:8080/rest/fcr:search> ;
rdf:type         fedora:exportsAs                <http://localhost:8080/rest//fcr:export?format=jcr/xml> ldp:RDFSource ;
        fedora-internal:clusterCacheMode
  rdf:type              "LOCAL" ;
        fedora-internalldp:clusterMembersContainer  "local" ;
        fedora-internalrdf:clusterNametype     "ISPN" ;
        fedora-internal:clusterNodeAddress
         ldp:BasicContainer ;
        fedora:writable            "local"    true ;
        fedora-internal:clusterNodeView
rdf:type                       "Unknown"fedora:RepositoryRoot ;
        fedora-internal:clusterPhysicalAddress
...

The REST API supports a variety of RDF serialization formats, including:

Code Block

$ curl http://localhost:8080/rest/ -H "Accept: application/rdf+xml"
<rdf:RDF
rdf:type                       xmlns:fedora="info:fedora/"
:Resource ;
     xmlns:fedora-internal="info:fedora/fedora-system:def/internal#"   rdf:type                       fedora:Container ;
    xmlns:image="http://www.modeshape.org/images/1.0"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xmlns:mix="http://www.jcp.org/jcr/mix/1.0"
ldp:contains                   xmlns:test="info:fedora/test/"<http://localhost:8080/rest/ktest> ;
    xmlns:fedorarelsext="info:fedora/fedora-system:def/relations-external#"
    ldp:contains                   xmlns:nt="http://www.jcp.org/jcr/nt/1.0"<http://localhost:8080/rest/91/86/4c/e0/91864ce0-9ad2-49cd-b2c3-85b0c6b204e5> ;
        ldp:contains                   <http://localhost:8080/rest/examples> ;
        ldp:contains                   <http://localhost:8080/rest/t1> ;
        fedora:hasTransactionProvider  <http://localhost:8080/rest/fcr:tx> .

The REST API supports a variety of RDF serialization formats, including:

Code Block

$ curl http://localhost:8080/rest/ -H "Accept: application/rdf+xml"
<rdf:RDF
xmlns:rdf="http://www.w3.org/1999/02/22-rdf-syntax-ns#"
    xmlns:foaf="http://xmlns.com/foaf/0.1/"
    xmlns:mode="http://www.modeshape.org/1.0"
    xmlns:j.0="info:fedora/fedora-system:def/internal#repository/"
    xmlns:xsrdf="http://www.w3.org/2001/XMLSchema1999/02/22-rdf-syntax-ns#"
    xmlns:j.1acl="http://microformatswww.w3.org/ns/wikiauth/acl#"
    xmlns:dcldp="http://purlwww.w3.org/dcns/terms/ldp#"
    xmlns:svxs="http://www.jcpw3.org/jcr/sv/1.02001/XMLSchema"
    xmlns:j.2rdfs="http://www.whatwgw3.org/specs2000/web-apps01/currentrdf-work/#schema#"
    xmlns:rdfswebac="http://wwwfedora.w3.orginfo/2000definitions/01v4/rdf-schema#webac#"
 > 
  <rdf:Description rdf:aboutxmlns:ns001="http://localhost:8080/rest//fcr:export?format=jcr/xml">ktest/"
    <rdfs:label>jcr/xml</rdfs:label>
  </rdf:Description>
  <rdf:Description rdf:aboutxmlns:dc="http://purl.org/dc/elements/1.1/"
    xmlns:ebucore="http://localhost:8080/rest/">www.ebu.ch/metadata/ontologies/ebucore/ebucore#"
    <fedora-internal:numberOfChildren rdf:datatypexmlns:premis="http://www.w3loc.orggov/premis/2001rdf/XMLSchema#long">0</fedora-internal:numberOfChildren>v1#"
    <fedora-internal:hasNodeType>nt:unstructured</fedora-internal:hasNodeType>xmlns:test="info:fedora/test/"
    <j.0:jcr.specification.version>2.0</j.0:jcr.specification.version>xmlns:fedora="http://fedora.info/definitions/v4/repository#"
    <j.0:option.unfiled.content.supported>false</j.0:option.unfiled.content.supported>xmlns:memento="http://mementoweb.org/ns#"
    <fedora-internal:clusterNodeAddress>local</fedora-internal:clusterNodeAddress>xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    <fedora-internal:hasNodeType>mix:referenceable</fedora-internal:hasNodeType>xmlns:foaf="http://xmlns.com/foaf/0.1/"
    <j.0:node.type.management.update.in.use.suported>true</j.0:node.type.management.update.in.use.suported>
    <j.0:query.xpath.doc.order>false</j.0:query.xpath.doc.order>
    <j.0:level.2.supported>true</j.0:level.2.supported>
    <fedora-internal:hasNodeType>nt:resource</fedora-internal:hasNodeType>
    <fedora-internal:hasNodeType>fedora:datastream</fedora-internal:hasNodeType>

or

Code Block

$ curl http://localhost:8080/rest/ -H "Accept: application/n-triples"
<httpxmlns:fedoraconfig="http://fedora.info/definitions/v4/config#" > 
  <rdf:Description rdf:about="http://localhost:8080/rest/">
    <rdf:type rdf:resource="http://fedora.info/definitions/v4/repository#Resource"/>
    <ldp:contains rdf:resource="http://localhost:8080/rest/examples"/>
    <ldp:contains rdf:resource="http://localhost:8080/rest/> <info:fedora/fedora-system:def/internal#numberOfChildren> "0"^^<http://www.w3.org/2001/XMLSchema#long> .
<http://localhost:8080/rest/> <info:fedora/fedora-system:def/internal#hasNodeType> "nt:unstructured" .
<http91/86/4c/e0/91864ce0-9ad2-49cd-b2c3-85b0c6b204e5"/>
    <fedora:hasTransactionProvider rdf:resource="http://localhost:8080/rest/fcr:tx"/>
 <info:fedora/fedora-system:def/internal#repository/jcr.specification.version> "2.0" .
<http   <ldp:contains rdf:resource="http://localhost:8080/rest/ktest"/> <info:fedora/fedora-system:def/internal#repository/option.unfiled.content.supported> "false" .
<http://localhost:8080/rest/> <info:fedora/fedora-system:def/internal#clusterNodeAddress> "local" .
<http://localhost:8080/rest/> <info:fedora/fedora-system:def/internal#hasNodeType> "mix:referenceable" .
<http://localhost:8080/rest/> <info:fedora/fedora-system:def/internal#repository/node.type.management.update.in.use.suported> "true" .
<http
    <fedora:lastModified rdf:datatype="http://www.w3.org/2001/XMLSchema#dateTime">2018-05-30T20:51:11.833Z</fedora:lastModified>
    <fedora:writable rdf:datatype="http://www.w3.org/2001/XMLSchema#boolean">true</fedora:writable>
    <rdf:type rdf:resource="http://www.w3.org/ns/ldp#RDFSource"/>
    <rdf:type rdf:resource="http://fedora.info/definitions/v4/repository#RepositoryRoot"/>
    <rdf:type rdf:resource="http://www.w3.org/ns/ldp#Container"/>
    <ldp:contains rdf:resource="http://localhost:8080/rest/t1"/> <info:fedora/fedora-system:def/internal#repository/query.xpath.doc.order> "false" .
<http://localhost:8080/rest/> <info:fedora/fedora-system:def/internal#repository/level.2.supported> "true" .
<http://localhost:8080/rest/> <info:fedora/fedora-system:def/internal#hasNodeType> "nt:resource" .

Create a new object


    <rdf:type rdf:resource="http://fedora.info/definitions/v4/repository#Container"/>
    <rdf:type rdf:resource="http://www.w3.org/ns/ldp#BasicContainer"/>
  </rdf:Description>
</rdf:RDF>

or

Code Block

$ curl http://localhost:8080/rest/ -XH POST -v
* About to connect() to localhost port 8080 (#0)
*   Trying ::1...
* connected
* Connected to localhost (::1) port 8080 (#0)
> POST /rest/fcr:new HTTP/1.1
> User-Agent: curl/7.24.0 (x86_64-apple-darwin12.0) libcurl/7.24.0 OpenSSL/0.9.8r zlib/1.2.5
> Host: localhost:8080
> Accept: */*
> 
< HTTP/1.1 201 Created
< Location: http"Accept: application/n-triples"
<http://localhost:8080/rest/> <http://fedora.info/definitions/v4/repository#lastModified> "2018-05-30T20:51:11.833Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> .
<http://localhost:8080/rest/> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://www.w3.org/ns/ldp#RDFSource> .
<http://localhost:8080/rest/7f/50/8e/82/7f508e82-15f7-48de-92a3-2575a1b749cf
< Content-Type: text/plain
< Transfer-Encoding: chunked
< Server: Jetty(8.1.11.v20130520)
 
$ curl http://localhost:8080/rest/7f/50/8e/82/7f508e82-15f7-48de-92a3-2575a1b749cf> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://www.w3.org/ns/ldp#Container> .
<http://localhost:8080/rest/> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://www.w3.org/ns/ldp#BasicContainer> .
<http://localhost:8080/rest/7f> <http:/50/8e/82/7f508e82-15f7-48de-92a3-2575a1b749cf>/fedora.info/definitions/v4/repository#writable> "true"^^<http://www.w3.org/2001/XMLSchema#boolean> .
<http://localhost:8080/rest/> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://fedora.info/definitions/v4/repository#RepositoryRoot> .
<http://localhost:8080/rest/> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://fedora.info/definitions/v4/repository#Resource> .
<http://localhost:8080/rest/> <http://www.w3.org/1999/02/22-rdf-syntax-ns#type> <http://fedora.info/definitions/v4/repository#Container> .
<http://localhost:8080/rest/> <http://www.w3.org/ns/ldp#contains> <http://localhost:8080/rest/ktest> .
<http://localhost:8080/rest/> <http://www.w3.org/ns/ldp#contains> <http://localhost:8080/rest/91/86/4c/e0/91864ce0-9ad2-49cd-b2c3-85b0c6b204e5> .
<http://localhost:8080/rest/> <http://www.w3.org/ns/ldp#contains> <http://localhost:8080/rest/examples> .
<http://localhost:8080/rest/> <http://www.w3.org/ns/ldp#contains> <http://localhost:8080/rest/t1> .
<http://localhost:8080/rest/> <http://fedora.info/definitions/v4/repository#hasTransactionProvider> <http://localhost:8080/rest/fcr:tx> .

Create a new object

Code Block

$ curl http://localhost:8080/rest/ -X POST -v
*   Trying ::1...
* TCP_NODELAY set
* Connected to localhost (::1) port 8080 (#0)
* Server auth using Basic with user 'fedoraAdmin'
> POST /rest/ HTTP/1.1
> Host: localhost:8080
> Authorization: Basic ZmVkb3JhQWRtaW46ZmVkb3JhQWRtaW4=
> User-Agent: curl/7.60.0
> Accept: */*
> 
< HTTP/1.1 201 Created
< Date: Thu, 02 Aug 2018 14:50:46 GMT
< Set-Cookie: JSESSIONID=1aftnonavsnvk1q6ln4jtleda4;Path=/
< Expires: Thu, 01 Jan 1970 00:00:00 GMT
< Set-Cookie: rememberMe=deleteMe; Path=/; Max-Age=0; Expires=Wed, 01-Aug-2018 14:50:46 GMT
< ETag: W/"187414816f9004f45508769998bec981ca90bea4"
< Last-Modified: Thu, 02 Aug 2018 14:50:46 GMT
< Link: <http://localhost:8080/static/constraints/ContainerConstraints.rdf>; rel="http://www.w3.org/ns/ldp#constrainedBy"
< Link: <http://localhost:8080/rest/39965e35-4cad-4b96-b826-0c8612f773d5/fcr:acl>; rel="acl"
< Location: http://localhost:8080/rest/39965e35-4cad-4b96-b826-0c8612f773d5
< Content-Type: text/plain
< Content-Length: 63
< Server: Jetty(9.3.1.v20150714)
< 
* Connection #0 to host localhost left intact
http://localhost:8080/rest/39965e35-4cad-4b96-b826-0c8612f773d5
 
$ curl http://localhost:8080/rest/7f/50/8e/82/7f508e82-15f7-48de-92a3-2575a1b749cf
@prefix premis:  <http://www.loc.gov/premis/rdf/v1#> .
@prefix test:  <info:fedora/test/> .
@prefix memento:  <http://mementoweb.org/ns#> .
@prefix rdfs:  <http://www.w3.org/2000/01/rdf-schema#> .
@prefix webac:  <http://fedora.info/definitions/v4/webac#> .
@prefix acl:  <http://www.w3.org/ns/auth/acl#> .
@prefix ns001:  <http://localhost:8080/rest/ktest/> .
@prefix xsi:  <http://www.w3.org/2001/XMLSchema-instance> .
@prefix xmlns:  <http://www.w3.org/2000/xmlns/> .
@prefix rdf:  <http://www.w3.org/1999/02/22-rdf-syntax-ns#> .
@prefix fedora:  <http://fedora.info/definitions/v4/repository#> .
@prefix xml:  <http://www.w3.org/XML/1998/namespace> .
@prefix ebucore:  <http://www.ebu.ch/metadata/ontologies/ebucore/ebucore#> .
@prefix ldp:  <http://www.w3.org/ns/ldp#> .
@prefix xs:  <http://www.w3.org/2001/XMLSchema> .
@prefix fedoraconfig:  <http://fedora.info/definitions/v4/config#> .
@prefix foaf:  <http://xmlns.com/foaf/0.1/> .
@prefix dc:  <http://purl.org/dc/elements/1.1/> .

<http://localhost:8080/rest/39965e35-4cad-4b96-b826-0c8612f773d5>
        rdf:type               fedora:Container ;
        rdf:type               fedora:Resource ;
        rdf:type               ldp:BasicContainer ;
        fedora:lastModifiedBy  "fedoraAdmin" ;
        fedora:exportsAscreatedBy       "fedoraAdmin" ;
        <http://localhost:8080/rest/7f/50/8e/82/7f508e82-15f7-48de-92a3-2575a1b749cf/fcr:export?format=jcr/xml> ;
fedora:created         fedora-internal:baseVersion     <info:fedora/jcr:system/jcr:versionStorage/0e/4e/11/0e4e11e565da7612554b06b092ee5e6e5fc1abec/jcr:rootVersion>"2018-08-02T14:50:46.121Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ;
        fedora-internal:created     :lastModified    "20132018-0708-01T1702T14:5250:5146.406Z121Z"^^<http://www.w3.org/2001/XMLSchema#dateTime> ;
        rdf:type    fedora-internal:createdBy           ldp:RDFSource ;
       "<anonymous>" ;
 rdf:type        fedora-internal:createdby       "<anonymous>"ldp:Container ;
        fedora-internal:hasParentwritable        <http://localhost:8080/rest/7f/50/8e/82> ;true .

Delete an object

Code Block
$ curl -X DELETE http://localhost:8080/rest/7f/50/8e/82/7f508e82-15f7-48de-92a3-2575a1b749cf39965e35-4cad-4b96-b826-0c8612f773d5

Page tree

Versions Compared

Old Version 3

New Version 4

Key

Prerequisites

REST API Examples

Create a new object

Delete an object