public abstract class CloudStorageConfiguration
Configuration for CloudStorageFileSystem instances.
Static Fields
DEFAULT
public static final CloudStorageConfiguration DEFAULT
Type | Description |
CloudStorageConfiguration |
Static Methods
builder()
public static CloudStorageConfiguration.Builder builder()
Creates a new builder, initialized with the following settings:
- Performing I/O on paths with extra slashes, e.g.
a//b
will throw an error. - The prefix slash on absolute paths will be removed when converting to an object name.
- Pseudo-directories are enabled, so any path with a trailing slash is a fake directory.
- Channel re-opens are disabled.
Type | Description |
CloudStorageConfiguration.Builder |
Methods
blockSize()
public abstract int blockSize()
Returns block size (in bytes) used when talking to the Google Cloud Storage HTTP server.
Type | Description |
int |
maxChannelReopens()
public abstract int maxChannelReopens()
Returns the number of times we try re-opening a channel if it's closed unexpectedly while reading.
Type | Description |
int |
permitEmptyPathComponents()
public abstract boolean permitEmptyPathComponents()
Returns true
if we shouldn't throw an exception when encountering object names
containing superfluous slashes, e.g. a//b
.
Type | Description |
boolean |
reopenableExceptions()
public abstract ImmutableList<Class<? extends Exception>> reopenableExceptions()
Returns the set of exceptions for which we'll try a channel reopen if maxChannelReopens is positive.
Type | Description |
com.google.common.collect.ImmutableList<Class<? extends java.lang.Exception>> |
retryableHttpCodes()
public abstract ImmutableList<Integer> retryableHttpCodes()
Returns the set of HTTP error codes that will be retried, in addition to the normally retryable ones.
Type | Description |
com.google.common.collect.ImmutableList<Integer> |
stripPrefixSlash()
public abstract boolean stripPrefixSlash()
Returns true
if '/' prefix on absolute object names should be removed before I/O.
If you disable this feature, please take into consideration that all paths created from a URI will have the leading slash.
Type | Description |
boolean |
usePseudoDirectories()
public abstract boolean usePseudoDirectories()
Returns true
if directories and paths with a trailing slash should be treated as fake
directories.
With this feature, if file "foo/bar.txt" exists then both "foo" and "foo/" will be treated as if they were existing directories. On path construction no I/O will be performed, bucket and "directory" will treated as if they exist.
Type | Description |
boolean |
useUserProjectOnlyForRequesterPaysBuckets()
public abstract boolean useUserProjectOnlyForRequesterPaysBuckets()
Returns whether userProject will be cleared for non-requester-pays buckets. That is, if false (the default value), setting userProject causes that project to be billed regardless of whether the bucket is requester-pays or not. If true, setting userProject will only cause that project to be billed when the project is requester-pays.
Setting this will cause the bucket to be accessed when the CloudStorageFileSystem object is created.
Type | Description |
boolean |
userProject()
public abstract String userProject()
Returns the project to be billed when accessing buckets. Leave empty for normal semantics, set to bill that project (project you own) for all accesses. This is required for accessing requester-pays buckets. This value cannot be null.
Type | Description |
String |
workingDirectory()
public abstract String workingDirectory()
Returns path of current working directory. This defaults to the root directory.
Type | Description |
String |