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