الرئيسية / 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+ →