0Pricing
Java Academy · 강의

애플리케이션 속성과 프로필

application.properties/yml로 구성을 외부화하고 프로필을 정의하며 @Value와 @ConfigurationProperties로 값을 주입합니다.

애플리케이션 속성과 프로필은(는) CoddyKit의 무료 Java Academy 강의입니다. 이것은 4개 중 2번째 강의입니다. 아래에서 전체 강의를 무료로 읽을 수 있으며, 내장 코드 에디터와 24/7 AI 튜터와 함께 브라우저에서 직접 실습할 수 있습니다. 이 강의는 Java Academy 학습 경로의 일부이며, 진행 상황이 웹과 CoddyKit 앱에 동기화됩니다. Java Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

application.properties와 application.yml 비교

Spring Boot는 src/main/resources/application.properties 또는 application.yml에서 구성을 읽습니다. YAML은 키를 반복하지 않고 계층적 구성을 지원하며, 두 형식의 기능은 동일합니다.

# application.properties:
server.port=8080
spring.datasource.url=jdbc:postgresql://localhost/mydb
spring.jpa.hibernate.ddl-auto=validate

# Equivalent application.yml:
server:
  port: 8080
spring:
  datasource:
    url: jdbc:postgresql://localhost/mydb
  jpa:
    hibernate:
      ddl-auto: validate

@Value로 값 주입하기

@Value("${property.key}")를 사용하여 단일 속성을 주입합니다. ${key:default}를 사용하여 기본값을 추가합니다. SpEL 표현식이 지원됩니다.

@Service
public class PricingService {
    @Value("${pricing.vat-rate:0.20}")
    private double vatRate;
    @Value("${app.name}")
    private String appName;
}

@ConfigurationProperties를 사용한 타입 안전 바인딩

서로 관련된 속성 그룹을 @ConfigurationProperties가 지정된 Java 레코드나 클래스에 바인딩하십시오. 검증 애너테이션도 지원됩니다.

@ConfigurationProperties(prefix = "app.mail")
public record MailProperties(
    @NotBlank String host,
    @Min(1) @Max(65535) int port,
    boolean ssl
) {}
// Bind in Spring Boot 3: @EnableConfigurationProperties(MailProperties.class)

프로필: 환경 정의

프로필을 사용하면 환경별 구성을 정의할 수 있습니다. 특정 프로필이 활성화된 경우에만 활성화되는 빈이나 속성을 정의할 수 있습니다.

# application-dev.properties (active when profile=dev):
spring.datasource.url=jdbc:h2:mem:testdb
logging.level.com.example=DEBUG

# application-prod.properties (active when profile=prod):
spring.datasource.url=jdbc:postgresql://prod-db/app
logging.level.com.example=WARN

프로필 활성화

application.properties, 환경 변수, 시스템 속성 또는 Spring Boot의 SPRING_PROFILES_ACTIVE를 통해 프로필을 활성화하십시오.

# application.properties:
spring.profiles.active=dev
# Or environment variable:
export SPRING_PROFILES_ACTIVE=prod
# Or JVM argument:
java -Dspring.profiles.active=prod -jar app.jar

빈에 @Profile 적용

@Bean 또는 @Component에 @Profile("prod")를 지정하면 일치하는 프로필이 활성화된 경우에만 해당 빈을 등록할 수 있습니다.

@Configuration
public class DataSourceConfig {
    @Bean @Profile("dev")
    public DataSource h2DataSource() { return new EmbeddedDatabaseBuilder().build(); }
    @Bean @Profile("prod")
    public DataSource postgresDataSource() { return DataSourceBuilder.create().url(prodUrl).build(); }
}

프로필 그룹 (Spring Boot 2.4 이상)

여러 프로필을 하나의 이름 아래에 그룹화할 수 있습니다. 그룹을 활성화하면 목록에 포함된 모든 프로필이 동시에 활성화됩니다.

# application.properties:
spring.profiles.group.production=prod,metrics,cloud

환경 변수를 사용한 외부화된 구성

Spring Boot는 환경 변수를 속성에 자동으로 매핑합니다. DB_HOST는 db.host로 매핑됩니다(완화된 바인딩). Docker와 Kubernetes 배포에 적합합니다.

# application.properties:
spring.datasource.url=${DB_URL}
spring.datasource.username=${DB_USER}
spring.datasource.password=${DB_PASS}

속성 재정의 우선순위

속성은 우선순위에 따라 적용됩니다. 명령줄 인수 > 환경 변수 > 프로필별 파일 > application.properties > 기본값 순서입니다. 우선순위가 높은 소스가 낮은 소스를 재정의합니다.

Jasypt를 사용한 민감한 속성 암호화

비밀번호와 같은 민감한 값은 Jasypt Spring Boot로 암호화할 수 있습니다. 암호화된 값을 속성에 저장하면 Jasypt가 JVM 인수로 전달된 마스터 키를 사용해 시작할 때 복호화합니다.

# application.properties:
spring.datasource.password=ENC(k9r/2dfhXPQz+2jR8yzUYw==)
# JVM arg:
java -Djasypt.encryptor.password=masterSecret -jar app.jar

다중 문서 YAML 파일

YAML 파일은 ---로 구분된 여러 문서를 지원합니다. 각 문서에서 spring.config.activate.on-profile을 사용하면 파일 안에 프로필별 구성을 지정할 수 있습니다.

server:
  port: 8080
---
spring:
  config:
    activate:
      on-profile: prod
server:
  port: 443

간단한 확인

관련된 속성 그룹을 형식 안전성을 유지하면서 Java 클래스에 바인딩하는 애너테이션은 무엇입니까?

복습

구성에는 application.properties 또는 application.yml을 사용합니다. 단일 값에는 @Value를, 그룹에는 @ConfigurationProperties를 사용합니다. 프로필로 환경을 분리할 수 있습니다. 환경 변수는 속성보다 우선하므로 컨테이너 환경에서 필수적입니다.

자주 묻는 질문

“애플리케이션 속성과 프로필” 강의는 무료인가요?

네 — “애플리케이션 속성과 프로필” 전체 내용을 이 웹사이트에서 무료로 읽을 수 있습니다. 인터랙티브하게 실습하려면(내장 코드 에디터와 24/7 AI 튜터), CoddyKit PRO로 업그레이드하면 Java Academy 강의 전체를 잠금 해제할 수 있습니다. Java Academy 강의에는 총 4개의 강의가 포함되어 있습니다.

“애플리케이션 속성과 프로필”에서 뭘 배우나요?

application.properties/yml로 구성을 외부화하고 프로필을 정의하며 @Value와 @ConfigurationProperties로 값을 주입합니다. 브라우저에서 직접 실행하는 실습 코드로 Java Academy을(를) 배우며, 24/7 AI 튜터가 강의를 진행하면서 질문에 답변해줍니다.

Java Academy을(를) 시작하는 데 경험이 필요한가요?

사전 경험은 필요하지 않습니다. CoddyKit의 Java Academy은(는) 초급자부터 고급 학습자까지를 위해 구성되어 있으므로, 여기서 시작하거나 처음부터 시작할 수 있으며 자신의 속도대로 진행할 수 있습니다. 이것은 4개 중 2번째 강의입니다.

“애플리케이션 속성과 프로필” 강의는 얼마나 걸리나요?

대부분의 CoddyKit 강의는 약 5~10분이 소요됩니다. 각 강의는 간결하고 인터랙티브하여 꾸준한 진행이 가능하며, 웹과 앱에서 중단한 부분부터 바로 시작할 수 있습니다.

이 Java Academy 강의에서 코드를 작성하고 실행할 수 있나요?

네. 모든 Java Academy 강의에는 내장 코드 에디터가 포함되어 있으므로, 브라우저에서 바로 실제 코드를 작성하고 실행한 후 즉시 AI 피드백을 받을 수 있습니다 — 로컬 설정이 필요 없습니다.

이 강의의 모든 강의

  1. 자동 구성과 Spring Boot 스타터
  2. 애플리케이션 속성과 프로필
  3. 빈 연결: @Component, @Service, @Repository
  4. 생성자 주입과 순환 의존성
← Java Academy(으)로 돌아가기