홈 / Enterprise / Spring Boot MVC 구성
Enterprise 초급

Spring Boot MVC 구성

제거된 WebMvcConfigurerAdapter를 WebMvcConfigurer로 대체하고 Spring Boot의 MVC 자동 구성을 유지합니다.

Spring Framework Spring Boot Spring Web MVC Migration
코드 비교
✕ Spring Boot 1.x 
@EnableWebMvc
@Configuration
public class WebConfig extends WebMvcConfigurerAdapter {
    @Override
    public void addViewControllers(
            ViewControllerRegistry registry) {
        registry.addViewController("/").setViewName("home");
    }
}
✓ Spring Boot 4.x 
@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void addViewControllers(
            ViewControllerRegistry registry) {
        registry.addViewController("/").setViewName("home");
    }
}
이 코드에 문제가 있나요? 알려주세요.
모던 방식이 더 나은 이유
🧹

제거된 어댑터 불필요

WebMvcConfigurer가 기본 메서드를 제공하므로 확장할 어댑터 슈퍼클래스가 필요 없습니다.

⚙️

Boot 기본값 유지

@EnableWebMvc가 없으면 Spring Boot가 MVC 인프라를 계속 자동으로 구성합니다.

🎯

필요한 부분만 재정의

인터페이스를 구현하고 애플리케이션에 필요한 MVC 훅만 사용자 지정합니다.

이전 방식
@EnableWebMvc를 사용하는 WebMvcConfigurerAdapter
모던 방식
Spring Boot 자동 구성을 사용하는 WebMvcConfigurer
JDK 버전
17
난이도
초급
JDK 지원
Spring Boot MVC 구성
사용 가능

Spring Framework 7.0이 포함된 Spring Boot 4.0에서 사용 가능 (Java 17+ 필요)

동작 원리

Java 인터페이스가 기본 메서드를 제공할 수 없었던 시절에는 Spring Boot 1.x 애플리케이션에서 흔히 WebMvcConfigurerAdapter를 확장했습니다. 모던 Spring Framework 버전은 WebMvcConfigurer에 기본 구현을 직접 제공하므로, 인터페이스를 구현하고 필요한 메서드만 재정의하면 됩니다. Spring Boot 애플리케이션에서는 의도적으로 MVC 구성을 완전히 제어하려는 경우가 아니라면 @EnableWebMvc를 추가하지 마십시오. 이를 추가하면 일반적인 컨버터, 정적 리소스 처리 및 기타 기본값을 포함한 Boot의 MVC 자동 구성이 비활성화됩니다.

관련 문서
Spring Framework — MVC Java Configuration ↗ Spring Boot — MVC Auto-configuration ↗
증명
증명 소스 보기 ↗
관련 패턴
Enterprise 중급

Spring Framework 7 API Versioning

Spring Boot 2/3
// Version 1 controller
@RestController
@RequestMapping("/api/v1/products")
public class ProductControllerV1 {
    @GetMapping("/{id}")
    public ProductDtoV1 getProduct(
            @PathVariable Long id) {
        return service.getV1(id);
    }
}

// Version 2 — duplicated structure
@RestController
@RequestMapping("/api/v2/products")
public class ProductControllerV2 {
    @GetMapping("/{id}")
    public ProductDtoV2 getProduct(
            @PathVariable Long id) {
        return service.getV2(id);
    }
}
Spring Framework 7+
// Configure versioning once
@Configuration
public class WebConfig implements WebMvcConfigurer {
    @Override
    public void configureApiVersioning(
            ApiVersionConfigurer config) {
        config.useRequestHeader("X-API-Version");
    }
}

// Single controller, version per method
@RestController
@RequestMapping("/api/products")
public class ProductController {
    @GetMapping(value = "/{id}", version = "1")
    public ProductDtoV1 getV1(@PathVariable Long id) {
        return service.getV1(id);
    }

    @GetMapping(value = "/{id}", version = "2")
    public ProductDtoV2 getV2(@PathVariable Long id) {
        return service.getV2(id);
    }
}
마우스를 올려 모던 코드 보기 ➜
JDK 17+ →
Enterprise 중급

Spring XML Bean Config vs Annotation-Driven

Spring (XML)
<!-- applicationContext.xml -->
<beans xmlns="http://www.springframework.org/schema/beans"
    xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
    xsi:schemaLocation="http://www.springframework.org/schema/beans
        http://www.springframework.org/schema/beans/spring-beans.xsd">

    <bean id="userRepository"
          class="com.example.UserRepository">
        <property name="dataSource" ref="dataSource"/>
    </bean>

    <bean id="userService"
          class="com.example.UserService">
        <property name="repository" ref="userRepository"/>
    </bean>

</beans>
Spring Boot 3+
@SpringBootApplication
public class Application {
    public static void main(String[] args) {
        SpringApplication.run(Application.class, args);
    }
}

@Repository
public class UserRepository {
    private final JdbcTemplate jdbc;

    public UserRepository(JdbcTemplate jdbc) {
        this.jdbc = jdbc;
    }
}

@Service
public class UserService {
    private final UserRepository repository;

    public UserService(UserRepository repository) {
        this.repository = repository;
    }
}
마우스를 올려 모던 코드 보기 ➜
JDK 17+ →
Enterprise 중급

Spring Null Safety with JSpecify

Spring 5/6
import org.springframework.lang.NonNull;
import org.springframework.lang.Nullable;

public class UserService {

    @Nullable
    public User findById(@NonNull String id) {
        return repository.findById(id).orElse(null);
    }

    @NonNull
    public List<User> findAll() {
        return repository.findAll();
    }

    @NonNull
    public User save(@NonNull User user) {
        return repository.save(user);
    }
}
Spring 7
import org.jspecify.annotations.NullMarked;
import org.jspecify.annotations.Nullable;

@NullMarked
public class UserService {

    public @Nullable User findById(String id) {
        return repository.findById(id).orElse(null);
    }

    public List<User> findAll() {
        return repository.findAll();
    }

    public User save(User user) {
        return repository.save(user);
    }
}
마우스를 올려 모던 코드 보기 ➜
JDK 17+ →