Download
Download all of the clients listed below from the Downloads page
Available clients
StoreClient
DuraCloud provides access to files stored in cloud storage systems through an application called DuraStore. DuraStore is installed and running on your DuraCloud instance and can be accessed via a REST interface. In order to aid Java developers in communicating with DuraStore, a Java client, called StoreClient was written.
ReportClient
DuraCloud provides reporting capabilities which assist in understanding and managing the content stored in DuraCloud and services run through DuraCloud. These capabilities are included as part of an application called DuraBoss. DuraBoss is installed and running on your DuraCloud instance and the reporting capabilities can be accessed via a REST interface. In order to aid Java developers in communicating with the reporting features of DuraBoss, a Java client, called ReportClient was written.
Using the clients
To use any of the above clients, you will need to include their dependencies. This is best done using Maven, as follows:
StoreClient
<dependency>
<groupId>org.duracloud</groupId>
<artifactId>storeclient</artifactId>
<version>{duracloud-version}</version>
</dependency>
ReportClient
<dependency>
<groupId>org.duracloud</groupId>
<artifactId>reportclient</artifactId>
<version>{duracloud-version}</version>
</dependency>
Alternatively, all of the jars included in the libs directory of the download package can be added to your local java classpath. You will then be able to write code using the provided Javadocs to interact with the client.
Example code
StoreClient
An example Maven-based project which provides examples for using the storeclient can be found on Github here: https://github.com/duracloud/rest-client-example
ReportClient
An example Java class has been provided to assist in set up and testing, as well as a starting point for writing your client code. The example client (found in the download package under /resources) includes a simple main class which performs a subset of calls the client is capable of performing, and printing information to the console. To run an example:
- Extract the client zip file
- Update the HOST, PORT, USERNAME, and PASSWORD constant values in ExampleClient.java as needed to connect to your DuraCloud instance.
- Make sure Ant is available on your path and type "ant" to compile the example.
- Type "ant run" to run the example.
