com.algorithmia.data

Class DataDirectory

java.lang.Object

com.algorithmia.data.DataObject

com.algorithmia.data.DataDirectory

public class DataDirectory
extends DataObject

A data stream

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
protected class	DataDirectory.DirectoryListResponse
protected class	DataDirectory.DirectoryMetadata
protected class	DataDirectory.FileMetadata

Field Summary

Fields inherited from class com.algorithmia.data.DataObject

client, path

Constructor Summary

Constructors

Constructor and Description
DataDirectory(HttpClient client, java.lang.String dataUrl)

Method Summary

Methods

Modifier and Type	Method and Description
void	create() Creates this directory via the Algorithmia Data API
void	delete(boolean forceDelete) Creates this directory vi the Algorithmia Data API
boolean	exists() Determine if this Algorithmia data directory exists
DataFile	file(java.lang.String filename) Queries the DataAPI for a particular data file
DataDirectoryIterator	getDirIter()
DataFileIterator	getFileIter() Get an iterator for retrieving files in this DataDirectory The file list retrieval is done in batches, generally ~1000 files at a time
protected DataDirectory.DirectoryListResponse	getPage(java.lang.String marker) Gets a single page of the directory listing.
DataFile	putFile(java.io.File file) Convenience wrapper for putting a File

Methods inherited from class com.algorithmia.data.DataObject

getName, getParent, getUrl, toString

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Constructor Detail

DataDirectory

public DataDirectory(HttpClient client,
             java.lang.String dataUrl)

Method Detail

exists

public boolean exists()
               throws APIException

Determine if this Algorithmia data directory exists

Specified by:

exists in class DataObject

Returns:

true iff the directory exists

Throws:

APIException - if there were any problems communicating with the Algorithmia API

getFileIter

public DataFileIterator getFileIter()
                             throws APIException

Get an iterator for retrieving files in this DataDirectory The file list retrieval is done in batches, generally ~1000 files at a time

Returns:

the list of files

Throws:

APIException - if there were any problems communicating with the Algorithmia API

getDirIter

public DataDirectoryIterator getDirIter()
                                 throws APIException

Throws:

APIException

file

public DataFile file(java.lang.String filename)

Queries the DataAPI for a particular data file

Parameters:

filename - the name of the file within this collection to get a reference for

Returns:

a handle to the requested file

putFile

public DataFile putFile(java.io.File file)
                 throws APIException,
                        java.io.FileNotFoundException

Convenience wrapper for putting a File

Parameters:

file - a file to put into this data directory

Returns:

a handle to the requested file

Throws:

APIException - if there were any problems communicating with the Algorithmia API

java.io.FileNotFoundException - if the specified file does not exist

create

public void create()
            throws APIException

Creates this directory via the Algorithmia Data API

Throws:

APIException - if there were any problems communicating with the Algorithmia API

delete

public void delete(boolean forceDelete)
            throws APIException

Creates this directory vi the Algorithmia Data API

Parameters:

forceDelete - forces deletion of the directory even if it still has other files in it

Throws:

APIException - if there were any problems communicating with the Algorithmia API

getPage

protected DataDirectory.DirectoryListResponse getPage(java.lang.String marker)
                                               throws APIException

Gets a single page of the directory listing. Subsquent pages are fetched with the returned marker value.

Parameters:

marker - indicates the specific page to fetch; first page is fetched if null

Returns:

a page of files and directories that exist within this directory

Throws:

APIException - if there were any problems communicating with the Algorithmia API