amareensaleh/NetStorageKit-Java

JavaApache-2.0

NetStorageKit (for Java)

This library assists in the interaction with Akamai's NetStorage CMS API. The CMS API Spec can be found at: https://control.akamai.com/dl/customers/NS/NetStrgHttpCM.pdf

Project organization

/src - project sources
/test - junit test cases
/build - build and output libraries
/doc - javadoc for class libraries
/lib - 3rd party dependency libraries (Currenly only necessary for running unit tests)
/example - an example app that utilizes the NetStorageKit

Install

Compile the sources from /src into build/classes.
An ant build.xml is also provided for ease of use. Common commands are: ant compile, ant jar and ant test
A maven pom.xml is also provided for ease of use. To install: mvn install
Both IntelliJ and Eclipse project files are available
the destination jar file is located in build/jar

Getting Started

Create an instance of the NetStorage object by passing in the host, username and key
Issue a command to NetStorage by calling the appropriate method from the NetStorage object

For example, to delete a file:

import com.akamai.netstorage.NetStorage;

NetStorage ns = new NetStorage("example.akamaihd.net", "user1", "1234abcd");
ns.delete("/1234/example.zip");

Other methods return an InputStream. For example, to retrieve a directory listing:

import com.akamai.netstorage.NetStorage;
NetStorage ns = new NetStorage("example.akamaihd.net", "user1", "1234abcd");

try (InputStream result = ns.dir("/1234")) {
 // TODO: consume InputStream
}

Finally, when uploading a File object can be sent or an open InputStream wll be used

import com.akamai.netstorage.NetStorage;

NetStorage ns = new NetStorage("example.akamaihd.net", "user1", "1234abcd");
try (InputStream result = ns.upload("/1234/example.zip", new File("../workingdir/srcfile.zip"))) {
 // TODO: consume InputStream
}

Sample application (CMS)

A sample application has been created that can take command line parameters.

java -classpath build/classes CMS -a dir -u user1 -k 1234abcd example.akamaihd.net/1234