org.fcrepo.http.api

Class FedoraVersions

java.lang.Object

org.fcrepo.http.commons.AbstractResource

org.fcrepo.http.api.FedoraBaseResource

org.fcrepo.http.api.ContentExposingResource

org.fcrepo.http.api.FedoraVersions

@Scope(value="request")
 @Path(value="/{path: .*}/fcr:versions/{labelAndOptionalPathIntoVersion: .*(?<!/fcr:fixity)$}")
public class FedoraVersions
extends ContentExposingResource

Endpoint for managing versions of nodes

Author:

awoods, ajs6f

Field Summary

Fields

Modifier and Type	Field and Description
protected FedoraResource	baseResource
protected String	externalPath
protected String	label
protected String	path
protected String	pathIntoVersion
protected String	pathListIntoVersion

Fields inherited from class org.fcrepo.http.api.ContentExposingResource

lockManager, MESSAGE_EXTERNAL_BODY, prefer, request, resource, servletResponse

Fields inherited from class org.fcrepo.http.api.FedoraBaseResource

idTranslator, securityContext, session

Fields inherited from class org.fcrepo.http.commons.AbstractResource

binaryService, containerService, defaultPidMinter, eventBus, headers, nodeService, pidMinter, sessions, uriInfo, versionService

Constructor Summary

Constructors

Constructor and Description
FedoraVersions() Default JAX-RS entry point
FedoraVersions(String path, String label, String pathIntoVersion) Create a new FedoraNodes instance for a given path

Method Summary

Modifier and Type	Method and Description
protected void	addResourceHttpHeaders(FedoraResource resource) Add any resource-specific headers to the response
protected String	externalPath()
javax.ws.rs.core.Response	getVersion(String rangeValue) Retrieve a version of an object.
javax.ws.rs.core.Response	removeVersion() Removes the version specified by the label.
protected FedoraResource	resource()
javax.ws.rs.core.Response	revertToVersion() Reverts the resource at the given path to the version specified by the label.
protected String	unversionedResourcePath()

Methods inherited from class org.fcrepo.http.api.ContentExposingResource

addCacheControlHeaders, addResourceLinkHeaders, addResourceLinkHeaders, checkCacheControlHeaders, evaluateRequestPreconditions, getBinaryContent, getContent, getContent, getResourceTriples, getResourceTriples, getSimpleContentType, getTriples, getTriples, getTriples, getTriples, getUri, isExternalBody, isRdfContentType, patchResourcewithSparql, replaceResourceBinaryWithStream, replaceResourceWithStream

Methods inherited from class org.fcrepo.http.api.FedoraBaseResource

asNode, getResourceFromPath, getUserPrincipal, session, setUpJMSInfo, translator

Methods inherited from class org.fcrepo.http.commons.AbstractResource

toPath

Methods inherited from class java.lang.Object

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

Field Detail

externalPath

@PathParam(value="path")
protected String externalPath

pathListIntoVersion

@PathParam(value="labelAndOptionalPathIntoVersion")
protected String pathListIntoVersion

path

protected String path

label

protected String label

pathIntoVersion

protected String pathIntoVersion

baseResource

protected FedoraResource baseResource

Constructor Detail

FedoraVersions

public FedoraVersions()

Default JAX-RS entry point

FedoraVersions

public FedoraVersions(String path,
                      String label,
                      String pathIntoVersion)

Create a new FedoraNodes instance for a given path

Parameters:

path - the path

label - the label

pathIntoVersion - the string value of pathIntoVersion

Method Detail

revertToVersion

public javax.ws.rs.core.Response revertToVersion()

Reverts the resource at the given path to the version specified by the label.

Returns:

response

removeVersion

@DELETE
public javax.ws.rs.core.Response removeVersion()

Removes the version specified by the label.

Returns:

204 No Content

getVersion

@GET
 @Produces(value={"text/turtle;charset=utf-8;qs=1.0","application/ld+json;qs=0.8","text/rdf+n3;charset=utf-8","text/n3;charset=utf-8","application/rdf+xml","application/n-triples","text/plain;charset=utf-8","application/x-turtle","text/html;charset=utf-8","*/*"})
public javax.ws.rs.core.Response getVersion(@HeaderParam(value="Range")
                                                                                                                                                                                                                                                                                                                         String rangeValue)
                                                                                                                                                                                                                                                                                                                  throws IOException

Retrieve a version of an object. The path structure is as follows (though these URLs are returned from getVersionList and need not be constructed manually): /versionable-node/fcr:versions/label/path/to/any/copied/unversionable/nodes

Parameters:

rangeValue - the range value

Returns:

the version of the object as RDF in the requested format

Throws:

IOException - if IO exception occurred

unversionedResourcePath

protected String unversionedResourcePath()

resource

protected FedoraResource resource()

Overrides:

resource in class ContentExposingResource

addResourceHttpHeaders

protected void addResourceHttpHeaders(FedoraResource resource)

Description copied from class: ContentExposingResource

Add any resource-specific headers to the response

Overrides:

addResourceHttpHeaders in class ContentExposingResource

Parameters:

resource - the resource

externalPath

protected String externalPath()

Specified by:

externalPath in class ContentExposingResource