/**
* Return a list of versions that affect the resource whose uri is passed as argument. For each
* version, the result will contain the id, the creator, and the date when the version was
* recorded. Further details for a version can be requested by calling the
* /versioning/versions/{id} webservice.
*
* <p>Note that resource_uri is an optional parameter. In case no resource uri is given, all
* versions recorded by the LMF are returned, which can take a considerable amount of time. @HTTP
* 200 in case the versions were retrieved successfully @HTTP 404 in case the resource passed as
* argument resource_uri could not be found
*
* @param resource_uri the URI of the resource for which to return the versions (optional, see
* warning above)
* @return a JSON list of versions, each a map with the properties "id" (long), "creator" (uri),
* "date" (ISO 8601 String)
*/
@GET
@Produces("application/json")
@Path("/versions/list")
public Response getVersions(
@QueryParam("resource") String resource_uri,
@QueryParam("from") String dateFrom,
@QueryParam("to") String dateTo) {
try {
RepositoryConnection conn = sesameService.getConnection();
try {
if (resource_uri != null) {
URI resource = ResourceUtils.getUriResource(conn, resource_uri);
if (resource != null && resource instanceof KiWiUriResource) {
if (dateFrom == null && dateTo == null) {
return Response.ok()
.entity(formatVersions(versioningService.listVersions(resource)))
.build();
} else {
Date dateFromD = DateUtils.parseDate(dateFrom);
Date dateToD = DateUtils.parseDate(dateTo);
return Response.ok()
.entity(
formatVersions(versioningService.listVersions(resource, dateFromD, dateToD)))
.build();
}
} else {
return Response.status(Response.Status.NOT_FOUND)
.entity("resource with URI " + resource_uri + " was not found in the system")
.build();
}
} else {
if (dateFrom == null && dateTo == null) {
return Response.ok().entity(formatVersions(versioningService.listVersions())).build();
} else {
Date dateFromD = DateUtils.parseDate(dateFrom);
Date dateToD = DateUtils.parseDate(dateTo);
return Response.ok()
.entity(formatVersions(versioningService.listVersions(dateFromD, dateToD)))
.build();
}
}
} finally {
conn.commit();
conn.close();
}
} catch (RepositoryException ex) {
return Response.status(Response.Status.INTERNAL_SERVER_ERROR).entity(ex.getMessage()).build();
} catch (SailException ex) {
return Response.status(Response.Status.INTERNAL_SERVER_ERROR).entity(ex.getMessage()).build();
}
}
/**
* Return detailed information about the version whose id is passed as path argument. Returns a
* JSON map with the fields id, creator, date, added_triples, removed_triples. Triple will be
* represented in RDF/JSON format. @HTTP 404 in case the requested version does not exist
*
* @param id the ID of the version to return
* @return a JSON map representing the version information as described above
*/
@GET
@Produces("application/json")
@Path("/versions/{id:[0-9]+}")
public Response getVersion(@PathParam("id") Long id) {
try {
Version version = versioningService.getVersion(id);
if (version != null) {
Map<String, Object> result = new HashMap<String, Object>();
result.put("id", version.getId());
if (version.getCreator() != null) {
result.put("creator", version.getCreator().stringValue());
}
result.put("date", DateUtils.ISO8601FORMAT.format(version.getCommitTime()));
result.put("added_triples", JSONUtils.serializeTriplesAsJson(version.getAddedTriples()));
result.put(
"removed_triples", JSONUtils.serializeTriplesAsJson(version.getRemovedTriples()));
return Response.ok().entity(result).build();
} else {
return Response.status(Response.Status.NOT_FOUND)
.entity("version with id " + id + " does not exist")
.build();
}
} catch (SailException e) {
return Response.serverError()
.entity("error loading version " + id + ": " + e.getMessage())
.build();
}
}
/**
* Revert (undo) the version with the given ID. Calling this service will add all removed triples
* and remove all added triples of the old version. If versioning is active, this will create a
* new version as well.
*
* @param id
* @return
*/
@POST
@Path("/versions/{id:[0-9]+}")
public Response revertVersion(@PathParam("id") Long id) {
try {
Version version = versioningService.getVersion(id);
if (version != null) {
versioningService.removeVersion(id);
return Response.ok().entity("success").build();
} else {
return Response.status(Response.Status.NOT_FOUND)
.entity("version with id " + id + " does not exist")
.build();
}
} catch (SailException e) {
return Response.serverError()
.entity("error deleting version " + id + ": " + e.getMessage())
.build();
}
}