Java Storlet Writing and Deploying Guide¶

This is the Java specific storlet writing and deploying guide. This guide complements the more general guide for writing and deploying storlets which should be read first. To write a Java storlet you will need the SCommon.jar which is being built as part of the storlets build process as described in the development and testing guide.

Import the .jar to a Java project in Eclipse and implement the org.openstack.storlet.common.IStorlet interface. The interface has a single method that looks like this:

public void invoke(ArrayList<StorletInputStream> inStreams,
                   ArrayList<StorletOutputStream> outStreams,
                   Map<String,String> parameters, StorletLogger logger) throws StorletException;

Below is a class diagram illustrating the classes involved in the above API.

1. The StorleInputStream is used to stream object’s data into the storlet. An instance of the class is provided whenever the Storlet gets an object as an input. Practically, it is used in all storlet invocation scenarios to stream in the object’s data and metadata. To consume the data call getStream() to get a java.io.InputStream on which you can just read(). To consume the metadata call the getMetadata() method.
2. StorletObjectOutputStream. In all invocation scenarios the storlet is called with an instance of this class.
   • Use the setMetadata method to set the Object’s metadata.
   • Use getStream to get a java.io.OutputStream on which you can just write() the content of the object.
   • Notice that setMetadata must be called. Also, it must be called before writing the data. Additional guidelines on using StorletObjectOutputStream are given below.
3. StorletLogger. The StorletLogger class supports a single method called emitLog, and accepts a String. The storlet logs are written to the host machine.

When invoked via the Swift REST API the invoke method will be called as follows:

1. The inStreams array would include one or more element(s) of type StorleInputStream representing the object appearing in the request’s URI (and possibly extra resources).
2. The outStreams would include a single element of type StorleObjectOutputStream representing the response returned to the user.
3. The parameters map includes execution parameters sent. These parameters can be specified in the storlet execution request.
4. A StorletLogger instance.