com.googlecode.jinahya.ucloud.storage

Class StorageClient

java.lang.Object

com.googlecode.jinahya.ucloud.storage.StorageClient

public class StorageClient
extends Object

Author:

Jin Kwon

Constructor Summary

Constructors

Constructor and Description
StorageClient(String storageUser, String storagePass) Creates a new instance.

Method Summary

Methods

Modifier and Type	Method and Description
boolean	createContainer(String containerName) Creates a container named as given containerName.
boolean	deleteContainer(String containerName) Deletes a container.
boolean	deleteObject(String containerName, String objectName) Deletes an object.
Integer	getConnectTimeout() Returns connect timeout.
Map<String,List<String>>	getHeaderFields() Returns last HTTP response header fields.
Integer	getReadTimeout() Return read timeout.
int	getResponseCode() Returns last HTTP response status code.
String	getResponseMessage() Returns last HTTP response reason phrase.
boolean	readObject(String containerName, String objectName, ContentConsumer contentConsumer) Reads object content.
boolean	readObject(String containerName, String objectName, ContentDataConsumer contentDataConsumer) Reads object content.
boolean	readObject(String containerName, String objectName, OutputStream contentDataOutput) Reads an object's content.
boolean	readStorageContainer(String containerName, StorageContainer storageContainer)
boolean	readStorageContainers(Map<String,Object> queryParameters, Collection<StorageContainer> storageContainers) Reads information of containers.
boolean	readStorageObject(String containerName, String objectName, StorageObject storageObject)
boolean	readStorageObjects(String containerName, Map<String,Object> queryParameters, Collection<StorageObject> storageObjects) Reads objects information of a container.
void	setConnectTimeout(Integer connectTimeout) Sets connect timeout.
void	setReadTimeout(Integer readTimeout) Sets read timeout.
boolean	updateObject(String containerName, String objectName, ContentProducer contentProducer) Updates an object's content.
boolean	updateObject(String containerName, String objectName, String contentType, byte[] contentData) Updates an object's content.
boolean	updateObject(String containerName, String objectName, String contentType, long contentLength, ContentDataProducer contentDataProducer) Updates an object's content.
boolean	updateObject(String containerName, String objectName, String contentType, long contentLength, InputStream contentData) Updates an object's content.

Methods inherited from class java.lang.Object

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

Constructor Detail

StorageClient

public StorageClient(String storageUser,
             String storagePass)

Creates a new instance.

Parameters:

storageUser - user id

storagePass - api key

Method Detail

readStorageContainer

public boolean readStorageContainer(String containerName,
                           StorageContainer storageContainer)
                             throws IOException

Parameters:

containerName - container name

storageContainer - storage container

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs

readStorageContainers

public boolean readStorageContainers(Map<String,Object> queryParameters,
                            Collection<StorageContainer> storageContainers)
                              throws IOException

Reads information of containers.

Parameters:

queryParameters - query parameters; null is allowed

storageContainers - the collecion to which results are added

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs.

createContainer

public boolean createContainer(String containerName)
                        throws IOException

Creates a container named as given containerName.

Parameters:

containerName - container name

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs.

deleteContainer

public boolean deleteContainer(String containerName)
                        throws IOException

Deletes a container.

Parameters:

containerName - container name

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs.

readStorageObject

public boolean readStorageObject(String containerName,
                        String objectName,
                        StorageObject storageObject)
                          throws IOException

Parameters:

containerName -

objectName -

storageObject -

Returns:

Throws:

IOException

readStorageObjects

public boolean readStorageObjects(String containerName,
                         Map<String,Object> queryParameters,
                         Collection<StorageObject> storageObjects)
                           throws IOException

Reads objects information of a container.

Parameters:

containerName - container name

queryParameters - query parameters; null is allowed

storageObjects - the collection to which all results are added

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs

updateObject

public boolean updateObject(String containerName,
                   String objectName,
                   String contentType,
                   byte[] contentData)
                     throws IOException

Updates an object's content.

Parameters:

containerName - container name

objectName - object name

contentType - content type; null for unknown

contentData - content data

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs

updateObject

public boolean updateObject(String containerName,
                   String objectName,
                   String contentType,
                   long contentLength,
                   InputStream contentData)
                     throws IOException

Updates an object's content.

Parameters:

containerName - container name

objectName - object name

contentType - content type; null for unknown

contentLength - content length; -1L for unknown

contentData - content data

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs

updateObject

public boolean updateObject(String containerName,
                   String objectName,
                   String contentType,
                   long contentLength,
                   ContentDataProducer contentDataProducer)
                     throws IOException

Updates an object's content.

Parameters:

containerName - container name

objectName - object name

contentType - content type; null for unknown

contentLength - content length; -1L for unknown

contentDataProducer - content data producer

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs.

updateObject

public boolean updateObject(String containerName,
                   String objectName,
                   ContentProducer contentProducer)
                     throws IOException

Updates an object's content.

Parameters:

containerName - container name

objectName - object name

contentProducer - content producer

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs

readObject

public boolean readObject(String containerName,
                 String objectName,
                 OutputStream contentDataOutput)
                   throws IOException

Reads an object's content.

Parameters:

containerName - container name

objectName - object name

contentDataOutput - the output stream to which content is written

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs

readObject

public boolean readObject(String containerName,
                 String objectName,
                 ContentDataConsumer contentDataConsumer)
                   throws IOException

Reads object content.

Parameters:

containerName - container name

objectName - object name

contentDataConsumer - content data consumer

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs.

readObject

public boolean readObject(String containerName,
                 String objectName,
                 ContentConsumer contentConsumer)
                   throws IOException

Reads object content.

Parameters:

containerName - container name

objectName - object name

contentConsumer - content consumer

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs

deleteObject

public boolean deleteObject(String containerName,
                   String objectName)
                     throws IOException

Deletes an object.

Parameters:

containerName - container name

objectName - object name

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs.

getConnectTimeout

public Integer getConnectTimeout()

Returns connect timeout.

Returns:

connect timeout

setConnectTimeout

public void setConnectTimeout(Integer connectTimeout)

Sets connect timeout.

Parameters:

connectTimeout - connect timeout

getReadTimeout

public Integer getReadTimeout()

Return read timeout.

Returns:

read timeout.

setReadTimeout

public void setReadTimeout(Integer readTimeout)

Sets read timeout.

Parameters:

readTimeout - read timeout

getResponseCode

public int getResponseCode()

Returns last HTTP response status code.

Returns:

status code

getResponseMessage

public String getResponseMessage()

Returns last HTTP response reason phrase.

Returns:

reason phrase

getHeaderFields

public Map<String,List<String>> getHeaderFields()

Returns last HTTP response header fields.

Returns:

response header fields