Uploading and Downloading Files with Spring Boot

author-image   By Dhiraj,   19 August, 2019 4K

In this tutorial, we will learn different ways with which we can upload and download files such as pdf, .zip file or images with spring boot and REST. The implementation will have examples to upload and download single and multiple files. While uploading, we will have choices to either save the uploaded file in the local file system with Resource provided in Spring framework or save it to the database. We will be using MySql for this quick tutorial.

While downloading multiple files, we will also have an implementation to zip all the files in a single unit and then download it from the spring boot server. We will also look into how to send extra params with form data while uploading the files.

At the end, we will test our example with Postman.

Spring Boot Project Setup

Head over to https://start.spring.io to generate our spring boot demo project with below artifacts.


Below is our pom.xml for those who have generated their project already.



Spring Boot File Upload Configuration

Below are the multipart configurations required in application.properties to enable file uploading in a Spring Boot app.


max-file-size - It specifies the maximum size permitted for uploaded files. The default is 1MB.

max-request-size - It specifies the maximum size allowed for multipart/form-data requests. The default is 10MB.

spring.servlet.multipart.enabled - Whether to enable support of multipart uploads.

Spring Boot File Upload

In this section, we will provide the different options of uploading the files in a spring boot app with suitable examples.

Single File Upload to Local File System in Spring Boot Rest

In this case, the file is sent as using Form data and the same is retrieved in the Spring controller Rest as a Multipart file. It is a representation of an uploaded file received in a multipart request.

In the below implementation, we are Copying all bytes from an input stream to a file. By default, the copy fails if the target file already exists or is a symbolic link. Hence, we are using standard copy option as REPLACE_EXISTING.

Once, this process is completed, the response will be the download URL of the file. We will discuss the file download in a moment.

public ResponseEntity uploadToLocalFileSystem(@RequestParam("file") MultipartFile file) {
	String fileName = StringUtils.cleanPath(file.getOriginalFilename());
	Path path = Paths.get(fileBasePath + fileName);
	try {
		Files.copy(file.getInputStream(), path, StandardCopyOption.REPLACE_EXISTING);
	} catch (IOException e) {
	String fileDownloadUri = ServletUriComponentsBuilder.fromCurrentContextPath()
	return ResponseEntity.ok(fileDownloadUri);

Below is the sample request that we can make to test this functionality from Postman. You can also use javascript or any other JS library to test it.


Multiple File Uploads to Local File System in Spring Boot Rest

The multiple files upload internally invokes above method to repeat the single file upload. We can also have a functionality to upload a .zip file from the client and in the server-side, we can unzip it and save it in our local file system individually.

public ResponseEntity multiUpload(@RequestParam("files") MultipartFile[] files) {
	List<Object> fileDownloadUrls = new ArrayList<>();
			.forEach(file -> fileDownloadUrls.add(uploadToLocalFileSystem(file).getBody()));
	return ResponseEntity.ok(fileDownloadUrls);

Below is the screenshot of Postman to test this multiple file upload.


Adding Extra Parameters with FileUpload

To add an extra parameter with file upload, we can append that extra parameter in the form data at the client-side and the same can be retrieved as a request param at the server-side. Below is an example where we appended the key as extraParam in the form data at client-side.

public ResponseEntity uploadWithExtraParams(@RequestParam("file") MultipartFile file, @RequestParam String extraParam) {
	logger.info("Extra param " + extraParam);
	return uploadToLocalFileSystem(file);

uploadToLocalFileSystem() is the same method that we defined above.

Spring Boot File Upload to Database

For this, we need to have a database configuration first. Spring boot provides a very convenient way to do so by adding a few properties in application.properties. We will be using spring data JPA for our purpose.


To save the uploaded file in the DB, we have a model class and we are using byte[] as a data type to save it in the DB.

public class Document {

    @GeneratedValue(strategy = GenerationType.IDENTITY)
    private Long id;

    private String docName;

    private byte[] file;


Below is the REST implementation for this. The implementation is similar to above logic except it has a DB call to save the file instead of saving it to the local file system.

public ResponseEntity uploadToDB(@RequestParam("file") MultipartFile file) {
	Document doc = new Document();
	String fileName = StringUtils.cleanPath(file.getOriginalFilename());
	try {
	} catch (IOException e) {
	String fileDownloadUri = ServletUriComponentsBuilder.fromCurrentContextPath()
	return ResponseEntity.ok(fileDownloadUri);

File Download in Spring Boot

Spring Boot File Download from Local File System

You have already noticed the response of the file upload. It is a simple GET URL and on the click of that URL the file will be downloaded automatically in the browser as we will be adding Content-Disposition in the response header as an attachment and the content type as application/octet-stream.

Below is the example:

public ResponseEntity downloadFileFromLocal(@PathVariable String fileName) {
	Path path = Paths.get(fileBasePath + fileName);
	Resource resource = null;
	try {
		resource = new UrlResource(path.toUri());
	} catch (MalformedURLException e) {
	return ResponseEntity.ok()
			.header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + resource.getFilename() + "\"")

Spring Boot File Download from Database

The below implementation only difers in the process of getting the file from databse rather then a file system.

public ResponseEntity downloadFromDB(@PathVariable String fileName) {
	Document document = documentDao.findByDocName(fileName);
	return ResponseEntity.ok()
			.header(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + fileName + "\"")

Zip Multiple Files and Download

While downloading multiple files, we can create a zip file in spring boot and download that zip file alone rather then downloading multiple files individually. For this purpose, we first need to create a zip file in spring boot and then set the content type as application/zip to download the zip file.

Here, we will be using ZipOutputStream from java.util.zip package to create the .zip file. Below is the example.

@GetMapping(value = "/zip-download", produces="application/zip")
public void zipDownload(@RequestParam List<String> name, HttpServletResponse response) throws IOException {
	ZipOutputStream zipOut = new ZipOutputStream(response.getOutputStream());
	for (String fileName : name) {
		FileSystemResource resource = new FileSystemResource(fileBasePath + fileName);
		ZipEntry zipEntry = new ZipEntry(resource.getFilename());
		StreamUtils.copy(resource.getInputStream(), zipOut);
	response.addHeader(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + zipFileName + "\"");

To test this functionality, we can make a GET request with name as a query parameter which includes all the file names that we want to be included in the final .zip file.


Spring Boot File Upload with React and Angular

We tested the above implementation with Postman. But in my previous tutorial, we have created other tutorials to achieve the same functionality with popular Javascript framework and library.

You can follow this article to implement the file uploading client with Angular and this tutorial with React Js.


In this article, we disussed about different ways to upload and download files and images with spring boot REST and tested with Postman.

If You Appreciate This, You Can Consider:

  • Like us at: Facebook or follow us at Twitter
  • Share this article on social media or with your teammates.
  • We are thankful for your never ending support.

About The Author


I am an energetic professional who enjoys the challenges involved in working with people and resolving real-time problems. Technical expertise in building highly scalable, distributed and self-healing cloud applications. Technical Skills: Java/J2EE, Spring Framework, Hibernate, Angular, Reactive Programming, Microservices, Rest APIs, Kafka, ELK, etc.

Further Reading on Spring Boot

1 File Upload React Spring Rest

2 File Upload Angularjs Spring Boot Rest

3 Spring Boot Multiple Database Configuration

4 Spring Boot H2 Database Example

5 Spring Data Jpa Example

6 Spring Boot Jms Activemq Example