Skip to content

Latest commit

 

History

History
46 lines (35 loc) · 3.23 KB

README.md

File metadata and controls

46 lines (35 loc) · 3.23 KB

DSpace connector

Library to publish files and/or metadata to DSpace-based publication repositories

Functionality

  1. Textual description of the currently implemented methods could be found in functionality.md
  2. The ExportRepository interface is implemented, what provides a common language with other even not DSpace-based repositories

How to add to your maven project (as dependency in pom.xml)

<dependency>
	<groupId>com.github.bwfdm</groupId>
	<artifactId>dspace-connector</artifactId>
	<version>0.3.1</version>
</dependency>  

How to use

Features

  • connection to DSpace is realized via REST-API and SWORD-v2 protocol
  • complete functionality via only SWORD-v2 protocol is possible too, please use DSpaceSwordOnly.java class for that. IMPORTANT: for this case some special configuration of the publication repository is needed (see "Limitations" section bellow).
  • REST-API is used to get the most essential information about collections and communities
  • SWORD-v2 protocol is used to transfer files to the publication repository (make injest) and to get information from the service document as well, what collections (and in extra case - communities) are available for the user (see Exporter Commons)
  • as a core component for the SWORD-v2 communication the SWORD JavaClient2.0 library is used

Tests

Limitations

  • it is important, that "REST" and "SWORD-v2" have to be activated by the publication repository. For more details please see the DSpace installation manual
  • it is also possible to provide full functionality ONLY via SWORD-v2 protocol using the DSpaceSwordOnly.java class. For this case some extra configuration of the publication repository is needed:
    • on the publication repository server open the sword-v2 configuration file: /dspace/config/modules/sword-server.cfg
    • set value: expose-communities = true (to offer in the service document a list of communities instead of collections, per default is "false")
    • restart the web server as usual to apply the changes
  • support of the REST-API currently is only implemented for DSpace version 6.x, see DSpace_v6.java
  • currently supported is only metadata as a Map<String, List>, support of the metadata as an XML-file will be implemented in future releases

Used third party libraries and their licenses

Own license