Storage Manager

From Gcube Wiki
Revision as of 15:51, 3 April 2012 by Roberto.cirillo (Talk | contribs) (Access Mode)

Jump to: navigation, search
== Role ==



Role

Access and storage of unstructured bytestreams, or files, can be provided through a standards-based, POSIX-like API which supports the organisation and operations normally associated with local file systems whilst offering scalable and fault-tolerant remote storage.

The library acts a facade to the service and allows clients to download, upload, remove, add, and list files. Files have owners and owners may define access rights to files, allowing private, public, or group-based access.


Access Mode

There are 3 ways to access remote files

 ● Private: Accessible only all'owner file

Public: accessible to all users of the community Shared: Accessible to all users of the same group that the owners The credentials to use the library are:

GroupID: identification of the group or community membership ClientID: the user ID, must be secret to protect their data

Operations

The StorageManger library implements many operation on remote file, the methods LFile and RFile refer to, respectively, Local File (if needed) and Remote File. In the call's signature, there are preceded from a method that identify a operation:

put(boolean replace)
put a local file in a remote directory. If replace is true then the remote file, if exist, will be replaced, false otherwise.
Example: put(true).LFile(“localPath”).RFile(“remotePath”)
get()
downloads a file from a remote path to a local directory
Example: get().LFile(“localPath”).RFile(“remotePath”);
remove()
removes a remote file
Example: remove().RFile(“remotePath”);
removeDir()
removes a remote directory
Example removeDir().LFile(“remoteDirPath”);
showDir()
shows the content of a directory
Example showDir.RFile(“remoteDirPAth”);
lock()
locks a remote file to prevent multiple access
Example lock().RFile(“remotePath”);
unlock(String lockKey)
unlocks a remote file
Example unlock(“key”).RFile(“remotePath”);
getTTL()
return the TimeToLive associated to a remote file if the file is currently locked
Example getTTL().RFile("remote/path/to/dir");
setTTL(int milliseconds)
set the TimeToLive to a remote file that is currently locked. This operation is consented max 5 times for any file.
Example setTTL(180000).RFile("remote/path/to/dir");

Sample Usage

The following code explains how to instatiate a client for do remote operation on the storage repository:


The following code explains how to upload a new file in the storage repository:


The following code explains how to download a file from the storage repository:


The following code explains how to show the contents of a remote directoory on the storage repository:


The following code explains how to lock a file on the storage repository:


The following code explains how to unlock a file on the storage repository:


The following code explains how to remove a file on the storage repository:


The following code explains how to remove a dir on the storage repository: