com.evrythng.java.wrapper.service

Class FileService

java.lang.Object

com.evrythng.java.wrapper.core.EvrythngServiceBase

com.evrythng.java.wrapper.service.FileService

public class FileService
extends EvrythngServiceBase

Service wrapper for the /files endpoint.

Field Summary

Fields

Modifier and Type	Field and Description
static String	PATH_FILE
static String	PATH_FILES
static String	PATH_PRIVATE_SIGNATURE
static String	PATH_SIGNATURE

Constructor Summary

Constructors

Constructor and Description
FileService(ApiManager api)

Method Summary

Modifier and Type	Method and Description
EvrythngApiBuilder.Builder<Boolean>	fileDeleter(String name) Delete a file by name.
EvrythngApiBuilder.Builder<File>	fileReader(String name) Find file by name.
EvrythngApiBuilder.Builder<List<File>>	filesReader(String after) Finds files.
EvrythngApiBuilder.Builder<List<File>>	filesReader(String after, String searchString) Finds files.
EvrythngApiBuilder.Builder<List<SignedUploadRequest>>	fileUploadRequestsSigner(List<FileToSign> toSign) Obtain the signatures necessary to upload files to the Cloud.
EvrythngApiBuilder.Builder<List<PrivateSignedUploadRequest>>	privateFileUploadRequestsSigner(List<FileToSign> toSign)
SignedUploadRequest	uploadSingleFile(File file) Obtains a signed url where to upload and uploads there a single File.
SignedUploadRequest	uploadSingleFile(FileToSign toSign, File file) Obtains a signed url where to upload and uploads there a single File.
SignedUploadRequest	uploadSingleFile(FileToSign toSign, InputStream stream) Obtains a signed url where to upload and uploads there data from InputStream provided.
SignedUploadRequest	uploadSingleFile(FileToSign toSign, String content) Obtains a signed url where to upload and uploads there text content.
PrivateSignedUploadRequest	uploadSinglePrivateFile(FileToSign toSign, File contentFile)
PrivateSignedUploadRequest	uploadSinglePrivateFile(FileToSign toSign, String content)

Methods inherited from class com.evrythng.java.wrapper.core.EvrythngServiceBase

absoluteUri, delete, deleteMultiple, encodeBase64, get, getConfig, iterator, mqttUrl, onBuilderCreated, post, post, postAsynchronously, postMultipart, postMultipart, put, put, putMultipart, putMultipart, putMultiple, urlEncodePathPart

Methods inherited from class java.lang.Object

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

Field Detail

PATH_FILES

public static final String PATH_FILES

See Also:

Constant Field Values

PATH_FILE

public static final String PATH_FILE

See Also:

Constant Field Values

PATH_SIGNATURE

public static final String PATH_SIGNATURE

See Also:

Constant Field Values

PATH_PRIVATE_SIGNATURE

public static final String PATH_PRIVATE_SIGNATURE

See Also:

Constant Field Values

Constructor Detail

FileService

public FileService(ApiManager api)

Parameters:

api - ApiManager instance

Method Detail

filesReader

public EvrythngApiBuilder.Builder<List<File>> filesReader(String after)
                                                   throws EvrythngClientException

Finds files.

Parameters:

after - find files starting from file name after or if null find from the beginning.

Returns:

a preconfigured EvrythngApiBuilder.Builder

Throws:

EvrythngClientException

filesReader

public EvrythngApiBuilder.Builder<List<File>> filesReader(String after,
                                                          String searchString)
                                                   throws EvrythngClientException

Finds files.

Parameters:

after - find files starting from file name after or if null find from the beginning.

searchString - only find files starting with search string or null to find all files.

Returns:

a preconfigured EvrythngApiBuilder.Builder

Throws:

EvrythngClientException

fileReader

public EvrythngApiBuilder.Builder<File> fileReader(String name)
                                            throws EvrythngClientException

Find file by name.

Parameters:

name - file name.

Returns:

a preconfigured EvrythngApiBuilder.Builder

Throws:

EvrythngClientException

fileDeleter

public EvrythngApiBuilder.Builder<Boolean> fileDeleter(String name)
                                                throws EvrythngClientException

Delete a file by name.

Parameters:

name - file name.

Returns:

a preconfigured EvrythngApiBuilder.Builder

Throws:

EvrythngClientException

fileUploadRequestsSigner

public EvrythngApiBuilder.Builder<List<SignedUploadRequest>> fileUploadRequestsSigner(List<FileToSign> toSign)
                                                                               throws EvrythngClientException

Obtain the signatures necessary to upload files to the Cloud.

Parameters:

toSign - list of pairs fileName and contentType.

Returns:

a preconfigured EvrythngApiBuilder.Builder

Throws:

EvrythngClientException

privateFileUploadRequestsSigner

public EvrythngApiBuilder.Builder<List<PrivateSignedUploadRequest>> privateFileUploadRequestsSigner(List<FileToSign> toSign)
                                                                                             throws EvrythngClientException

Parameters:

toSign -

Returns:

Throws:

EvrythngClientException

uploadSingleFile

public SignedUploadRequest uploadSingleFile(File file)
                                     throws EvrythngException,
                                            IOException

Obtains a signed url where to upload and uploads there a single File. File name for the Cloud will be determined from File provided. Will try to determine content type from File provided.

Parameters:

file - File to upload.

Returns:

SignedUploadRequest instance containing url.

Throws:

EvrythngException

IOException

uploadSingleFile

public SignedUploadRequest uploadSingleFile(FileToSign toSign,
                                            File file)
                                     throws EvrythngException,
                                            IOException

Obtains a signed url where to upload and uploads there a single File.

Parameters:

toSign - a pair fileName and contentType.

file - File to upload.

Returns:

SignedUploadRequest instance containing url.

Throws:

EvrythngException

IOException

uploadSingleFile

public SignedUploadRequest uploadSingleFile(FileToSign toSign,
                                            String content)
                                     throws EvrythngException,
                                            IOException

Obtains a signed url where to upload and uploads there text content.

Parameters:

toSign - a pair fileName and contentType.

content - text content.

Returns:

SignedUploadRequest instance containing url.

Throws:

EvrythngException

IOException

uploadSinglePrivateFile

public PrivateSignedUploadRequest uploadSinglePrivateFile(FileToSign toSign,
                                                          String content)
                                                   throws EvrythngException,
                                                          IOException,
                                                          URISyntaxException

Throws:

EvrythngException

IOException

URISyntaxException

uploadSinglePrivateFile

public PrivateSignedUploadRequest uploadSinglePrivateFile(FileToSign toSign,
                                                          File contentFile)
                                                   throws EvrythngException,
                                                          IOException,
                                                          URISyntaxException

Throws:

EvrythngException

IOException

URISyntaxException

uploadSingleFile

public SignedUploadRequest uploadSingleFile(FileToSign toSign,
                                            InputStream stream)
                                     throws EvrythngException,
                                            IOException

Obtains a signed url where to upload and uploads there data from InputStream provided.

Parameters:

toSign - a pair fileName and contentType.

stream - InputStream where to read from. Should be closed externally.

Returns:

SignedUploadRequest instance containing url.

Throws:

EvrythngException

IOException