Главная / Enterprise / Конфигурация MVC в Spring Boot
Enterprise Начинающий

Конфигурация MVC в Spring Boot

Замените удалённый WebMvcConfigurerAdapter на WebMvcConfigurer и сохраните автоконфигурацию MVC в Spring Boot.

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, который требуется приложению.

Старый подход
WebMvcConfigurerAdapter с @EnableWebMvc
Современный подход
WebMvcConfigurer с автоконфигурацией Spring Boot
Начиная с JDK
17
Сложность
Начинающий
Поддержка JDK
Конфигурация MVC в Spring Boot
Доступно

Доступно в Spring Boot 4.0 со Spring Framework 7.0 (требуется Java 17+)

Как это работает

Приложения Spring Boot 1.x часто наследовали WebMvcConfigurerAdapter, поскольку интерфейсы Java не могли предоставлять методы по умолчанию. Современные версии Spring Framework предоставляют реализации по умолчанию непосредственно в WebMvcConfigurer, поэтому реализуйте этот интерфейс и переопределяйте только необходимые методы. В приложении Spring Boot не добавляйте @EnableWebMvc, если только вы намеренно не хотите полностью управлять конфигурацией MVC: эта аннотация отключает автоконфигурацию MVC в Boot, включая стандартные конвертеры, обработку статических ресурсов и другие настройки по умолчанию.

Связанная документация
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+ →