Partner – Moderne – NPI EA (cat=Spring Boot)
announcement - icon

Refactor Java code safely — and automatically — with OpenRewrite.

Refactoring big codebases by hand is slow, risky, and easy to put off. That’s where OpenRewrite comes in. The open-source framework for large-scale, automated code transformations helps teams modernize safely and consistently.

Each month, the creators and maintainers of OpenRewrite at Moderne run live, hands-on training sessions — one for newcomers and one for experienced users. You’ll see how recipes work, how to apply them across projects, and how to modernize code with confidence.

Join the next session, bring your questions, and learn how to automate the kind of work that usually eats your sprint time.

Course – Black Friday 2026 – NPI EA – main – before_post_content
announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW

Course – Black Friday 2026 – NPI – main – before_post_content
announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW

1. Introduction

In this tutorial, we’ll explore how to check if a specified key exists in an Amazon S3 bucket using Java.

S3 is a popular cloud storage service that provides a scalable, secure, and highly available platform for storing and retrieving data.

It’s essential for developers to know that a specific key exists to manipulate or access it as needed. We’ll walk through the steps required to set up the AWS SDK and use it to perform this check.

2. Maven Dependencies

Before we get started, we need to declare the AWS S3 SDK dependency in our project’s pom.xml:

<dependency>
    <groupId>software.amazon.awssdk</groupId>
    <artifactId>s3</artifactId>
    <version>2.24.9</version>
</dependency>

3. Create an Instance of the AmazonS3 Client

Once we have the AWS SDK for Java set up, we create an instance of the AmazonS3 client to interact with a bucket.

Let’s specify the AWS credentials and the bucket location region and create the client:

AmazonS3 s3Client = AmazonS3ClientBuilder.standard()
  .withRegion(Regions.US_EAST_1)
  .withCredentials(new AWSStaticCredentialsProvider(credentials))
  .build();

4. Check if the Key Exists With headObject()

The easiest and most obvious way to check if a specific key exists in the S3 bucket is to use the headObject() method.

We need to create a HeadObjectRequest instance using its builder method and pass the bucket name and the object key to it. Then we can pass the request object to the headObject() method.

try {
    HeadObjectRequest headObjectRequest = HeadObjectRequest.builder()
        .bucket(bucket)
        .key(key)
        .build();

    s3Client.headObject(headObjectRequest);

    System.out.println("Object exists");
    return true;
} catch (S3Exception e) {
    if (e.statusCode() == 404) {
        System.out.println("Object does not exist");
        return false;
    } else {
        throw e;
    }
}

This method checks if an object exists at the specified bucket location and returns a HeadObjectResponse object containing the object metadata. If the specified key does not exist then the method throws NoSuchKeyException.

5. Check if the Key Exists With listObjectsV2()

Another option is to use the listObjectsV2() method. For that, we need to create a ListObjectsV2Request object and pass the bucket name to it. Next, we call the listObjectsV2 method to get back a ListObjectsV2Response. We can then iterate through the contents of the response to check if the desired key is present:

public boolean doesObjectExistByListObjects(String bucketName, String key) {
    ListObjectsV2Request listObjectsV2Request = ListObjectsV2Request.builder()
        .bucket(bucketName)
        .build();
    ListObjectsV2Response listObjectsV2Response = s3Client.listObjectsV2(listObjectsV2Request);

    return listObjectsV2Response.contents()
        .stream()
        .filter(s3ObjectSummary -> s3ObjectSummary.getValueForField("key", String.class)
            .equals(key))
        .findFirst()
        .isPresent();
}

While this method may be less efficient than headObject(), it can be helpful when those options are unavailable.

Additionally, listObjectsV2() has the added benefit of allowing us to list multiple objects simultaneously. It may be helpful in specific scenarios.

However, this method can be slower and less efficient due to many iterations. It’s crucial to weigh the tradeoffs and choose the best option for the use case.

6. Conclusion

In this article, we’ve explored several ways to check if a specific key exists in an S3 bucket using AWS SDK for Java.

We’ve learned how to set up the AmazonS3 client and use the headObject() method to check for the existence of a key. We’ve also explored listObjects() methods as alternatives.

Each approach has its advantages and disadvantages, and the choice of which one to use will depend on the specific requirements of the use case.

The code backing this article is available on GitHub. Once you're logged in as a Baeldung Pro Member, start learning and coding on the project.
Partner – Moderne – NPI EA (tag=Refactoring)
announcement - icon

Modern Java teams move fast — but codebases don’t always keep up. Frameworks change, dependencies drift, and tech debt builds until it starts to drag on delivery. OpenRewrite was built to fix that: an open-source refactoring engine that automates repetitive code changes while keeping developer intent intact.

The monthly training series, led by the creators and maintainers of OpenRewrite at Moderne, walks through real-world migrations and modernization patterns. Whether you’re new to recipes or ready to write your own, you’ll learn practical ways to refactor safely and at scale.

If you’ve ever wished refactoring felt as natural — and as fast — as writing code, this is a good place to start.

Course – Black Friday 2026 – NPI EA – main – after_post_content

announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW

Course – Black Friday 2026 – NPI – main – after_post_content

announcement - icon

Yes, we're now running our Black Friday Sale. All Courses are 33% off until 1st December, 2026 at 17:00 Romania time:

>> EXPLORE ACCESS NOW