Upload Files to Amazon S3 Buckets in Spring Boot

  • Last updated Apr 25, 2024

In Amazon S3, files or any other data are stored as objects in buckets. A bucket is nothing but a logical container for objects in S3.

Follow these steps to upload files to an Amazon S3 bucket in a Spring Boot application:

  1. Create a Spring Boot Project:
  2. We assume you have a Spring Boot project set up and ready. If not, you can create one using Spring Initializr or your preferred approach.

  3. Add Amazon SDK Dependencies:
  4. Add the AWS Java SDK For Amazon S3 dependency to your Spring Boot project:

    implementation group: 'com.amazonaws', name: 'aws-java-sdk-s3', version: '1.12.556'
  5. Add Configurations:
  6. To access S3 bucket from a Spring Boot project, you'll need to configure your project with AWS credentials. You can do this by providing your AWS access key and secret key, which can be set in your application.properties or application.yml file or loaded from environment variables. For example, in your application.properties file:

    aws.access-key = your-aws-access-key
    aws.access-secret-key = your-aws-secret-key
    aws.region = us-east-1
  7. Create an AmazonS3Client:
  8. Create a bean for the AmazonS3 client in your Spring Boot application configuration class. You can use the @Configuration annotation to create a configuration class:

    package com.example.app.config;
    import org.springframework.beans.factory.annotation.Value;
    import org.springframework.context.annotation.Bean;
    import org.springframework.context.annotation.Configuration;
    import com.amazonaws.auth.AWSStaticCredentialsProvider;
    import com.amazonaws.auth.BasicAWSCredentials;
    import com.amazonaws.services.s3.AmazonS3;
    import com.amazonaws.services.s3.AmazonS3ClientBuilder;
    public class AmazonS3Config {
      private String awsAccessKey;
      private String awsAccessSecretKey;
      private String awsRegion;
      public AmazonS3Config(@Value(value = "${aws.access-key}") String awsAccessKey,
          @Value(value = "${aws.access-secret-key}") String awsAccessSecretKey,
          @Value(value = "${aws.region}") String awsRegion) {
        this.awsAccessKey = awsAccessKey;
        this.awsAccessSecretKey = awsAccessSecretKey;
        this.awsRegion = awsRegion;
      public AWSStaticCredentialsProvider getAwsCredentialsProvider() {
        BasicAWSCredentials awsCred =
            new BasicAWSCredentials(this.awsAccessKey, this.awsAccessSecretKey);
        return new AWSStaticCredentialsProvider(awsCred);
      public AmazonS3 getAmazonS3Client() {
        return AmazonS3ClientBuilder.standard().withRegion(this.awsRegion)
  9. Create a Service:
  10. Create a service interface named S3FileUploadService with a method for uploading files to your S3 bucket:

    package com.example.app.service;
    import java.util.Map;
    import org.springframework.web.multipart.MultipartFile;
    public interface S3FileUploadService {
      Map<String, String> uploadFileToS3(MultipartFile multipartfile);
  11. Create a Service Implementation:
  12. Create an implementation class that implements the S3FileUploadService interface and handles the business logic. Let's create a class called S3FileUploadServiceImpl:

    package com.example.app.service.impl;
    import java.io.File;
    import java.io.FileNotFoundException;
    import java.io.FileOutputStream;
    import java.io.IOException;
    import java.util.HashMap;
    import java.util.Map;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.stereotype.Service;
    import org.springframework.web.multipart.MultipartFile;
    import com.amazonaws.services.s3.AmazonS3;
    import com.amazonaws.services.s3.model.CannedAccessControlList;
    import com.amazonaws.services.s3.model.PutObjectRequest;
    import com.example.app.service.S3FileUploadService;
    public class S3FileUploadServiceImpl implements S3FileUploadService {
      private String s3BaseUrl = "https://s3-us-east-1.s3.amazonaws.com/";
      private String bucketName = "my-test-bucket";
      private String folderName = "/myfolder/images/";
      private AmazonS3 s3Client;
      public Map<String, String> uploadFileToS3(MultipartFile multipartfile) {
        Map<String, String> response = new HashMap<>();
        if (multipartfile != null && !multipartfile.isEmpty()) {
          String filePathName = multipartfile.getOriginalFilename();
          File file = new File(filePathName);
          try (FileOutputStream fos = new FileOutputStream(file)) {
            if (!file.exists()) {
            /* uploading file to S3 */
            s3Client.putObject(new PutObjectRequest(bucketName, folderName + "/" + file.getName(), file)
            /* Url location of the uploaded file in S3. You should save it in database */
            String s3FileAccessUrl = s3BaseUrl.concat(bucketName).concat(folderName)
                .concat(file.getName()).replaceAll("\\s", "+");
            response.put("fileUrl", s3FileAccessUrl);
          } catch (FileNotFoundException e) {
          } catch (IOException e) {
        return response;
  13. Create a Web Controller:
  14. Create a controller class named S3FileUploadController. It will handle HTTP requests and interact with the S3FileUploadService to upload files to your S3 bucket:

    package com.example.app.controller;
    import java.util.Map;
    import org.springframework.beans.factory.annotation.Autowired;
    import org.springframework.http.ResponseEntity;
    import org.springframework.web.bind.annotation.PostMapping;
    import org.springframework.web.bind.annotation.RequestMapping;
    import org.springframework.web.bind.annotation.RequestPart;
    import org.springframework.web.bind.annotation.RestController;
    import org.springframework.web.multipart.MultipartFile;
    import com.example.app.service.S3FileUploadService;
    @RequestMapping(path = "/files")
    public class S3FileUploadController {
      private S3FileUploadService s3FileUploadService;
      @PostMapping(value = "/upload")
      public ResponseEntity<Map<String, String>> uploadFile(
          @RequestPart(name = "multipartfile", required = true) MultipartFile multipartfile) {
        return ResponseEntity.ok(s3FileUploadService.uploadFileToS3(multipartfile));