[스프링 핵심 원리와 활용] #6. 자동 구성(Auto Configuration) #826

YuDeokRin · 2025-07-25T10:59:15Z

YuDeokRin
Jul 25, 2025
Maintainer

섹션6. 자동 구성(Auto Configuration)

1️⃣ 프로젝트 설정

✅ 프로젝트 설정 순서

autofonfig-start 파일을 파일명을 변경 → autoconfig
프로젝트 임포트
1. File → Open → 해당 프로젝트의 build.gradle을 선택

build.gradle

plugins {
    id 'org.springframework.boot' version '3.0.2'
    id 'io.spring.dependency-management' version '1.1.0'
    id 'java'
}

group = 'hello'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

configurations {
    compileOnly {
        extendsFrom annotationProcessor
    }
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-jdbc'
    implementation 'org.springframework.boot:spring-boot-starter-web'
    compileOnly 'org.projectlombok:lombok'
    runtimeOnly 'com.h2database:h2'
    annotationProcessor 'org.projectlombok:lombok'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'

    //테스트에서 lombok 사용
    testCompileOnly 'org.projectlombok:lombok'
    testAnnotationProcessor 'org.projectlombok:lombok'
}

tasks.named('test') {
    useJUnitPlatform()
}

스프링 부트 라이브러리 설정 리스트
- Lombok, Spring Web, H2 Database, JDBC API

2️⃣ 예제 만들기

Member

package hello.member;

import lombok.Data;

@Data
public class Member {
    private String memberId;
    private String name;

    public Member() {}

    public Member(String memberId, String name) {
        this.memberId = memberId;
        this.name = name;
    }
}

DbConfig

package hello.config;

import com.zaxxer.hikari.HikariDataSource;
import lombok.extern.slf4j.Slf4j;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.datasource.DataSourceTransactionManager;
import org.springframework.transaction.TransactionManager;

import javax.sql.DataSource;

@Slf4j
@Configuration
public class DbConfig {

    @Bean
    public DataSource dataSource() {
        log.info("dataSource 빈 등록");
        HikariDataSource dataSource = new HikariDataSource();
        dataSource.setDriverClassName("org.h2.Driver");
        dataSource.setJdbcUrl("jdbc:h2:mem:test");
        dataSource.setUsername("sa");
        dataSource.setPassword("");
        return dataSource;
    }

    @Bean
    public TransactionManager transactionManager() {
        log.info("transactionManager 빈 등록");
        return new DataSourceTransactionManager(dataSource());
    }

    @Bean
    public JdbcTemplate jdbcTemplate() {
        log.info("jdbcTemplate 빈 등록");
        return new JdbcTemplate(dataSource());
    }
}

JdbcTemplate을 사용해서 회원 데이터를 DB에 보관하고 관리하는 기능
DataSource, TransactionManager, JdbcTemplate을 스프링 빈으로 직접 등록한다.
빈 등록이 실제 호출이 되는지 확인용 로그를 만들어 놓음
DB는 JVM 내부에서 동작하는 메모리 DB를 사용한다.
- jdbc:h2:mem:test
JdbcTranscationManager는 DataSourceTransactionManager와 같은 것으로 생각하면 된다.
- 예외 변환 기능 보강

package hello.member;

import org.springframework.jdbc.core.BeanPropertyRowMapper;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.stereotype.Repository;

import java.util.List;

@Repository
public class MemberRepository {

    private final JdbcTemplate template;

    public MemberRepository(JdbcTemplate jdbcTemplate) {
        this.template = jdbcTemplate;
    }

    public void initTable() {
        template.execute("create table member(member_id varchar primary key,name varchar)");
    }

    public void save(Member member) {
        template.update("insert into member(member_id, name) values(?,?)",
                member.getMemberId(),
                member.getName());
    }

    public Member find(String memberId) {
        return template.queryForObject("select member_id, name from member where member_id=?", BeanPropertyRowMapper.newInstance(Member.class),
                memberId);
    }

    public List<Member> findAll() {
        return template.query("select member_id, name from member",
                BeanPropertyRowMapper.newInstance(Member.class));
    }

    
}

JdbcTemplate을 사용해서 회원을 관리하는 리포지토리
DbConfig에서 JdbcTemplate을 빈으로 등록했기 때문에 바로 주입받아서 사용할 수 있다.
initTable : 보통 리포지토리에 테이블을 생성하는 스크립트를 두지를 않는다. 여기서는 예제를 단순화 하기 위해 이곳에 사용했다
MemberRepositoryTest

package hello.member;

import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.transaction.annotation.Transactional;

import static org.assertj.core.api.Assertions.*;

@SpringBootTest
public class MemberRepositoryTest {

    @Autowired
    MemberRepository memberRepository;

    @Transactional
    @Test
    void memberTest() {
        Member member = new Member("idA", "memberA");
        memberRepository.initTable();
        memberRepository.save(member);
        Member findMember = memberRepository.find(member.getMemberId());
        assertThat(findMember.getMemberId()).isEqualTo(member.getMemberId());
        assertThat(findMember.getName()).isEqualTo(member.getName());
    }
}

@transactional 을 사용해서 트랜잭션 기능을 적용했다.
- 참고로 @transactional을 사용하려면 TransactionManager가 스프링 빈으로 등록되어 있어야 한다.
테이블 생성하고, 회원 데이터를 저장한 다음 다시 조회해서 기존데이터와 같은지 검증

3️⃣ 자동 구성 확인

JdbcTemplate, DataSource, TransactionManager가 스프링 컨테이너에 잘 등록되었는지 간단히 확인해보자.

package hello.config;

import lombok.extern.slf4j.Slf4j;
import org.junit.jupiter.api.Test;
import org.springframework.beans.factory.annotation.Autowired;
import org.springframework.boot.test.context.SpringBootTest;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.transaction.TransactionManager;

import javax.sql.DataSource;

import static org.assertj.core.api.Assertions.assertThat;

@Slf4j
@SpringBootTest
public class DbConfigTest {

    @Autowired
    DataSource dataSource;

    @Autowired
    TransactionManager transactionManager;

    @Autowired
    JdbcTemplate jdbcTemplate;

    @Test
    void checkBean() {
        log.info("dataSource = {}", dataSource);
        log.info("transactionManager = {}", transactionManager);
        log.info("jdbcTemplate = {}", jdbcTemplate);
        
        assertThat(dataSource).isNotNull();
        assertThat(transactionManager).isNotNull();
        assertThat(jdbcTemplate).isNotNull();
    }
}

해당 빈들을 DbConfig 설정을 통해 스프링 컨테이너에 등록했기 때문에, null이면 안된다.
- 사실 @Autowired는 의존관계 주입에 실패하면 오류가 발생하도록 기본 설정되어 있다. 이해를 돕기 위해 이렇게 코드를 작성했다.
테스트는 정상이고 모두 의존관계 주입이 정상 처리된 것을 확인할 수 있다.
출력 결과

 hello.config.DbConfigTest                : Starting DbConfigTest using Java 17.0.6 with PID 53024 (started by dante in /Users/dante/Desktop/DanteFolder/study/autoconfig)
 hello.config.DbConfigTest                : No active profile set, falling back to 1 default profile: "default"
hello.config.DbConfig                    : dataSource 빈 등록
hello.config.DbConfig                    : jdbcTemplate 빈 등록
hello.config.DbConfig                    : transactionManager 빈 등록
hello.config.DbConfigTest                : Started DbConfigTest in 0.652 seconds (process running for 1.137)
hello.config.DbConfigTest                : dataSource = HikariDataSource (null)
hello.config.DbConfigTest                : transactionManager = org.springframework.jdbc.datasource.DataSourceTransactionManager@632cf7d3
hello.config.DbConfigTest                : jdbcTemplate = org.springframework.jdbc.core.JdbcTemplate@51b87df7

➡️ 빈 등록 제거

jdbcTemplate, DataSource, TransactionManager 빈 모두 DbConfig를 통해서 스프링 컨테이너에 빈으로 등록되었다.
이번에는 DbConfig에서 해당 빈들을 등록하지 않고 제거
DbConfig 빈 등록 제거 방법 2가지
- @configuration을 주석처리 : 이렇게 하면 해당 설정 파일 자체를 스프링이 읽어들이지 않는다.(컨포넌트 스캔의 대상이 아니다.)
- @bean 주석처리 : @bean이 없으면 스프링 빈으로 등록하지 않는다.

package hello.config;

import com.zaxxer.hikari.HikariDataSource;
import lombok.extern.slf4j.Slf4j;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.datasource.DataSourceTransactionManager;
import org.springframework.transaction.TransactionManager;

import javax.sql.DataSource;

@Slf4j
//@Configuration  // 주석처리
public class DbConfig {

    @Bean
    public DataSource dataSource() {
        log.info("dataSource 빈 등록");
        HikariDataSource dataSource = new HikariDataSource();
        dataSource.setDriverClassName("org.h2.Driver");
        dataSource.setJdbcUrl("jdbc:h2:mem:test");
        dataSource.setUsername("sa");
        dataSource.setPassword("");
        return dataSource;
    }

    @Bean
    public TransactionManager transactionManager() {
        return new DataSourceTransactionManager(dataSource());
    }

    @Bean
    public JdbcTemplate jdbcTemplate() {
        return new JdbcTemplate(dataSource());
    }

}

➡️ 기본 빈 등록 로그

hello.config.DbConfig : dataSource 빈 등록
hello.config.DbConfig : jdbcTemplate 빈 등록
hello.config.DbConfig : transactionManager 빈 등록

우리가 등록한 JdbcTemplate, DataSource, TransactionManager가 분명히 스프링 빈으로 등록되지 않았다는 것이다.
테스트는 정상 통과하고 심지어 출력결과에 JdbcTemplate, DataSource, TransactionManager 빈들이 존재하는 것을 확인할 수있다.
이 빈들은 모두 스프링 부트가 자동으로 등록해 준 것이다.

4️⃣ 스프링 부트의 자동 구성

스프링 부트는 자동 구성(Auto Configuration)이라는 기능을 제공하는데, 일반적으로 수 많은 빈들을 자동으로 등록해주는 기능이다.
jdbcTemplate, DataSource, TransactionManager 모두 스프링 부트가 자동 구성을 제공해서 자동으로 스프링 빈으로 등록된다.
이러한 자동 구성 덕분에 개발자는 반복적이고 복잡한 빈 등록과 설정을 최소화하고 애플리케이션 개발을 빠르게 시작할 수 있게됨.

/*
 * Copyright 2012-2022 the original author or authors.
 *
 * Licensed under the Apache License, Version 2.0 (the "License");
 * you may not use this file except in compliance with the License.
 * You may obtain a copy of the License at
 *
 *      https://www.apache.org/licenses/LICENSE-2.0
 *
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS,
 * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
 * See the License for the specific language governing permissions and
 * limitations under the License.
 */

package org.springframework.boot.autoconfigure.jdbc;

import javax.sql.DataSource;

import org.springframework.boot.autoconfigure.AutoConfiguration;
import org.springframework.boot.autoconfigure.EnableAutoConfiguration;
import org.springframework.boot.autoconfigure.condition.ConditionalOnClass;
import org.springframework.boot.autoconfigure.condition.ConditionalOnSingleCandidate;
import org.springframework.boot.context.properties.EnableConfigurationProperties;
import org.springframework.boot.sql.init.dependency.DatabaseInitializationDependencyConfigurer;
import org.springframework.context.annotation.Import;
import org.springframework.jdbc.core.JdbcTemplate;
import org.springframework.jdbc.core.namedparam.NamedParameterJdbcTemplate;

/**
 * {@link EnableAutoConfiguration Auto-configuration} for {@link JdbcTemplate} and
 * {@link NamedParameterJdbcTemplate}.
 *
 * @author Dave Syer
 * @author Phillip Webb
 * @author Stephane Nicoll
 * @author Kazuki Shimizu
 * @since 1.4.0
 */
@AutoConfiguration(after = DataSourceAutoConfiguration.class)
@ConditionalOnClass({ DataSource.class, JdbcTemplate.class })
@ConditionalOnSingleCandidate(DataSource.class)
@EnableConfigurationProperties(JdbcProperties.class)
@Import({ DatabaseInitializationDependencyConfigurer.class, JdbcTemplateConfiguration.class,
		NamedParameterJdbcTemplateConfiguration.class })
public class JdbcTemplateAutoConfiguration {

}

모든 것을 깊이있게 이해하지 않기 ! 대략 동작 원리만 감 잡고 천천히 강의로 풀어나가기
@autoConfiguration : 자동 구성을 사용하려면 이 애노테이션을 등록해야 한다.
- 자동 구성도 내부에 @configuration이 있어서 빈을 등록하는 자바 설정 파일로 사용할 수 있다.
- after = DataSourceAutoConfiguration.class
  - 자동 구성이 실행되는 순서를 지정할 수 있다. JdbcTemplate은 DataSoruce가 필요하기 떄문에 DateSource를 자동으로 등록해주는 DataSourceAutoConfiguration 다음에 실행 하도록 설정되어 있다.
@ConditionalOnClass({ DataSource.class, JdbcTemplate.class })
- IF 문과 유사한 기능을 제공 → 이런 클래스가 있는 경우에만 설정이 동작한다. 만약 없으면 여기 있는 설정들이 모두 무효화 되고, 빈도 등록되지 않는다.
- @ConditionalXxx 시리즈가 있다. 자동 구성의 핵심이므로 뒤에서 자세히 알아본다.
- JdbcTemplate 은 DataSource , JdbcTemplate 라는 클래스가 있어야 동작할 수 있다.
@import : 스프링에서 자바 설정을 추가할 때 사용한다.
@import의 대상이 되는 JdbcTemplateConfiguration를 추가로 확인해보자.
JdbcTemplateConfiuartion

package org.springframework.boot.autoconfigure.jdbc;

import javax.sql.DataSource;

import
org.springframework.boot.autoconfigure.condition.ConditionalOnMissingBean;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;
import org.springframework.context.annotation.Primary;
import org.springframework.jdbc.core.JdbcOperations;
import org.springframework.jdbc.core.JdbcTemplate;

@Configuration(proxyBeanMethods = false)
@ConditionalOnMissingBean(JdbcOperations.class)
class JdbcTemplateConfiguration {
		@Bean
		@Primary
		JdbcTemplate jdbcTemplate(DataSource dataSource, JdbcProperties properties) {
			JdbcTemplate jdbcTemplate = new JdbcTemplate(dataSource);
			JdbcProperties.Template template = properties.getTemplate();
			jdbcTemplate.setFetchSize(template.getFetchSize());
			jdbcTemplate.setMaxRows(template.getMaxRows());
			if (template.getQueryTimeout() != null) {
					jdbcTemplate.setQueryTimeout((int) template.getQueryTimeout().getSeconds());
			}
			return jdbcTemplate;
	}
}

@configuration : 자바 설정 파일로 사용된다.
@ConditionalMissingBean(JdbcOperations.class)
- JdbcOperactions 빈이 없을 때 동작한다.
- JdbcTemplate의 부모 인터페이스가 바로 JdbcOperations이다.
- 쉽게 이야기해서 JdbcTemplate이 빈으로 등록되어 있지 않은 경우에만 동작
- 만약 이런 기능이 없으면 내가 등록한 JdbcTemplate과 자동 구성이 등록하는 JdbcTemplate이 등록되는 문제가 발생할 수 있다.
- 보통 개발자가 직접 빈을 등록하면 개발자가 등록한 빈을 사용하고, 자동 구성은 동작하지 않는다.
JdbcTeamplate이 몇가지 설정을 거쳐서 빈으로 등록되는 것을 확인할 수 있다.

자동 등록 설정

다음과 같은 자동 구성 기능들이 다음 빈들을 등록해준다.
- JdbcTemplateAutoConfiguration : JdbcTemplate
- DataSourceAutoConfiguration : DataSource
- DataSourceTransactionManagerAutoConfiguration : TransactionManager

그래서 개발자가 직접 빈을 등록하지 않아도 JdbcTemplate , DataSource , TransactionManager 가 스프링빈으로 등록된 것이다.

✅ 스프링 부트가 제공하는 자동 구성(AutoConfiguration)

https://docs.spring.io/spring-boot/docs/current/reference/html/auto-configuration-classes.html

스프링 부트는 수 많은 자동 구성을 제공하고 spring-boot-autoconfigure에 자동 구성을 모아둔다.
스프링 부트 프로젝트를 사용하면 spring-boot-autoconfigure 라이브러리는 기본적으로 사용된다.

✅ AutoConfiguration -용어

Auto Configuration은 주로 두 용어로 사용된다.
- 자동 설정
- 자동 구성

➡️ 자동 설정

Configuration이라는 단어가 컴퓨터 용어에서는 환경 설정, 설정이라는 뜻으로 자주 사용된다.
AutoConfiguration은 크게 보면 빈들을 자동으로 등록해서 스프링이 동작하는 환경을 자동으로 설정해주기 때문에 자동 설정이라는 용어도 맞다.

➡️ 자동 구성

Configuration 이라는 단어는 구성, 배치라는 뜻도 가지고 있다.
예) 컴퓨터라고 하면 CPU, 메모리등을 배치해야 컴퓨터가 동작한다. 이렇게 배치하는 것을 구성이라고 한다.
스프링도 스프링 실행에 필요한 빈들을 적절하게 배치해야 한다.
자동 구성은 스프링 실행에 필요한 빈들을 자동으로 배치해주는 것이다.
자동 설정, 자동 구성 두 용어 모두 맞는 말이다. 자동 설정은 넓게 사용되는 의미이고, 자동 구성은 실행에 필요한 컴포넌트 조각을 자동으로 배치한다는 더 좁은 의미에 가깝다.
Auto Configuration은 자동 구성이라는 단어를 주로 사용하고, 문맥에 따라서 자동 설정이라는 단어도 사용하겠다.
Configuration이 단독으로 사용될 때는 설정이라는 단어를 사용하겠다.

5️⃣ 자동 구성 직접 만들기 - 기반 예제

자동 구성에 대해서 자세히 알아보기 위해 간단한 예제를 통해서 알아보자.
실시간으로 자바 메모리 사용량을 웹으로 확인하는 예제

package memory;

public class Memory {

    private long used;
    private long max;

    public Memory(long used, long max) {
        this.used = used;
        this.max = max;
    }

    public long getUsed() {
        return used;
    }

    public long getMax() {
        return max;
    }

    @Override
    public String toString() {
        return "Memory{" +
                "used=" + used +
                ", max=" + max +
                '}';
    }
}

used : 사용중인 메모리
max : 최대 메모리
used가 max를 넘게 되면 메모리 부족 오류가 발생한다.
MemoryFinder

package memory;

import jakarta.annotation.PostConstruct;
import lombok.extern.slf4j.Slf4j;

@Slf4j
public class MemoryFinder {

    public Memory get() {
        long max = Runtime.getRuntime().maxMemory();
        long total = Runtime.getRuntime().totalMemory();
        long free = Runtime.getRuntime().freeMemory();
        long used = total - free;
        return new Memory(used, max);
    }

    @PostConstruct
    public void init() {
        log.info("init memoryFinder");
    }

}

JVM에서 메모리 정보를 실시간으로 조회하는 기능이다.
max 는 JVM이 사용할 수 있는 최대 메모리, 이 수치를 넘어가면 OOM이 발생한다.
total 은 JVM이 확보한 전체 메모리(JVM은 처음부터 max 까지 다 확보하지 않고 필요할 때 마다 조금
씩 확보한다.)
free 는 total 중에 사용하지 않은 메모리(JVM이 확보한 전체 메모리 중에 사용하지 않은 것)
used 는 JVM이 사용중인 메모리이다. (used = total - free )
MemoryController

package memory;

import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@Slf4j
@RestController
@RequiredArgsConstructor
public class MemoryController {

    private final MemoryFinder memoryFinder;

    @GetMapping("/memory")
    public Memory memory() {
        Memory memory = memoryFinder.get();
        log.info("memory={}", memory);
        return memory;
    }
}

메모리 정보를 조회하는 컨트롤러이다.
앞서 만든 memoryFinder를 주입 받아 사용한다.
MemoryConfig

package hello.config;

import memory.MemoryController;
import memory.MemoryFinder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MemoryConfig {

    @Bean
    public MemoryController memoryController() {
        return new MemoryController(memoryFinder());
    }

    @Bean
    public MemoryFinder memoryFinder() {
        return new MemoryFinder();
    }
}

memoryController , memoryFinder 를 빈으로 등록
실행 결과

{"used":40477936,"max":4294967296}

6️⃣ @conditional

앞서 만든 메모리 조회 기능을 향상. 사용하는 것이 아니라 특정 조건일 때만 해당 기능이 활성화 되도록 해보자.
예를 들어서 개발 서버에서 확인 용도로만 해당 기능을 사용하고, 운영 서버에서는 해당 기능을 사용하지 않는 것이다.
여기서 핵심은 소스코드를 고치지 않고 이런 것이 가능해야 한다는 점이다.
- 프로젝트를 빌드해서 나온 빌드 파일을 개발 서버에도 배포하고, 같은 파일을 운영서버에도 배포해야 한다.
같은 소스 코드인데 특정 상황일 때만 특정 빈들을 등록해서 사용하도록 도와주는 기능이 바로 @conditional이다.
참고로 이 기능은 스프링 부트 자동 구성에서 자주 사용한다.
Condition

package org.springframework.context.annotation;

import org.springframework.beans.factory.config.BeanFactoryPostProcessor;
import org.springframework.core.type.AnnotatedTypeMetadata;

@FunctionalInterface
public interface Condition {
	boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata);
}

matches() 메서드가 true를 반환하면 조건에 만족해서 동작하고, false를 반환하면 동작하지 않는다.
ConditionContext : 스프링 컨테이너, 환경 정보등을 담고 있다.
AnnotatedTypeMetadata : 애노테이션 메타 정보를 담고 있다.
Condition 인터페이스를 구현해서 자바 시스템 속성이 memory=on이라고 되어 있을 때만 메모리 기능이 동작하도록 만들어보자.

#VM Options
#jaja -Dmemory=on -jar project.jar

MemoryCondition

package memory;

import lombok.extern.slf4j.Slf4j;
import org.springframework.context.annotation.Condition;
import org.springframework.context.annotation.ConditionContext;
import org.springframework.core.type.AnnotatedTypeMetadata;

@Slf4j
public class MemoryCondition implements Condition {
    @Override
    public boolean matches(ConditionContext context, AnnotatedTypeMetadata metadata) {
        String memory = context.getEnvironment().getProperty("memory");
        log.info("memory={}", memory);
        return "on".equals(memory); // 환경 정보에 memory=on 이라고 되어 있는 경우에만 true를 반환한다.
    }
}

MemoryConfig - 수정

package hello.config;

import memory.MemoryCondition;
import memory.MemoryController;
import memory.MemoryFinder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Conditional;
import org.springframework.context.annotation.Configuration;

@Configuration
@Conditional(MemoryCondition.class) // 추가  -> 
public class MemoryConfig {

    @Bean
    public MemoryController memoryController() {
        return new MemoryController(memoryFinder());
    }

    @Bean
    public MemoryFinder memoryFinder() {
        return new MemoryFinder();
    }
}

@conditional(MemoryCondition.class)
- 이제 MemoryConfig의 적용 여부는 @conditional에 지정한 Config의 조건에 따라 달라짐
- MemoryCondition의 matches()를 실행해보고 그 결과가 true이면 MemoryConfig는 정상 동작한다. 따라서 memoryController, memoryFinder가 빈으로 등록된다.
- MemoryCondition의 실행결과가 false이면 MemoryConfig는 무효화 된다. 그래서 memoryController, memoryFinder 빈은 등록되지 않는다.
결과

{"used":38952680,"max":4294967296}

#VM Options
#java -Dmemory=on -jar project.jar
-Dmemory=on

#Program arguments
# -- 가 있으면 스프링이 환경 정보로 사용
#java -jar project.jar --memory=on
--memory=on

#application.properties
#application.properties에 있으면 환경 정보로 사용
memory=on

7️⃣ @conditional - 다양한 기능

지금까지 Condition 인터페이스를 직접 구현해서 MemoryCondition 이라는 구현체를 만들었다. 스프링은 이미 필요한 대부분의 구현체를 만들어두었다. 이번에는 스프링 제공하는 편리한 기능을 사용해보자.

package hello.config;

import memory.MemoryCondition;
import memory.MemoryController;
import memory.MemoryFinder;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Conditional;
import org.springframework.context.annotation.Configuration;

@Configuration
//@Conditional(MemoryCondition.class) // 주석
@ConditionalOnProperty(name = "memory", havingValue = "on") // 추가 
public class MemoryConfig {

    @Bean
    public MemoryController memoryController() {
        return new MemoryController(memoryFinder());
    }

    @Bean
    public MemoryFinder memoryFinder() {
        return new MemoryFinder();
    }
}

@conditional(MemoryCondition.class)를 주석처리하자.
@ConditionalOnProperty(name = “memory”, havingValue = “on”)를 추가하자
- 환경 정보가 memory=on 이라는 조건에 맞으면 동작하면, 그렇지 않으면 동작하지 않는다.

package org.springframework.boot.autoconfigure.condition;

@Conditional(OnPropertyCondition.class)
public @interface ConditionalOnProperty {...}

@ConditionalOnProperty도 우리가 만든 것과 동일하게 내부에는 @Conditional 을 사용한다. 그
리고 그 안에 Condition 인터페이스를 구현한 OnPropertyCondition 를 가지고 있다.

✅@ConditionalOnXxx

스프링은 @conditional과 관련해서 개발자가 편리하게 사용할 수 있도록 수 많은 @ConditionalOnXxx를 제공한다.
대표적인 몇가지를 알아보자.
- @ConditionalOnClass , @ConditionalOnMissingClass
클래스가 있는 경우 동작한다. 나머지는 그 반대
- @ConditionalOnBean , @ConditionalOnMissingBean
- 빈이 등록되어 있는 경우 동작한다. 나머지는 그 반
@ConditionalOnProperty
- 환경 정보가 있는 경우 동작한다.
@ConditionalOnResource
- 리소스가 있는 경우 동작한다.
@ConditionalOnWebApplication , @ConditionalOnNotWebApplication
- 웹 애플리케이션인 경우 동작한다.
@ConditionalOnExpression
- SpEL 표현식에 만족하는 경우 동작한다.
ConditionalOnXXX 공식 메뉴얼

https://docs.spring.io/spring-boot/docs/current/reference/html/
features.html#features.developing-auto-configuration.condition-annotations

다음 자동 구성 클래스들을 열어서 소스 코드를 확인해보면 @ConditionalOnXXX가 아주 많이 사용되는 것을 확인 할 수있다.

- JdbcTemplateAutoConfiguration
- DataSourceTransactionManagerAutoConfiguration
- DataSourceAutoConfiguration

8️⃣ 순수 라이브러리 만들기

@autoConfiguration을 이해하기 위해서는 그 전에 먼저 라이브러리가 어떻게 사용되는기 이해하는 것이 필요하다.

참고로 라이브러리를 만들 떄는 스프링 부트 플러그인 기능을 사용하지 않고 진행한다.

➡️ 프로젝트 설정 순서

memory-v1-start의 폴더 이름을 memory-v1으로 변경
프로젝트 임포트

plugins {
    id 'java'
}

group = 'memory'
sourceCompatibility = '17'

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web:3.0.2'
    compileOnly 'org.projectlombok:lombok:1.18.24'
    annotationProcessor 'org.projectlombok:lombok:1.18.24'
    testImplementation 'org.springframework.boot:spring-boot-starter-test:3.0.2'
}

test {
    useJUnitPlatform()
	}

Memory

package memory;

public class Memory {

    private long used;
    private long max;

    public Memory(long used, long max) {
        this.used = used;
        this.max = max;
    }

    public long getUsed() {
        return used;
    }

    public void setUsed(long used) {
        this.used = used;
    }

    public long getMax() {
        return max;
    }

    public void setMax(long max) {
        this.max = max;
    }

    @Override
    public String toString() {
        return "Memory{" +
                "used=" + used +
                ", max=" + max +
                '}';
    }
}

MemoryFinder

package memory;

import jakarta.annotation.PostConstruct;
import lombok.extern.slf4j.Slf4j;

@Slf4j
public class MemoryFinder {

    public Memory get() {
        long max = Runtime.getRuntime().maxMemory();
        long total = Runtime.getRuntime().totalMemory();
        long free = Runtime.getRuntime().freeMemory();
        long used = total - free;
        return new Memory(used, max);
    }

    @PostConstruct
    public void init() {
        log.info("init memoryFinder");
    }
}

MemoryController

package memory;

import lombok.RequiredArgsConstructor;
import lombok.extern.slf4j.Slf4j;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@Slf4j
@RestController
@RequiredArgsConstructor
public class MemoryController {

    private final MemoryFinder memoryFinder;

    @GetMapping("/memory")
    public Memory system() {
        Memory memory = memoryFinder.get();
        log.info("memory={}", memory);
        return memory;
    }
}

9️⃣ 순수한 라이브러리 사용하기 1

✅ 프로젝트 설정

project-v1으로 변경
프로젝트 임포트

plugins {
    id 'org.springframework.boot' version '3.0.2'
    id 'io.spring.dependency-management' version '1.1.0'
    id 'java'
}

group = 'hello'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

configurations {
    compileOnly {
        extendsFrom annotationProcessor
    }
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    compileOnly 'org.projectlombok:lombok'
    annotationProcessor 'org.projectlombok:lombok'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

tasks.named('test') {
    useJUnitPlatform()
}

스프링 부트에서 다음 라이브러리를 선택했다.
lombok, spring web 추가

package hello.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "hello";
    }

    
}

🔟 순수한 라이브러리 사용하기 2

memory-v1.jar 라이브러리를 project-v1 에 적용
라이브러리 추가
- project-v1/libs폴더를 생성
- memory-v1 프로젝트에서 빌드한 memory-v1.jar를 이곳에 복사
- project-v1/build.gradle에 memory-v1.jar를 추가

dependencies {
		implementation files('libs/memory-v1.jar') //추가
		implementation 'org.springframework.boot:spring-boot-starter-web'
		compileOnly 'org.projectlombok:lombok'
		annotationProcessor 'org.projectlombok:lombok'
		testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

package hello.config;

import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.Configuration;

@Configuration
public class MemoryConfig {

    @Bean
    public MemoryFinder memoryFinder() {
        return new MemoryFinder();
    }
    @Bean
    public MemoryController memoryController() {
        return new MemoryController(memoryFinder());
    }

}

서버 실행 로그

MemoryFinder : init memoryFinder

1️⃣1️⃣ 자동 구성 라이브러리 만들기

만든 라이브러리를 사용해주는 고객을 위해 프로젝트에 라이브러리를 추가만 하면 모든 구성이 자동으로 처리되도록 만들어보자.

memory-v1 프로젝트를 복사해서 memory-v2를 만들어보자

package memory;
import org.springframework.boot.autoconfigure.AutoConfiguration;
import org.springframework.boot.autoconfigure.condition.ConditionalOnProperty;

import org.springframework.context.annotation.Bean;

@AutoConfiguration
@ConditionalOnProperty(name = "memory", havingValue = "on")
public class MemoryAutoConfig {

		@Bean
		public MemoryController memoryController() {
				return new MemoryController(memoryFinder());
		}
		
		@Bean
		public MemoryFinder memoryFinder() {
				return new MemoryFinder();
		}
}

@autoConfiguration
- 스프링부트가 제공하는 자동 구성 기능을 적용할 때 쓰는 애노테이션
@ConditionalOnProperty
- memory=on 이라는 환경 정보가 있을 때 라이브러리를 적용한다. (스프링 빈을 등록한다.)
- 라이브러리를 가지고 있더라도 상황에 따라서 해당 기능을 켜고 끌 수 있게 유연한 기능을 제공한다.

➡️자동 구성 대상 지정

부트 자동 구성을 적용하려면 다음 파일에 자동 구성 대상을 꼭 지정해줘야함
파일 생성
src/main/resources/META-INF/spring/org.springframework.boot.autoconfigure.AutoConfiguration.imports

1️⃣2️⃣ 자동 구성 라이브러리 사용하기 1

기존 프로젝트를 유지하기 위해 새로운 프로젝트에 자동 구성 라이브러리를 적용

✅ 프로젝트 설정

project-v2-start의 폴더 이름을 project-v2으로 변경
프로젝트 임포트

plugins {
    id 'org.springframework.boot' version '3.0.2'
    id 'io.spring.dependency-management' version '1.1.0'
    id 'java'
}

group = 'hello'
version = '0.0.1-SNAPSHOT'
sourceCompatibility = '17'

configurations {
    compileOnly {
        extendsFrom annotationProcessor
    }
}

repositories {
    mavenCentral()
}

dependencies {
    implementation 'org.springframework.boot:spring-boot-starter-web'
    compileOnly 'org.projectlombok:lombok'
    annotationProcessor 'org.projectlombok:lombok'
    testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

tasks.named('test') {
    useJUnitPlatform()
}

HelloController

package hello.controller;

import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;

@RestController
public class HelloController {

    @GetMapping("/hello")
    public String hello() {
        return "hello";
    }

}

1️⃣3️⃣ 자동 구성 라이브러리 사용하기 2

memory-v2.jar 라이브러리를 project-v2에 적용해보자.

➡️라이브러리 추가

project-v2/libs폴더를 생성
memory-v2프로젝트에서 빌드한memory-v2.jar를 이곳에 복사
project-v2/build.gradle에memory-v2.jar` 를 추가

dependencies {
			implementation files('libs/memory-v2.jar') //추가
			implementation 'org.springframework.boot:spring-boot-starter-web'
			compileOnly 'org.projectlombok:lombok'
			annotationProcessor 'org.projectlombok:lombok'
			testImplementation 'org.springframework.boot:spring-boot-starter-test'
}

주의
- 추가한 폴더 이름이 lib 가 아니라 libs 인 점을 주의하자!
- 지금처럼 로컬에 파일로 추가한 라이브러리를 IntelliJ가 잘 인식하지 못하는 경우에는 다음과 같이 프로젝트를 다시 임포트 하자.

➡️ 라이브러리 설정

앞서 project-v1 에서는 memory-v1 을 사용하기 위해 스프링 빈을 직접 등록했다.
project-v2 에서 사용하는 memory-v2 라이브러리에는 스프링 부트 자동 구성이 적용되어 있다. 따라서 빈을 등록하는 별도의 설정을 하지 않아도 된다.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

Uh oh!

[스프링 핵심 원리와 활용] #6. 자동 구성(Auto Configuration) #826

Uh oh!

{{title}}

Uh oh!

Uh oh!

{{editor}}'s edit

{{editor}}'s edit

Uh oh!

Replies: 0 comments

Select a reply

Uh oh!

[스프링 핵심 원리와 활용] #6. 자동 구성(Auto Configuration) #826

Uh oh!

Uh oh!

YuDeokRin Jul 25, 2025 Maintainer

섹션6. 자동 구성(Auto Configuration)

1️⃣ 프로젝트 설정

✅ 프로젝트 설정 순서

2️⃣ 예제 만들기

3️⃣ 자동 구성 확인

➡️ 빈 등록 제거

➡️ 기본 빈 등록 로그

4️⃣ 스프링 부트의 자동 구성

자동 등록 설정

✅ 스프링 부트가 제공하는 자동 구성(AutoConfiguration)

✅ AutoConfiguration -용어

➡️ 자동 설정

➡️ 자동 구성

5️⃣ 자동 구성 직접 만들기 - 기반 예제

6️⃣ @conditional

7️⃣ @conditional - 다양한 기능

✅@ConditionalOnXxx

8️⃣ 순수 라이브러리 만들기

➡️ 프로젝트 설정 순서

9️⃣ 순수한 라이브러리 사용하기 1

✅ 프로젝트 설정

🔟 순수한 라이브러리 사용하기 2

1️⃣1️⃣ 자동 구성 라이브러리 만들기

➡️자동 구성 대상 지정

1️⃣2️⃣ 자동 구성 라이브러리 사용하기 1

✅ 프로젝트 설정

1️⃣3️⃣ 자동 구성 라이브러리 사용하기 2

➡️라이브러리 추가

➡️ 라이브러리 설정

Replies: 0 comments

YuDeokRin
Jul 25, 2025
Maintainer