Accueil / Enterprise / Configuration MVC de Spring Boot
Enterprise Débutant

Configuration MVC de Spring Boot

Remplacez WebMvcConfigurerAdapter, supprimé, par WebMvcConfigurer tout en conservant l'auto-configuration MVC de Spring Boot.

Spring Framework Spring Boot Spring Web MVC Migration
Comparaison de Code
✕ 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");
    }
}
Un problème avec ce code ? Dites-le nous.
Pourquoi la méthode moderne gagne
🧹

Plus d'adaptateur supprimé

WebMvcConfigurer fournit des méthodes default ; aucune superclasse adaptateur ne doit donc être étendue.

⚙️

Conserve les valeurs par défaut de Boot

Sans @EnableWebMvc, Spring Boot continue de configurer automatiquement l'infrastructure MVC.

🎯

Redéfinissez uniquement l'essentiel

Implémentez l'interface et personnalisez seulement le point d'extension MVC requis par l'application.

Ancienne Approche
WebMvcConfigurerAdapter avec @EnableWebMvc
Approche Moderne
WebMvcConfigurer avec l'auto-configuration de Spring Boot
Depuis JDK
17
Difficulté
Débutant
Support JDK
Configuration MVC de Spring Boot
Disponible

Disponible dans Spring Boot 4.0 avec Spring Framework 7.0 (nécessite Java 17+)

Comment ça fonctionne

Les applications Spring Boot 1.x étendaient couramment WebMvcConfigurerAdapter, car les interfaces Java ne pouvaient pas fournir de méthodes default. Les versions modernes de Spring Framework fournissent directement des implémentations par défaut dans WebMvcConfigurer : implémentez donc l'interface et ne redéfinissez que les méthodes nécessaires. Dans une application Spring Boot, n'ajoutez pas @EnableWebMvc sauf si vous souhaitez délibérément prendre le contrôle total de la configuration MVC : cette annotation désactive l'auto-configuration MVC de Boot, notamment ses convertisseurs habituels, la gestion des ressources statiques et les autres valeurs par défaut.

Documentation Associée
Spring Framework — MVC Java Configuration ↗ Spring Boot — MVC Auto-configuration ↗
Preuve
Voir la preuve source ↗
Patterns associés
Enterprise Intermédiaire

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);
    }
}
Survolez pour voir le moderne ➜
JDK 17+ →
Enterprise Intermédiaire

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;
    }
}
Survolez pour voir le moderne ➜
JDK 17+ →
Enterprise Intermédiaire

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);
    }
}
Survolez pour voir le moderne ➜
JDK 17+ →