software.amazon.awssdk.services.s3

Class S3Utilities

java.lang.Object

software.amazon.awssdk.services.s3.S3Utilities

@Immutable
public final class S3Utilities
extends Object

Utilities for working with Amazon S3 objects. An instance of this class can be created by:

1) Directly using the builder() method. You have to manually specify the configuration params like region, s3Configuration on the builder.

 S3Utilities utilities = S3Utilities.builder().region(Region.US_WEST_2).build()
 GetUrlRequest request = GetUrlRequest.builder().bucket("foo-bucket").key("key-without-spaces").build();
 URL url = utilities.getUrl(request);
 

2) Using the low-level client S3Client.utilities() method. This is recommended as SDK will use the same configuration from the S3Client object to create the S3Utilities object.

 S3Client s3client = S3Client.create();
 S3Utilities utilities = s3client.utilities();
 GetUrlRequest request = GetUrlRequest.builder().bucket("foo-bucket").key("key-without-spaces").build();
 URL url = utilities.getUrl(request);
 

Note: This class does not make network calls.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	S3Utilities.Builder Builder class to construct S3Utilities object

Method Summary

Modifier and Type	Method and Description
static S3Utilities.Builder	builder() Creates a builder for S3Utilities.
URL	getUrl(Consumer<GetUrlRequest.Builder> getUrlRequest) Returns the URL for an object stored in Amazon S3.
URL	getUrl(GetUrlRequest getUrlRequest) Returns the URL for an object stored in Amazon S3.

Methods inherited from class java.lang.Object

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

Method Detail

builder

public static S3Utilities.Builder builder()

Creates a builder for S3Utilities.

getUrl

public URL getUrl(Consumer<GetUrlRequest.Builder> getUrlRequest)

Returns the URL for an object stored in Amazon S3. If the object identified by the given bucket and key has public read permissions, then this URL can be directly accessed to retrieve the object's data.

If same configuration options are set on both #GetUrlRequest and #S3Utilities objects (for example: region), the configuration set on the #GetUrlRequest takes precedence.

This is a convenience which creates an instance of the GetUrlRequest.Builder avoiding the need to create one manually via GetUrlRequest.builder()

Parameters:

getUrlRequest - A Consumer that will call methods on GetUrlRequest.Builder to create a request.

Returns:

A URL for an object stored in Amazon S3.

Throws:

SdkException - Generated Url is malformed

getUrl

public URL getUrl(GetUrlRequest getUrlRequest)

Returns the URL for an object stored in Amazon S3. If the object identified by the given bucket and key has public read permissions, then this URL can be directly accessed to retrieve the object's data.

If same configuration options are set on both #GetUrlRequest and #S3Utilities objects (for example: region), the configuration set on the #GetUrlRequest takes precedence.

Parameters:

getUrlRequest - request to construct url

Returns:

A URL for an object stored in Amazon S3.

Throws:

SdkException - Generated Url is malformed