// FileUploadApplication.java
package com.example.fileUpload; //자바 패키지 선언

import org.springframework.boot.SpringApplication; //이거 시작 파일로 사용한다는 뭐 그런뜻이다. ㅇㅇ
import org.springframework.boot.autoconfigure.SpringBootApplication;

@SpringBootApplication // Spring Boot 애플리케이션의 시작점임을 나타냄 내부적으로 여러 애노테이션들을 포함하여, 스프링 부트의 자동 설정 활성화
public class FileUploadApplication {

	public static void main(String[] args) {
		// Spring Boot 애플리케이션을 실행
		SpringApplication.run(FileUploadApplication.class, args);
	}
}

// FileUploadController.java
package com.example.fileUpload; // 패키지 선언: 이 클래스는 'fileupload' 패키지에 속합니다.

import org.springframework.beans.factory.annotation.Value; // Spring의 @Value 어노테이션을 사용하여 프로퍼티 값을 주입받기 위한 클래스
import org.springframework.http.HttpHeaders; // HTTP 응답 헤더를 설정하기 위한 클래스
import org.springframework.http.HttpStatus; // HTTP 상태 코드를 정의하는 클래스
import org.springframework.http.MediaType; // HTTP 미디어 타입을 정의하는 클래스 (사용되지 않음)
import org.springframework.http.ResponseEntity; // HTTP 응답을 반환하기 위한 클래스, 상태 코드, 헤더, 바디를 포함할 수 있음
import org.springframework.util.StringUtils; // 문자열 유틸리티 클래스, 파일 이름 정리 등에서 사용
import org.springframework.web.bind.annotation.*; // Spring MVC의 RESTful 컨트롤러 관련 어노테이션들을 포함하는 패키지
import org.springframework.web.multipart.MultipartFile; // 파일 업로드를 처리하는 인터페이스
import org.springframework.web.servlet.support.ServletUriComponentsBuilder; // 현재 컨텍스트 경로를 기준으로 URI를 생성하는 유틸리티 클래스

import java.io.File; // 파일 작업을 위한 클래스
import java.io.IOException; // 입출력 예외 처리를 위한 클래스
import java.nio.file.Files; // 파일 읽기 및 쓰기를 위한 클래스
import java.nio.file.Path; // 파일 시스템의 경로를 나타내는 클래스
import java.nio.file.Paths; // 경로 객체를 생성하는 클래스
import java.util.UUID; // 고유 식별자를 생성하기 위한 클래스

@RestController // 이 클래스가 RESTful 웹 서비스의 컨트롤러임을 나타내며, HTTP 요청을 처리하고 JSON, XML 등의 형태로 응답을 반환합니다.
public class FileUploadController {

    @Value("${upload.dir}") // application.properties 파일에서 'upload.dir' 속성 값을 읽어와서 'uploadDir' 필드에 주입합니다.
    private String uploadDir;

    // 파일 업로드 처리 메소드
    @PostMapping("/upload") // HTTP POST 요청을 처리하는 메소드
    public ResponseEntity<String> uploadFile(@RequestParam("file") MultipartFile file) {
        if (file.isEmpty()) { // 업로드된 파일이 비어 있는지 확인
            return ResponseEntity.status(HttpStatus.BAD_REQUEST).body("Please select a file to upload"); // 파일이 비어 있을 경우 400 Bad Request 응답 반환
        }

        try {
            // 파일 이름을 UUID로 변경하여 고유하게 만듭니다. 기존 파일 이름을 클린업하여 안전한 이름으로 만듭니다.
            String fileName = UUID.randomUUID() + "-" + StringUtils.cleanPath(file.getOriginalFilename());
            Path path = Paths.get(uploadDir + File.separator + fileName); // 파일을 저장할 경로를 생성
            Files.copy(file.getInputStream(), path); // 파일을 지정된 경로에 저장

            // 파일 다운로드 URI를 생성
            String fileDownloadUri = ServletUriComponentsBuilder.fromCurrentContextPath()
                    .path("/files/")
                    .path(fileName)
                    .toUriString();

            // 파일 다운로드 URI를 응답으로 반환
            return ResponseEntity.ok(fileDownloadUri);

        } catch (IOException ex) { // 파일 저장 중 예외가 발생할 경우
            return ResponseEntity.status(HttpStatus.INTERNAL_SERVER_ERROR).body("Could not store the file. Error: " + ex.getMessage()); // 500 Internal Server Error 응답 반환
        }
    }

    // 업로드된 파일을 보여주는 메소드
    @GetMapping("/files/{fileName:.+}") // HTTP GET 요청을 처리하는 메소드
    public ResponseEntity<byte[]> getFile(@PathVariable String fileName) {
        try {
            Path path = Paths.get(uploadDir + File.separator + fileName); // 파일 경로를 생성
            byte[] fileBytes = Files.readAllBytes(path); // 파일을 바이트 배열로 읽어옴
            HttpHeaders headers = new HttpHeaders(); // HTTP 헤더 객체 생성
            headers.add(HttpHeaders.CONTENT_TYPE, Files.probeContentType(path)); // 파일의 MIME 타입을 설정 (브라우저가 파일을 올바르게 표시하도록 함)
            headers.add(HttpHeaders.CONTENT_DISPOSITION, "inline; filename=\"" + fileName + "\""); // 파일을 브라우저에서 인라인으로 표시하도록 설정
            return new ResponseEntity<>(fileBytes, headers, HttpStatus.OK); // 바이트 배열과 헤더를 응답으로 반환
        } catch (IOException ex) { // 파일 읽기 중 예외가 발생할 경우
            return ResponseEntity.status(HttpStatus.NOT_FOUND).body(null); // 404 Not Found 응답 반환
        }
    }

    // 파일 다운로드 처리 메소드
    @GetMapping("/download/{fileName:.+}") // HTTP GET 요청을 처리하는 메소드
    public ResponseEntity<byte[]> downloadFile(@PathVariable String fileName) {
        try {
            Path path = Paths.get(uploadDir + File.separator + fileName); // 파일 경로를 생성
            byte[] fileBytes = Files.readAllBytes(path); // 파일을 바이트 배열로 읽어옴
            HttpHeaders headers = new HttpHeaders(); // HTTP 헤더 객체 생성
            headers.add(HttpHeaders.CONTENT_TYPE, Files.probeContentType(path)); // 파일의 MIME 타입을 설정 (다운로드 시 파일 형식을 올바르게 처리하도록 함)
            headers.add(HttpHeaders.CONTENT_DISPOSITION, "attachment; filename=\"" + fileName + "\""); // 파일 다운로드로 설정
            return new ResponseEntity<>(fileBytes, headers, HttpStatus.OK); // 바이트 배열과 헤더를 응답으로 반환
        } catch (IOException ex) { // 파일 읽기 중 예외가 발생할 경우
            return ResponseEntity.status(HttpStatus.NOT_FOUND).body(null); // 404 Not Found 응답 반환
        }
    }
}

#application.properties
# 업로드 디렉토리 설정
upload.dir=uploads

//FileUploadApplicationTests.java
// 이건 안해도 실행에 문제 없다.
// test는 디버깅에 이용된다 생각해라
package com.example.fileupload; //자바 패키지 선언

import org.junit.jupiter.api.Test;
import org.springframework.boot.test.context.SpringBootTest;

@SpringBootTest // Spring Boot 테스트를 위한 애노테이션
class FileUploadApplicationTests {

    @Test
    void contextLoads() {
        // 컨텍스트 로딩 테스트
    }
}