환경 변수 관리 (@Value, @ConfigurationProperties)

🔍 1. 환경 변수란?

YAML 변수, 프로퍼티 변수, 설정 변수 라고도 부른다.

환경 변수는 애플리케이션 실행 시 필요한 설정 값을 의미한다.

이를 통해 코드 수정 없이 환경을 변경할 수 있고, 유지보수도 쉬워진다!

 

📌 2. 환경 변수 설정하기

Spring Boot에서는 환경 변수를 application.yml 또는 application.properties에 저장한다.

➡️ 이 값들은 @Value나 @ConfigurationProperties를 사용해서 코드에서 가져올 수 있다!

 

📖 YAML 사용 (application.yml)

atchfile:
  upload:
    path: /upload/files

 

📖 Properties 사용 (application.properties)

atchfile.upload.path=/upload/files

 

📌 3. @Value

@Value 애너테이션을 사용하면 환경 변수 값을 주입받는다.

@Value("${atchfile.upload.path}")
private String atchfileUploadPath;

 

⚠️ 하지만 환경 변수가 많아지면 @Value로 하나씩 주입받는 방식은 관리가 어렵다!

 

📌 4. @ConfigurationProperties

환경 변수가 많아지면, @Value보다는 전용 클래스를 만들어서 한 번에 관리하는 게 좋음!

 

1️⃣ 설정 클래스 만들기

@Configuration
@ConfigurationProperties(prefix = "atchfile.upload")
@Getter
@Setter
public class AtchFileConfig {
    private String path;
}

 

2️⃣ 환경 변수 값 자동 주입

@Service
public class FileService {
    private final AtchFileConfig atchFileConfig;

    public FileService(AtchFileConfig atchFileConfig) {
        this.atchFileConfig = atchFileConfig;
    }

    public void printPath() {
        System.out.println("Upload Path: " + atchFileConfig.getPath());
    }
}

 

➡️ 이렇게 하면 atchFileConfig.getPath()를 호출하여 환경 변수 값을 쉽게 가져올 수 있다!

 

🔥 @Value vs @ConfigurationProperties

비교 항목	@Value	@ConfigurationProperties
사용 방식	개별 변수 주입	설정 클래스로 관리
환경 변수 개수	적을 때 적합	많을 때 적합
유지보수성	관리 어려움	유지보수 편리
유연성	타입 변환 불편	자동 변환 지원

 

🚀 결론

• 환경 변수가 적을 때 → @Value 사용
• 환경 변수가 많을 때 → @ConfigurationProperties 사용 (✅ 추천!)