Package com.exasol.bucketfs

Class ReadEnabledBucket

java.lang.Object

com.exasol.bucketfs.ReadEnabledBucket

All Implemented Interfaces:

ReadOnlyBucket

Direct Known Subclasses:

WriteEnabledBucket

public class ReadEnabledBucket
extends Object
implements ReadOnlyBucket

Bucket that support read access like listing contents and downloading files.

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static class	ReadEnabledBucket.Builder<T extends ReadEnabledBucket.Builder<T>>	Builder for ReadEnabledBucket objects.

Field Summary

Fields

Modifier and Type	Field	Description
protected String	bucketFsName
protected String	bucketName
protected HttpClient	client
protected String	ipAddress
protected int	port
protected String	readPassword
protected Map<String,Instant>	uploadHistory

Constructor Summary

Constructors

Modifier	Constructor	Description
protected	ReadEnabledBucket(ReadEnabledBucket.Builder<? extends ReadEnabledBucket.Builder<?>> builder)

Method Summary

Modifier and Type	Method	Description
static ReadEnabledBucket.Builder<? extends ReadEnabledBucket.Builder<?>>	builder()
void	downloadFile(String pathInBucket, Path localPath)	Download a file from a bucket to a local filesystem.
String	downloadFileAsString(String pathInBucket)	Download a file from a bucket into a string.
protected void	evaluateRequestStatus(URI uri, BucketOperation operation, int statusCode)
protected String	extendPathInBucketDownToFilename(Path localPath, String pathInBucket)
String	getBucketFsName()
String	getBucketName()
String	getFullyQualifiedBucketName()	Get the fully qualified name of the bucket.
String	getReadPassword()	Get the read password for the bucket.
List<String>	listContents()	List the contents of a bucket.
List<String>	listContents(String path)	List the contents of a path inside a bucket.
String	toString()

Methods inherited from class java.lang.Object

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

Field Detail

bucketFsName

protected final String bucketFsName

bucketName

protected final String bucketName

ipAddress

protected final String ipAddress

port

protected final int port

readPassword

protected final String readPassword

client

protected final HttpClient client

uploadHistory

protected final Map<String,Instant> uploadHistory

Constructor Detail

ReadEnabledBucket

protected ReadEnabledBucket(ReadEnabledBucket.Builder<? extends ReadEnabledBucket.Builder<?>> builder)

Method Detail

getBucketFsName

public String getBucketFsName()

Specified by:

getBucketFsName in interface ReadOnlyBucket

Returns:

name of the BucketFS filesystem this bucket belongs to

getBucketName

public String getBucketName()

Specified by:

getBucketName in interface ReadOnlyBucket

Returns:

name of the bucket

getFullyQualifiedBucketName

public String getFullyQualifiedBucketName()

Description copied from interface: ReadOnlyBucket

Get the fully qualified name of the bucket.

Specified by:

getFullyQualifiedBucketName in interface ReadOnlyBucket

Returns:

fully qualified name consisting of service name and bucket name

getReadPassword

public String getReadPassword()

Description copied from interface: ReadOnlyBucket

Get the read password for the bucket.

Specified by:

getReadPassword in interface ReadOnlyBucket

Returns:

read password

listContents

public List<String> listContents()
                          throws BucketAccessException

Description copied from interface: ReadOnlyBucket

List the contents of a bucket.

Specified by:

listContents in interface ReadOnlyBucket

Returns:

bucket contents

Throws:

BucketAccessException - if the contents are not accessible or the path is invalid

listContents

public List<String> listContents(String path)
                          throws BucketAccessException

Description copied from interface: ReadOnlyBucket

List the contents of a path inside a bucket.

Specified by:

listContents in interface ReadOnlyBucket

Parameters:

path - relative path from the bucket root

Returns:

list of file system entries

Throws:

BucketAccessException - if the contents are not accessible or the path is invalid

extendPathInBucketDownToFilename

protected String extendPathInBucketDownToFilename(Path localPath,
                                                  String pathInBucket)

downloadFile

public void downloadFile(String pathInBucket,
                         Path localPath)
                  throws BucketAccessException

Description copied from interface: ReadOnlyBucket

Download a file from a bucket to a local filesystem.

Specified by:

downloadFile in interface ReadOnlyBucket

Parameters:

pathInBucket - path of the file in BucketFS

localPath - local path the file is downloaded to

Throws:

BucketAccessException - if the local file does not exist or is not accessible or if the download failed

downloadFileAsString

public String downloadFileAsString(String pathInBucket)
                            throws BucketAccessException

Description copied from interface: ReadOnlyBucket

Download a file from a bucket into a string.

Specified by:

downloadFileAsString in interface ReadOnlyBucket

Parameters:

pathInBucket - path of the file in BucketFS

Returns:

file contents as string

Throws:

BucketAccessException - if the local file does not exist or is not accessible or if the download failed

evaluateRequestStatus

protected void evaluateRequestStatus(URI uri,
                                     BucketOperation operation,
                                     int statusCode)
                              throws BucketAccessException

Throws:

BucketAccessException

toString

public String toString()

Overrides:

toString in class Object

builder

public static ReadEnabledBucket.Builder<? extends ReadEnabledBucket.Builder<?>> builder()