[멀티캠퍼스] 풀스택 개발자 아카데미 (27) - Spring Boot(3)

# application.properties (Spring Boot 2.x/3.x 기준)

# 파일 하나당 최대 크기 (기본 1MB)
spring.servlet.multipart.max-file-size=10MB

# 한 번의 요청(여러 파일 포함) 당 최대 크기 (기본 10MB)
spring.servlet.multipart.max-request-size=50MB

// 파일명 생성 로직 예시
String originalFileName = multipartFile.getOriginalFilename();
String uuid = UUID.randomUUID().toString(); // 난수 문자열 생성
// 예: "8e1a2153-edfa-436f-bd72-23b6b7e5cd6b_원본파일.jpg"
String savedFileName = uuid + "_" + originalFileName;

@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addResourceHandlers(ResourceHandlerRegistry registry) {
        // 브라우저가 /upload/** 로 요청하면 로컬의 C:/spring_uploads/ 폴더를 보여줌
        registry.addResourceHandler("/upload/**")
                .addResourceLocations("file:///C:/spring_uploads/");
    }
}

<h2>Ajax 파일 업로드</h2>
<input type="file" id="uploadFile" name="uploadFile">
<button type="button" id="uploadBtn">업로드</button>

<div id="uploadResult"></div>

<script src="https://code.jquery.com/jquery-3.7.1.min.js"></script>
<script>
    $('#uploadBtn').on('click', function() {
        var formData = new FormData(); // 가상의 Form 객체 생성
        var inputFile = $('#uploadFile');
        var files = inputFile[0].files;

        if(files.length === 0) {
            alert("파일을 선택해주세요.");
            return;
        }

        formData.append("uploadFile", files[0]); // 파일 데이터 추가

        $.ajax({
            url: '/api/upload',
            processData: false, // 데이터를 쿼리스트링으로 변환하지 않음 (필수!)
            contentType: false, // Content-Type 헤더를 설정하지 않음 (multipart 자동 설정)
            data: formData,
            type: 'POST',
            success: function(result) {
                alert("업로드 성공!");
                // 업로드된 이미지 미리보기 (외부 경로 매핑 활용)
                var imgHtml = '<img src="/upload/' + result + '" style="width:200px;">';
                $('#uploadResult').html(imgHtml);
            },
            error: function(jqXHR, textStatus, errorThrown) {
                alert("업로드 실패: " + textStatus);
            }
        });
    });
</script>

package com.example.boot.controller;

import org.springframework.web.bind.annotation.PostMapping;
import org.springframework.web.bind.annotation.RequestParam;
import org.springframework.web.bind.annotation.RestController;
import org.springframework.web.multipart.MultipartFile;

import java.io.File;
import java.io.IOException;
import java.util.UUID;

@RestController // 데이터(파일명)만 반환하므로 RestController 사용
public class UploadController {

    // 파일 저장 경로 (WebConfig에 설정한 경로와 일치해야 함)
    private static final String UPLOAD_FOLDER = "C:\\spring_uploads\\";

    @PostMapping("/api/upload")
    public String uploadFile(@RequestParam("uploadFile") MultipartFile file) {
        if (file.isEmpty()) {
            return "FAIL";
        }

        try {
            // 1. 원본 파일명 및 UUID 생성
            String originalFileName = file.getOriginalFilename();
            String uuid = UUID.randomUUID().toString();

            // 2. 저장할 파일명 조합
            String savedFileName = uuid + "_" + originalFileName;

            // 3. 디스크에 파일 저장
            File saveFile = new File(UPLOAD_FOLDER + savedFileName);
            // 부모 디렉토리가 없으면 생성
            if (!saveFile.getParentFile().exists()) {
                saveFile.getParentFile().mkdirs();
            }
            file.transferTo(saveFile); // 실제 저장 수행

            // 4. 저장된 파일명 반환 (클라이언트에서 이미지 출력용)
            return savedFileName;

        } catch (IOException e) {
            e.printStackTrace();
            return "ERROR";
        }
    }
}