software.amazon.awssdk.transfer.s3

Interface DownloadFileRequest.Builder

All Superinterfaces:

Buildable, CopyableBuilder<DownloadFileRequest.Builder,DownloadFileRequest>, SdkBuilder<DownloadFileRequest.Builder,DownloadFileRequest>

Enclosing class:

DownloadFileRequest

@NotThreadSafe
public static interface DownloadFileRequest.Builder
extends CopyableBuilder<DownloadFileRequest.Builder,DownloadFileRequest>

A builder for a DownloadFileRequest, created with DownloadFileRequest.builder()

Method Summary

Modifier and Type	Method and Description
default DownloadFileRequest.Builder	destination(File destination) The file that response contents will be written to.
DownloadFileRequest.Builder	destination(Path destination) The Path to file that response contents will be written to.
default DownloadFileRequest.Builder	getObjectRequest(Consumer<GetObjectRequest.Builder> getObjectRequestBuilder) The GetObjectRequest request that should be used for the download
DownloadFileRequest.Builder	getObjectRequest(GetObjectRequest getObjectRequest) The GetObjectRequest request that should be used for the download
default DownloadFileRequest.Builder	overrideConfiguration(Consumer<TransferRequestOverrideConfiguration.Builder> configurationBuilder) Similar to overrideConfiguration(TransferRequestOverrideConfiguration), but takes a lambda to configure a new TransferRequestOverrideConfiguration.Builder.
DownloadFileRequest.Builder	overrideConfiguration(TransferRequestOverrideConfiguration configuration) Add an optional request override configuration.

Methods inherited from interface software.amazon.awssdk.utils.builder.CopyableBuilder

copy

Methods inherited from interface software.amazon.awssdk.utils.builder.SdkBuilder

applyMutation, build

Method Detail

destination

DownloadFileRequest.Builder destination(Path destination)

The Path to file that response contents will be written to. The file must not exist or this method will throw an exception. If the file is not writable by the current user then an exception will be thrown.

Parameters:

destination - the destination path

Returns:

Returns a reference to this object so that method calls can be chained together.

destination

default DownloadFileRequest.Builder destination(File destination)

The file that response contents will be written to. The file must not exist or this method will throw an exception. If the file is not writable by the current user then an exception will be thrown.

Parameters:

destination - the destination path

Returns:

Returns a reference to this object so that method calls can be chained together.

getObjectRequest

DownloadFileRequest.Builder getObjectRequest(GetObjectRequest getObjectRequest)

The GetObjectRequest request that should be used for the download

Parameters:

getObjectRequest - the getObject request

Returns:

a reference to this object so that method calls can be chained together.

See Also:

getObjectRequest(Consumer)

getObjectRequest

default DownloadFileRequest.Builder getObjectRequest(Consumer<GetObjectRequest.Builder> getObjectRequestBuilder)

The GetObjectRequest request that should be used for the download

This is a convenience method that creates an instance of the GetObjectRequest builder avoiding the need to create one manually via GetObjectRequest.builder().

Parameters:

getObjectRequestBuilder - the getObject request

Returns:

a reference to this object so that method calls can be chained together.

See Also:

getObjectRequest(GetObjectRequest)

overrideConfiguration

DownloadFileRequest.Builder overrideConfiguration(TransferRequestOverrideConfiguration configuration)

Add an optional request override configuration.

Parameters:

configuration - The override configuration.

Returns:

This builder for method chaining.

overrideConfiguration

default DownloadFileRequest.Builder overrideConfiguration(Consumer<TransferRequestOverrideConfiguration.Builder> configurationBuilder)

Similar to overrideConfiguration(TransferRequestOverrideConfiguration), but takes a lambda to configure a new TransferRequestOverrideConfiguration.Builder. This removes the need to call TransferRequestOverrideConfiguration.builder() and TransferRequestOverrideConfiguration.Builder.build().

Parameters:

configurationBuilder - the upload configuration

Returns:

this builder for method chaining.

See Also:

overrideConfiguration(TransferRequestOverrideConfiguration)