org.apache.hadoop.fs.s3a

Class S3ListResult

java.lang.Object

org.apache.hadoop.fs.s3a.S3ListResult

public class S3ListResult
extends Object

API version-independent container for S3 List responses.

Constructor Summary

Constructors

Modifier	Constructor and Description
protected	S3ListResult(com.amazonaws.services.s3.model.ObjectListing v1, com.amazonaws.services.s3.model.ListObjectsV2Result v2)

Method Summary

Modifier and Type	Method and Description
List<String>	getCommonPrefixes()
List<com.amazonaws.services.s3.model.S3ObjectSummary>	getObjectSummaries()
com.amazonaws.services.s3.model.ObjectListing	getV1()
com.amazonaws.services.s3.model.ListObjectsV2Result	getV2()
boolean	hasPrefixesOrObjects() Does this listing have prefixes or objects?
boolean	isTruncated()
boolean	isV1() Is this a v1 API result or v2?
void	logAtDebug(org.slf4j.Logger log) Dump the result at debug level.
boolean	representsEmptyDirectory(String dirKey) Does this listing represent an empty directory?
static S3ListResult	v1(com.amazonaws.services.s3.model.ObjectListing result) Restricted constructors to ensure v1 or v2, not both.
static S3ListResult	v2(com.amazonaws.services.s3.model.ListObjectsV2Result result) Restricted constructors to ensure v1 or v2, not both.

Methods inherited from class java.lang.Object

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

Constructor Detail

S3ListResult

protected S3ListResult(com.amazonaws.services.s3.model.ObjectListing v1,
                       com.amazonaws.services.s3.model.ListObjectsV2Result v2)

Method Detail

v1

public static S3ListResult v1(com.amazonaws.services.s3.model.ObjectListing result)

Restricted constructors to ensure v1 or v2, not both.

Parameters:

result - v1 result

Returns:

new list result container

v2

public static S3ListResult v2(com.amazonaws.services.s3.model.ListObjectsV2Result result)

Restricted constructors to ensure v1 or v2, not both.

Parameters:

result - v2 result

Returns:

new list result container

isV1

public boolean isV1()

Is this a v1 API result or v2?

Returns:

true if v1, false if v2

getV1

public com.amazonaws.services.s3.model.ObjectListing getV1()

getV2

public com.amazonaws.services.s3.model.ListObjectsV2Result getV2()

getObjectSummaries

public List<com.amazonaws.services.s3.model.S3ObjectSummary> getObjectSummaries()

isTruncated

public boolean isTruncated()

getCommonPrefixes

public List<String> getCommonPrefixes()

hasPrefixesOrObjects

public boolean hasPrefixesOrObjects()

Does this listing have prefixes or objects?

Returns:

true if the result is non-empty

representsEmptyDirectory

public boolean representsEmptyDirectory(String dirKey)

Does this listing represent an empty directory?

Parameters:

dirKey - directory key

Returns:

true if the list is considered empty.

logAtDebug

public void logAtDebug(org.slf4j.Logger log)

Dump the result at debug level.

Parameters:

log - log to use