File Upload

📂 파일 업로드 (File Upload)

🔍 개요

• HTTP multipart/form-data 요청을 처리하기 위해 Spring MVC에서 제공하는 기능
• MultipartResolver 인터페이스 구현체를 통해 업로드된 파일을 파싱하고 바인딩
• 파일 업로드는 컨트롤러 메서드에서 MultipartFile로 직접 받을 수 있음

---

☝🏻 한줄 요약

MultipartResolver를 통해 multipart 요청을 파싱하고, 컨트롤러에서 손쉽게 파일을 처리

---

🤔 왜 필요한가?

• HTML <form> 파일 전송을 처리하는 표준 방식 지원
• 대용량 파일 처리, 임시 저장소 관리, 메모리·디스크 저장 방식 분리 가능
• 파일 업로드 로직과 비즈니스 로직을 분리해 유지보수성 향상

---

⚙️ 주요 구성 요소

1. MultipartResolver 인터페이스

• multipart 요청을 일반 요청처럼 변환해주는 스프링 MVC 컴포넌트

구현체	특징
StandardServletMultipartResolver	Servlet 3.0+ 지원, 의존성 추가 불필요
CommonsMultipartResolver	Apache Commons FileUpload 기반, 의존성 추가 필요

---

🔧 설정 방법

(A) Bean 등록

@Bean
public MultipartResolver multipartResolver() {
    return new StandardServletMultipartResolver();
    //CommonsMultipartResolver 사용할 경우 별도의 의존성을 추가해 줘야함
}

(B) Spring Boot 사용 시

• application.properties에서 활성화

spring.servlet.multipart.enabled=true
spring.servlet.multipart.max-file-size=10MB
spring.servlet.multipart.max-request-size=20MB

• 별도 Bean 등록 없이 자동 설정됨

---

📄 컨트롤러 예시

@PostMapping("/upload")
public String uploadFile(@RequestParam("file") MultipartFile file) {
    if (!file.isEmpty()) {
        String filename = file.getOriginalFilename();
        Path path = Paths.get("/uploads/" + filename);
        file.transferTo(path.toFile());
    }
    return "redirect:/success";
}

주요 구현체

• StandardServletMultipartResolver: Servlet 3.0 이상의 기본 구현
• CommonsMultipartResolver: Apache Commons FileUpload 기반 구현 (추가 의존성 필요)

✅ Spring Boot에서는 spring.servlet.multipart.enabled=true 설정 시 자동으로 등록됨

---

⚠️ 주의할 점

• 업로드 제한 크기(max-file-size)를 반드시 설정할 것
• 보안상 허용 확장자, 저장 경로 검증 필요
• 대규모 파일은 스트리밍 처리 고려
• 업로드 디렉토리 접근 권한 설정 필수

---

🔗 관련

• Spring MVC 개요
• Spring Docs – MultipartResolver
• Servlet 3.0 File Upload