Package loci.common.services

Interface S3ClientService

All Superinterfaces:

Service

All Known Implementing Classes:

S3ClientServiceImpl

@Deprecated
public interface S3ClientService
extends Service

Deprecated.

The S3 implementations and services will be removed from the ome-common library in version 7.0.0

An S3 client

Method Summary

Modifier and Type	Method	Description
boolean	bucketExists(String bucket)	Deprecated. Check whether a bucket exists
InputStream	getObject(String bucket, String object, long offset)	Deprecated. Read an object
void	getObject(String bucket, String object, String filename)	Deprecated. Download an object
void	initialize(String server, int port, String accessKey, String secretKey, String appName, String appVersion)	Deprecated. Initialise the S3 client
S3ClientStat	statObject(String bucket, String object)	Deprecated. Stat the object

Method Detail

initialize

void initialize(String server,
                int port,
                String accessKey,
                String secretKey,
                String appName,
                String appVersion)
         throws S3ClientServiceException

Deprecated.

Initialise the S3 client

Parameters:

server - servername

port - port

accessKey - access key

secretKey - secret key

appName - user agent application name

appVersion - user agent application version

Throws:

S3ClientServiceException - if an S3 error occurred

bucketExists

boolean bucketExists(String bucket)
              throws S3ClientServiceException,
                     IOException

Deprecated.

Check whether a bucket exists

Parameters:

bucket - Bucket name

Returns:

true if bucket exists

Throws:

S3ClientServiceException - if an S3 error occurred

IOException - if an S3 error occurred

statObject

S3ClientStat statObject(String bucket,
                        String object)
                 throws S3ClientServiceException,
                        IOException

Deprecated.

Stat the object

Parameters:

bucket - Bucket name

object - Object path

Returns:

S3ClientStat object

Throws:

S3ClientServiceException - if an S3 error occurred

IOException - if an S3 error occurred

getObject

InputStream getObject(String bucket,
                      String object,
                      long offset)
               throws S3ClientServiceException,
                      IOException

Deprecated.

Read an object

Parameters:

bucket - Bucket name

object - Object path

offset - Start reading at this offset

Returns:

InputStream to the object

Throws:

S3ClientServiceException - if an S3 error occurred

IOException - if an S3 error occurred

getObject

void getObject(String bucket,
               String object,
               String filename)
        throws S3ClientServiceException,
               IOException

Deprecated.

Download an object

Parameters:

bucket - Bucket name

object - Object path

filename - Destination file

Throws:

S3ClientServiceException - if an S3 error occurred

IOException - if an S3 error occurred