org.apache.hadoop.fs.s3a

Class S3AReadOpContext

java.lang.Object

org.apache.hadoop.fs.s3a.S3AOpContext

org.apache.hadoop.fs.s3a.S3AReadOpContext

public class S3AReadOpContext
extends S3AOpContext

Read-specific operation context struct.

Field Summary

Fields inherited from class org.apache.hadoop.fs.s3a.S3AOpContext

dstFileStatus

Constructor Summary

Constructors

Constructor and Description
S3AReadOpContext(org.apache.hadoop.fs.Path path, boolean isS3GuardEnabled, Invoker invoker, Invoker s3guardInvoker, org.apache.hadoop.fs.FileSystem.Statistics stats, S3AInstrumentation instrumentation, org.apache.hadoop.fs.FileStatus dstFileStatus, S3AInputPolicy inputPolicy, ChangeDetectionPolicy changeDetectionPolicy, long readahead) Instantiate.

Method Summary

Modifier and Type	Method and Description
ChangeDetectionPolicy	getChangeDetectionPolicy()
S3AInputPolicy	getInputPolicy() Get the IO policy.
org.apache.hadoop.fs.Path	getPath() Get the path of this read.
long	getReadahead() Get the readahead for this operation.
Invoker	getReadInvoker() Get invoker to use for read operations.
String	toString()

Methods inherited from class org.apache.hadoop.fs.s3a.S3AOpContext

getDstFileStatus, getInstrumentation, getInvoker, getS3guardInvoker, getStats, isS3GuardEnabled

Methods inherited from class java.lang.Object

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

Constructor Detail

S3AReadOpContext

public S3AReadOpContext(org.apache.hadoop.fs.Path path,
                        boolean isS3GuardEnabled,
                        Invoker invoker,
                        Invoker s3guardInvoker,
                        @Nullable
                        org.apache.hadoop.fs.FileSystem.Statistics stats,
                        S3AInstrumentation instrumentation,
                        org.apache.hadoop.fs.FileStatus dstFileStatus,
                        S3AInputPolicy inputPolicy,
                        ChangeDetectionPolicy changeDetectionPolicy,
                        long readahead)

Instantiate.

Parameters:

path - path of read

isS3GuardEnabled - true iff S3Guard is enabled.

invoker - invoker for normal retries.

s3guardInvoker - S3Guard-specific retry invoker.

stats - statistics (may be null)

instrumentation - FS instrumentation

dstFileStatus - target file status

inputPolicy - the input policy

readahead - readahead for GET operations/skip, etc.

changeDetectionPolicy - change detection policy.

Method Detail

getReadInvoker

public Invoker getReadInvoker()

Get invoker to use for read operations. When S3Guard is enabled we use the S3Guard invoker, which deals with things like FileNotFoundException differently.

Returns:

invoker to use for read codepaths

getPath

public org.apache.hadoop.fs.Path getPath()

Get the path of this read.

Returns:

path.

getInputPolicy

public S3AInputPolicy getInputPolicy()

Get the IO policy.

Returns:

the initial input policy.

getChangeDetectionPolicy

public ChangeDetectionPolicy getChangeDetectionPolicy()

getReadahead

public long getReadahead()

Get the readahead for this operation.

Returns:

a value >= 0

toString

public String toString()

Overrides:

toString in class Object