惊！FrameworkServlet 竟藏着 JavaWeb 的核爆级机密，90% 架构师都没吃透的实战精髓！

原创

疯狂的KK

发布于 2025-07-11 10:29:37

1120

如果你是 Java 开发者，却还在把 FrameworkServlet 当 “透明人”，那简直是在暴殄天物！这玩意儿可不是 SpringMVC 里随便打酱油的角色，它是整个 Web 框架的 “神经中枢”，是连接前端请求与后端业务的 “超级转换器”。今天这篇文章，我敢打包票，绝对能让你对 FrameworkServlet 的理解上升到前所未有的高度，看完之后要是你还觉得没收获，尽管来评论区怼我！

一、FrameworkServlet 的 “前世今生”，不了解它你敢说懂 SpringMVC？

在 JavaWeb 的江湖里，Servlet 是当之无愧的 “开山鼻祖”，而 FrameworkServlet 则是站在巨人肩膀上的 “武林盟主”。它继承自 HttpServlet，却在其基础上玩出了花，把 Spring 的 IoC 容器、请求处理流程、视图解析等核心功能玩得明明白白。

想象一下，如果把 Web 应用比作一家超级商场，那么 HttpServlet 就像是商场里的大门，只能简单地让顾客进进出出；而 FrameworkServlet 则是商场里无所不能的总经理，不仅能引导顾客找到想去的店铺（请求映射），还能协调各个部门（业务组件）为顾客提供服务，甚至能根据顾客的需求打包不同的商品（视图渲染）。

1.1 FrameworkServlet 的核心使命，一句话概括就是 “承上启下”

“承上” 指的是它要处理来自客户端的各种请求，不管是 GET、POST 还是其他奇奇怪怪的请求方法，它都能照单全收；“启下” 则是指它要将这些请求分发给 SpringMVC 中的各个组件去处理，比如 HandlerMapping、HandlerAdapter、ViewResolver 等。

在 SpringMVC 的架构中，FrameworkServlet 就像是一个 “交通枢纽”，所有的请求都必须经过它的调度才能到达目的地。没有它，SpringMVC 的各个组件就是一盘散沙，根本无法协同工作。

1.2 源码初窥，FrameworkServlet 到底长啥样？

咱们先来看看 FrameworkServlet 的类结构，它的继承关系那可是相当清晰：

从这里就能看出，它继承了 HttpServletBean，而 HttpServletBean 又继承了 HttpServlet，所以它本质上还是一个 Servlet，具备 Servlet 的所有特性。同时，它还实现了 ApplicationContextAware 接口，这意味着它能够获取到 Spring 的应用上下文，这可是它能和 Spring 容器无缝对接的关键所在。

二、FrameworkServlet 运行原理大揭秘，看完直呼 “原来如此”！

要想彻底搞懂 FrameworkServlet，就得钻进它的源码里一探究竟。它的核心功能都集中在 doGet、doPost 等方法里，但这些方法最终都会调用一个叫做 processRequest 的方法，这才是它处理请求的 “心脏”。

2.1 processRequest 方法，请求处理的 “总指挥部”

咱们来看看 processRequest 方法的大致流程，我给大家简化一下核心代码：

看完这段代码，是不是有种豁然开朗的感觉？整个 processRequest 方法就像是一个精密的机器，每一步都有其特定的作用：

第一步记录时间，方便后续统计请求处理耗时，这在性能监控中可是个好东西。
第二步和第三步是为了把 LocaleContext 和 RequestAttributes 绑定到当前线程，这样在后续的处理过程中，各个组件就能方便地获取到请求相关的信息，而且还不会相互干扰，这可是线程安全的关键哦。
第四步的 doService 方法是个抽象方法，由子类（比如 DispatcherServlet）去实现，这才是真正处理请求的地方，后面会详细说。
第五步和第六步主要是做清理工作，恢复现场，并发布事件，让其他组件知道请求已经处理完了，方便进行一些后续操作，比如日志记录、性能分析等。

2.2 doService 方法，子类大显身手的舞台

FrameworkServlet 把 doService 方法定义为抽象方法，就是为了让子类根据自己的需求去实现具体的请求处理逻辑。而 DispatcherServlet 作为 FrameworkServlet 最核心的子类，它的 doService 方法可是大有来头。

DispatcherServlet 的 doService 方法会做很多准备工作，比如把一些重要的对象（如 WebApplicationContext、LocaleResolver 等）放入请求属性中，方便后续的组件使用。然后，它会调用 doDispatch 方法，这才是请求处理的 “重头戏”。

2.3 doDispatch 方法，请求处理的 “灵魂所在”

doDispatch 方法的逻辑那可是相当复杂，但咱们可以把它简化成以下几个关键步骤：

获取 Handler：根据当前请求的 URL 和其他信息，通过 HandlerMapping 找到对应的 Handler（也就是处理这个请求的控制器方法）。
获取 HandlerAdapter：找到能执行这个 Handler 的 HandlerAdapter。
执行前置拦截器：调用 HandlerInterceptor 的 preHandle 方法，如果有拦截器返回 false，就终止请求处理。
执行 Handler：通过 HandlerAdapter 执行 Handler，得到 ModelAndView 对象。
执行后置拦截器：调用 HandlerInterceptor 的 postHandle 方法。
处理视图：如果 ModelAndView 不为 null，就通过 ViewResolver 解析视图并渲染。
执行完成后拦截器：调用 HandlerInterceptor 的 afterCompletion 方法。

整个流程环环相扣，每一步都至关重要。而这一切的发起者，都是 FrameworkServlet 的 processRequest 方法，没有它，后面的这些流程都无从谈起。

三、FrameworkServlet 实战代码 Demo，不看代码说再多都是空谈！

光说理论太枯燥，咱们直接上干货，用一个实际的例子来看看 FrameworkServlet 在项目中是怎么用的。不过这里要说明一下，在实际开发中，我们很少会直接去继承 FrameworkServlet 来开发，更多的是使用它的子类 DispatcherServlet。但为了让大家更清楚地理解 FrameworkServlet 的工作原理，我们还是来模拟一个简单的自定义 FrameworkServlet 子类。

3.1 自定义 MyFrameworkServlet，感受 FrameworkServlet 的魅力

首先，我们来创建一个自定义的 MyFrameworkServlet，继承自 FrameworkServlet：

package com.example.frameworkdemo.servlet;

import org.springframework.web.context.WebApplicationContext;

import org.springframework.web.servlet.FrameworkServlet;

import javax.servlet.ServletException;

import javax.servlet.http.HttpServletRequest;

import javax.servlet.http.HttpServletResponse;

import java.io.IOException;

import java.io.PrintWriter;

public class MyFrameworkServlet extends FrameworkServlet {

@Override

protected void doService(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

// 1. 设置响应内容类型

response.setContentType("text/html;charset=UTF-8");

PrintWriter out = response.getWriter();

// 2. 输出一些信息，展示FrameworkServlet的作用

out.println("<h1>欢迎来到MyFrameworkServlet的世界！</h1>");

out.println("<p>当前请求的URL：" + request.getRequestURL() + "</p>");

out.println("<p>当前请求的方法：" + request.getMethod() + "</p>");

在这个自定义的 MyFrameworkServlet 中，我们重写了 doService 方法，在里面添加了一些简单的业务逻辑，比如输出请求信息、获取 Spring 应用上下文等。同时，我们也重写了 doGet 和 doPost 方法，让它们都调用 processRequest 方法，这也是 FrameworkServlet 处理请求的标准方式。

3.2 在 web.xml 中配置 MyFrameworkServlet

要让我们自定义的 Servlet 生效，还需要在 web.xml 中进行配置：

<?xml version="1.0" encoding="UTF-8"?>

<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"

xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"

xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"

version="4.0">

<servlet-name>myFrameworkServlet</servlet-name>

<servlet-class>com.example.frameworkdemo.servlet.MyFrameworkServlet</servlet-class>

<init-param>

<param-name>contextConfigLocation</param-name>

<param-value>classpath:spring-config.xml</param-value>

</init-param>

<load-on-startup>1</load-on-startup>

</servlet>

<servlet-mapping>

<servlet-name>myFrameworkServlet</servlet-name>

<url-pattern>/my/*</url-pattern>

</servlet-mapping>

在配置中，我们指定了 MyFrameworkServlet 的类路径，设置了初始化参数 contextConfigLocation 来指定 Spring 配置文件的位置，还配置了它的 URL 映射为 “/my/*”，这意味着所有以 “/my/” 开头的请求都会被这个 Servlet 处理。

3.3 创建 Spring 配置文件

接下来，我们创建一个简单的 Spring 配置文件 spring-config.xml：

<?xml version="1.0" encoding="UTF-8"?>

<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>

</beans>

在这个配置文件中，我们定义了一个 MyService 的 Bean，并设置了它的 message 属性。

3.4 创建 Service 类

然后，我们来创建 MyService 类：

package com.example.frameworkdemo.service;

public class MyService {

private String message;

public String getMessage() {

return message;

}

public void setMessage(String message) {

this.message = message;

}

public String getWelcomeMessage() {

return "欢迎使用MyService：" + message;

}

这个类很简单，只有一个 message 属性和一个 getWelcomeMessage 方法。

3.5 修改 MyFrameworkServlet，调用 Service

现在，我们来修改一下 MyFrameworkServlet 的 doService 方法，让它调用 MyService 的方法：

@Override

protected void doService(HttpServletRequest request, HttpServletResponse response) throws ServletException, IOException {

// 1. 设置响应内容类型

response.setContentType("text/html;charset=UTF-8");

PrintWriter out = response.getWriter();

// 2. 输出一些信息，展示FrameworkServlet的作用

out.println("<h1>欢迎来到MyFrameworkServlet的世界！</h1>");

out.println("<p>当前请求的URL：" + request.getRequestURL() + "</p>");

out.println("<p>当前请求的方法：" + request.getMethod() + "</p>");

// 3. 获取Spring应用上下文，展示其与Spring容器的集成

WebApplicationContext wac = getWebApplicationContext();

out.println("<p>Spring应用上下文是否存在：" + (wac != null ? "是" : "否") + "</p>");

// 4. 从Spring容器中获取MyService并调用其方法

if (wac != null) {

MyService myService = wac.getBean(MyService.class);

out.println("<p>" + myService.getWelcomeMessage() + "</p>");

}

在这个修改后的 doService 方法中，我们通过 WebApplicationContext 获取到了 MyService 的实例，并调用了它的 getWelcomeMessage 方法，将结果输出到页面上。

3.6 运行效果

当我们启动项目，访问 “http://localhost:8080/my/test” 时，页面上会显示以下内容：

欢迎来到MyFrameworkServlet的世界！

当前请求的URL：http://localhost:8080/my/test

当前请求的方法：GET

Spring应用上下文是否存在：是

欢迎使用MyService：这是来自Spring容器的消息

从这个例子中，我们可以清楚地看到，FrameworkServlet 能够很好地与 Spring 容器集成，通过它我们可以方便地获取到 Spring 容器中的 Bean，并调用其方法来处理业务逻辑。这只是一个简单的示例，在实际项目中，FrameworkServlet（更多的是它的子类 DispatcherServlet）的用法要复杂得多，但核心原理都是一样的。

四、FrameworkServlet 在项目中的实际应用场景，这些场景你肯定遇到过！

FrameworkServlet（主要是其实现类 DispatcherServlet）在项目中的应用场景那可太多了，几乎所有使用 SpringMVC 的项目都离不开它。

4.1 普通 Web 项目的请求处理

这是最常见的场景，用户在浏览器中输入 URL，发送请求到服务器，DispatcherServlet 接收到请求后，按照前面说的流程进行处理，最终将处理结果返回给用户。比如我们在电商网站上浏览商品、加入购物车、提交订单等操作，背后都是 DispatcherServlet 在默默工作。

4.2 RESTful API 接口开发

现在很多项目都采用前后端分离的架构，后端主要提供 RESTful API 接口给前端调用。DispatcherServlet 在这种场景下同样发挥着巨大作用，它可以处理前端发送的各种 HTTP 请求（GET、POST、PUT、DELETE 等），并将请求分发给对应的控制器方法，控制器方法处理完成后返回 JSON 数据给前端。

例如，一个用户管理系统的 RESTful API：