com.googlecode.jinahya.ucloud.storage

Class UcloudStorageClient

java.lang.Object

com.googlecode.jinahya.ucloud.storage.UcloudStorageClient

public class UcloudStorageClient
extends Object

Author:

Jin Kwon

Constructor Summary

Constructors

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

Method Summary

Methods

Modifier and Type	Method and Description
boolean	createStorageContainer(String containerName) Creates a storage container named as given name.
boolean	deleteStorageContainer(String containerName) Deletes a storage container named as given container name.
boolean	deleteStorageObject(String containerName, String objectName) Deletes an object.
Integer	getConnectTimeout() Returns connect timeout.
String	getFirstHeaderValue(String headerName)
Map<String,List<String>>	getHeaderFields() Returns last HTTP response header fields.
List<String>	getHeaderValues(String headerName)
Integer	getReadTimeout() Return read timeout.
int	getResponseCode() Returns last HTTP response status code.
String	getResponseMessage() Returns last HTTP response reason phrase.
StorageAccount	readStorageAccount() Retrieves a storage account.
StorageContainer	readStorageContainer(String containerName) Retrieves a storage container whose name is mapped to given container name.
boolean	readStorageContainers(Map<String,Object> queryParameters, Collection<? super StorageContainer> storageContainers) Retrieves storage containers.
boolean	readStorageContent(String containerName, String objectName, ContentConsumer contentConsumer) Reads the content of a storage object.
StorageObject	readStorageObject(String containerName, String objectName)
boolean	readStorageObjects(String containerName, Map<String,Object> queryParameters, Collection<? super StorageObject> storageObjects) Reads objects information of a container.
void	setConnectTimeout(Integer connectTimeout) Sets connect timeout.
void	setReadTimeout(Integer readTimeout) Sets read timeout.
boolean	updateStorageContent(String containerName, String objectName, ContentProducer contentProducer) Updates or creates an storage content.
boolean	updateStorageContent(String containerName, String objectName, String contentType, byte[] contentData) Updates an object's content.
boolean	updateStorageContent(String containerName, String objectName, String contentType, long contentLength, InputStream contentData) Updates an storage object's content.

Methods inherited from class java.lang.Object

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

Constructor Detail

UcloudStorageClient

public UcloudStorageClient(String storageUser,
                   String storagePass)

Creates a new instance.

Parameters:

storageUser - user id

storagePass - api key

Method Detail

readStorageAccount

public StorageAccount readStorageAccount()
                                  throws IOException

Retrieves a storage account.

Returns:

a storage account or null if failed.

Throws:

IOException - if an I/O error occurs.

readStorageContainers

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

Retrieves storage containers.

Parameters:

queryParameters - query parameters; null is allowed

storageContainers - the collection to which results are added

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs.

createStorageContainer

public boolean createStorageContainer(String containerName)
                               throws IOException

Creates a storage container named as given name.

Parameters:

containerName - the container name

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs.

readStorageContainer

public StorageContainer readStorageContainer(String containerName)
                                      throws IOException

Retrieves a storage container whose name is mapped to given container name.

Parameters:

containerName - the container name

Returns:

the mapped storage container or null if not found or failed

Throws:

IOException - if an I/O error occurs.

deleteStorageContainer

public boolean deleteStorageContainer(String containerName)
                               throws IOException

Deletes a storage container named as given container name.

Parameters:

containerName - the name of the storage container to delete

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs.

readStorageObjects

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

Reads objects information of a container.

Parameters:

containerName - the 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

readStorageObject

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

Throws:

IOException

deleteStorageObject

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

Deletes an object.

Parameters:

containerName - the container name

objectName - the object name

Returns:

true if succeeded; false otherwise

Throws:

IOException - if an I/O error occurs.

updateStorageContent

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

Updates or creates an storage 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

updateStorageContent

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

Updates an storage 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

updateStorageContent

public boolean updateStorageContent(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

readStorageContent

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

Reads the content of a storage object.

Parameters:

containerName - the container name

objectName - the object name

contentConsumer - the content consumer

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

getHeaderValues

public List<String> getHeaderValues(String headerName)

getFirstHeaderValue

public String getFirstHeaderValue(String headerName)