DispatcherServlet: Kiến Trúc Front Controller Spring MVC

TL;DR: DispatcherServlet là Front Controller duy nhất trong Spring MVC tiếp nhận toàn bộ HTTP request trước khi điều phối đến handler phù hợp. Kiến trúc này tập trung các logic dùng chung (xác thực, logging, chuyển đổi định dạng và bắt lỗi) về một điểm duy nhất thay vì lặp lại trên từng servlet riêng lẻ. Servlet ủy thác công việc cho 9 bean hạ tầng cốt lõi như HandlerMapping, HandlerAdapter và HttpMessageConverter. Cơ chế Auto-configuration tự động thiết lập toàn bộ hệ sinh thái này mà không cần cấu hình thủ công.

Vì sao Front Controller giải quyết triệt để hạn chế của Page Controller?

Trong kiến trúc Java EE truyền thống, mô hình Page Controller yêu cầu mỗi đường dẫn URL phải được ánh xạ tới một lớp servlet độc lập:

GET /orders         -> OrderListServlet.doGet()
POST /orders        -> OrderCreateServlet.doPost()
DELETE /orders/42   -> OrderDeleteServlet.doDelete()

Cách tiếp cận này bộc lộ ba điểm yếu lớn:

1. Trùng lặp các mối quan tâm dùng chung (cross-cutting concerns): Mỗi servlet đều phải tự viết lại kiểm tra quyền truy cập, ghi log và xử lý ngoại lệ.
2. Cồng kềnh cấu hình: File web.xml chứa hàng trăm dòng khai báo ánh xạ servlet phức tạp.
3. Rất khó viết unit test: Do servlet bị gắn chặt vào servlet container nên khó có thể kiểm thử cô lập logic nghiệp vụ.

Mô hình Front Controller giải quyết triệt để vấn đề trên: một servlet duy nhất (DispatcherServlet) đứng ở cửa ngõ nhận mọi request. Các bộ lọc dùng chung được gắn phía trước, còn các phương thức xử lý nghiệp vụ trở thành những phương thức Java thuần túy (POJO) không còn phụ thuộc trực tiếp vào servlet API.

Bản chất hoạt động của DispatcherServlet và luồng doDispatch là gì?

DispatcherServlet kế thừa trực tiếp từ HttpServlet chuẩn của Java. Khi servlet container tiếp nhận request, phương thức service() sẽ chuyển tiếp đến hàm trung tâm doDispatch(request, response):

Quy trình 9 bước điều phối chuẩn xác:

1. Servlet container (như Tomcat) nhận request và chuyển vào DispatcherServlet.doDispatch().
2. Hàm getHandler(request) duyệt qua danh sách HandlerMapping để tìm kiếm controller method phù hợp.
3. Trả về HandlerExecutionChain chứa method đích cùng danh sách các interceptor liên quan.
4. getHandlerAdapter(handler) tìm kiếm adapter tương thích với loại controller được gọi.
5. Thực thi phương thức preHandle() trên từng interceptor; nếu trả về false, chuỗi xử lý dừng lại ngay lập tức.
6. Adapter giải nén tham số từ HTTP request và gọi thực thi method của controller.
7. Controller xử lý logic và trả về dữ liệu kết quả (dạng object hoặc ResponseEntity).
8. HttpMessageConverter chuyển đổi đối tượng trả về thành chuỗi JSON/XML trong thân HTTP response.
9. Thực thi lần lượt postHandle() và afterCompletion() trên các interceptor theo chiều ngược lại.

9 bean hạ tầng nào cùng phối hợp trong DispatcherServlet?

Để đảm bảo nguyên lý Dependency Inversion, DispatcherServlet không tự xử lý toàn bộ công việc mà ủy nhiệm cho 9 bean hạ tầng:

Khi một ngoại lệ xuất hiện trong controller, hệ thống chuyển giao cho chuỗi HandlerExceptionResolver để định dạng mã lỗi:

Spring Boot tự động cấu hình DispatcherServlet như thế nào?

Spring Boot tự động thiết lập toàn bộ hệ thống thông qua hai lớp auto-configuration:

DispatcherServletAutoConfiguration chịu trách nhiệm khởi tạo bean DispatcherServlet và đăng ký với Tomcat dưới đường dẫn "/":

@AutoConfiguration
@ConditionalOnWebApplication(type = SERVLET)
@ConditionalOnClass(DispatcherServlet.class)
public class DispatcherServletAutoConfiguration {

    @Bean
    @ConditionalOnMissingBean
    public DispatcherServlet dispatcherServlet() {
        return new DispatcherServlet();
    }
}

Kế đến, WebMvcAutoConfiguration nạp toàn bộ 9 bean hạ tầng đi kèm:

@AutoConfiguration(after = DispatcherServletAutoConfiguration.class)
@ConditionalOnWebApplication(type = SERVLET)
@ConditionalOnMissingBean(WebMvcConfigurationSupport.class)
public class WebMvcAutoConfiguration {
    // Registers RequestMappingHandlerMapping, Jackson converters, etc.
}

Để thêm interceptor hoặc cấu hình CORS mà không làm mất các thiết lập mặc định, lập trình viên sử dụng giao diện WebMvcConfigurer:

@Configuration
public class WebMvcConfig implements WebMvcConfigurer {

    @Override
    public void addCorsMappings(CorsRegistry registry) {
        registry.addMapping("/api/**")
                .allowedOrigins("https://olhub.vn");
    }
}

Điểm khác biệt mấu chốt giữa Servlet Filter và HandlerInterceptor là gì?

Cả hai đều có khả năng chặn bắt request nhưng hoạt động ở hai tầng kiến trúc hoàn toàn tách biệt:

Những lỗi cấu hình kinh điển nào thường gặp với DispatcherServlet?

Dưới đây là các cạm bẫy cấu hình cần tránh:

1. Thêm annotation @EnableWebMvc trong Spring Boot: Làm vô hiệu hóa hoàn toàn WebMvcAutoConfiguration, khiến ứng dụng mất bộ chuyển đổi Jackson JSON và trang lỗi mặc định.
2. Dùng interceptor để xác thực bảo mật thay vì Filter: Khi client gửi request đến một đường dẫn 404 không tồn tại, interceptor sẽ không chạy, làm hở các lỗ hổng giám sát.
3. Ghi đè nhầm configureMessageConverters: Phương thức này sẽ xóa sạch các converter mặc định của Spring Boot. Luôn dùng extendMessageConverters nếu chỉ muốn bổ sung converter mới.

Tóm tắt

• DispatcherServlet hiện thực mẫu Front Controller, đóng vai trò cửa ngõ tập trung toàn bộ HTTP request.
• Phương thức doDispatch() điều phối quy trình 9 bước từ tìm kiếm handler đến tuần tự hóa dữ liệu phản hồi.
• 9 bean hạ tầng đảm nhiệm các tác vụ độc lập, giúp hệ thống dễ dàng mở rộng theo nguyên lý hướng đối tượng.
• Mở rộng cấu hình tầng web an toàn bằng cách implement WebMvcConfigurer và tránh lạm dụng @EnableWebMvc.
• Servlet Filter hoạt động ở tầng ngoài cùng của servlet container, trong khi HandlerInterceptor can thiệp sâu vào ngữ cảnh controller của Spring.

Tự kiểm tra

Bài tiếp theo: URL Routing & Request Pipeline