Spring Boot file upload download rest api 예제 - 1

📁 스프링 부트로 파일 업로드 다운로드 구현 방법

 

첫 회사의 수습과제로 파일 업로드 다운로드 기능을 만든 적이 있는데 검색을 하면 JSP로 구현된 예제가 많아서 프론트가 React나 Vue일때 어떻게 파일 업로드 다운로드 구현해야 하는지 막막했었다. 다행이 깃허브에서 잘 정리된 코드를 찾아서 과제를 잘 마무리 할 수 있었지만 해당 깃허브 예제를 참고해서 구현 할 때 아쉬웠던 점과 그때는 잘 몰랐던 것들을 정리해보려고 한다. 

 

 

1️⃣ Failed to perform cleanup of multipart items 에러 처리 방법

• 스프링 부트 버전 변경에서 inputStream.close() 추가하는 걸로 수정

- Caused by: java.io.IOException: Cannot delete 경로\파일이름

참고한 깃허브 코드를 사용해서 파일 업로드를 하려고 하면 위와 같은 에러가 계속 떴는데 해결 방법을 찾지 못해서 스프링 부트 버전을 낮춰서 구현했다. 하지만 최근에 파일 업로드 기능을 만들면서 또 이 오류를 만났고 이번에는 버전을 낮추는 방법으로 문제를 해결하고 싶지 않았다. 문제원인을 찾아보니 열려있는 inputStream의 문제인 것 같아서 기존 

file.getIntputStream() 부분을 InputStream 객체에 담았다가 Files.copy가 끝난 후에 .close()로 닫아주니 버전을 낮추지 않아도 스프링 부트 2.7.8 버전에서도 오류없이 파일이 잘 저장되었다. 

수정한 코드는 file.getInputStream()를 변수에 담고 다시 close 해주었다

 

 

2️⃣ 정규표현식

 

파일 다운로드 컨트롤러를 보면 {fileName:.+} 가 있는데 여기서 fileName은 pathVariable를 의미하고 fileName에 .+ 가 들어갈 수 있다. 여기서의 . 하고 + 정규표현식의 뜻은 다음과 같다. 

 

- .(dot): ANY ONE character except newline. Same as [^\n]

- +: one or more (1+), e.g., [0-9]+ matches one or more digits such as '123', '000'

 

따라서 fileName에는 한개 이상의 어떤 문자든 들어갈 수 있다. 

 

 

간단한 파일 업로드 다운로드 기능만 구현된 코드를 깃허브 저장소에 올려놓았는데, 포스트맨을 활용해서 기능을 테스트 해볼 수 있다. 

 

 

 

 

 

 

 

 

// TODO. 스프링 부트 3.*.* 대 버전에서는 기존 코드도 문제없이 실행이 되는데 javax.servlet (JavaEE)에서 jakarta.servlet (Jakarta EE)로 바뀌면서 임시파일을 삭제하는 부분이 사라지거나 수정된 것 같다. 이 부분도 나중에 다시 찾아봐야겠다. 

 

// TODO. 파일 권환 및 경로에 대한 부분

 

 

 

 

참고자료

https://www.callicoder.com/spring-boot-file-upload-download-rest-api-example/

https://github.com/callicoder/spring-boot-file-upload-download-rest-api-example

https://www3.ntu.edu.sg/HOME/EHCHUA/PROGRAMMING/java/Java_Regexe.html

https://www3.ntu.edu.sg/HOME/EHCHUA/PROGRAMMING/howto/Regexe.html