Versions Compared


  • This line was added.
  • This line was removed.
  • Formatting was changed.


Research Objects Digital Library

Table of Contents


This document contains a specification of the services functionalities offered by the Research Object Digital Library. RODL realises the backbone services of a software architecture for the preservation of research objects. 

The main one is Research Object Storage and Retrieval Service (ROSRS). The main functionality of the service is to allow its users to store and retrieve Research Objects. Other services include the User Management Serviceinterface to RODL is a set of RESTful APIs, being the two primary ones the RO API and the RO Evolution API. These APIs interoperate through the RO and related models, the data structures that encode the concepts and relationships of information. For instance, RO API defines the formats and links used to create and maintain ROs in the digital library. It is aligned with the RO model, hence recognizing concepts such as aggregations, annotations and folders. The RO model ontology is used to specify relations between different resources. The RODL supports content negotiation for metadata, including formats like RDF/XML, Turtle and TriG. The RO Evolution API defines the formats and links used to change the lifecycle stage of a RO, most importantly to create an immutable snapshot or archive from a mutable live RO, as well as to retrieve the evolution provenance of a RO. The API follows the RO evolution model. Additionally, RODL provides a SPARQL endpoint, a Notification API, a Solr REST API and a custom User Management API.


The RODL is built on top of dLibra. dLibra provides file storage and retrieval functionalities, including file versioning and consistency checking. It has a built-in text search engine, fed by its own flexible metadata system, and it manages users and controls their access rights. Besides, dLibra allows organising stored objects into hierarchical structures and associating metadata at the level of object aggregations.


REST interface specifications


Wf4Ever models implementation considerations


Research Object



Group publication

Research Object


Version of Research Object

Publication with single edition which content is modified every
time the data or metadata of the Research Object changes

Resource file

For each modification of the file a new File Version is created. The deletion of files will be handled by excluding them from the "edition" in dLibra.


The source code is available at git://

See instructions and additional information at source code repository: 

titleDeprecated information

dLibra server location and directory used for storing workspaces should be configured in src\main\resources\ file. A dLibra instance used for demonstration purposes is available at host (port number 10051 and directory 3, as originally configured).

That's all, now the project can be built (mvn package) and deployed (rosrs5 servlet).