org.apache.iceberg.aws.s3

Class S3OutputFile

java.lang.Object

org.apache.iceberg.aws.s3.S3OutputFile

All Implemented Interfaces:

OutputFile

public class S3OutputFile
extends java.lang.Object
implements OutputFile

Constructor Summary

Constructors

Constructor and Description
S3OutputFile(software.amazon.awssdk.services.s3.S3Client client, org.apache.iceberg.aws.s3.S3URI uri)
S3OutputFile(software.amazon.awssdk.services.s3.S3Client client, org.apache.iceberg.aws.s3.S3URI uri, AwsProperties awsProperties)

Method Summary

Modifier and Type	Method and Description
AwsProperties	awsProperties()
PositionOutputStream	create() Create an output stream for the specified location if the target object does not exist in S3 at the time of invocation.
PositionOutputStream	createOrOverwrite() Create a new file and return a PositionOutputStream to it.
boolean	exists() Note: this may be stale if file was deleted since metadata is cached for size/existence checks.
protected software.amazon.awssdk.services.s3.model.HeadObjectResponse	getObjectMetadata()
java.lang.String	location()
InputFile	toInputFile() Return an InputFile for the location of this output file.
java.lang.String	toString()

Methods inherited from class java.lang.Object

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

Methods inherited from interface org.apache.iceberg.io.OutputFile

location

Constructor Detail

S3OutputFile

public S3OutputFile(software.amazon.awssdk.services.s3.S3Client client,
                    org.apache.iceberg.aws.s3.S3URI uri)

S3OutputFile

public S3OutputFile(software.amazon.awssdk.services.s3.S3Client client,
                    org.apache.iceberg.aws.s3.S3URI uri,
                    AwsProperties awsProperties)

Method Detail

create

public PositionOutputStream create()

Create an output stream for the specified location if the target object does not exist in S3 at the time of invocation.

Specified by:

create in interface OutputFile

Returns:

output stream

createOrOverwrite

public PositionOutputStream createOrOverwrite()

Description copied from interface: OutputFile

Create a new file and return a PositionOutputStream to it.

If the file already exists, this will not throw an exception and will replace the file.

Specified by:

createOrOverwrite in interface OutputFile

Returns:

an output stream that can report its position

toInputFile

public InputFile toInputFile()

Description copied from interface: OutputFile

Return an InputFile for the location of this output file.

Specified by:

toInputFile in interface OutputFile

Returns:

an input file for the location of this output file

location

public java.lang.String location()

awsProperties

public AwsProperties awsProperties()

exists

public boolean exists()

Note: this may be stale if file was deleted since metadata is cached for size/existence checks.

Returns:

flag

getObjectMetadata

protected software.amazon.awssdk.services.s3.model.HeadObjectResponse getObjectMetadata()
                                                                                 throws software.amazon.awssdk.services.s3.model.S3Exception

Throws:

software.amazon.awssdk.services.s3.model.S3Exception

toString

public java.lang.String toString()

Overrides:

toString in class java.lang.Object