Spring WebMvc ViewResolver 源码深度剖析与实战指南

本文将围绕 Spring WebMvc 的 ViewResolver 体系进行源码级分析，细致解构其主流程、设计思想、核心方法、底层实现、典型应用及高阶扩展。内容涵盖流程图、源码行级注释、实用口诀、业务案例、调试优化技巧、技术集成、架构演进及权威参考，帮助读者知其然更知其所以然。

---

一、ViewResolver 体系综述

1.1 定义与作用

ViewResolver 是 Spring MVC 视图解析的核心接口，负责根据 Controller 返回的逻辑视图名（如 "home"），定位并实例化具体的 View 对象（如 JSP、Freemarker、Thymeleaf 等）。

• 接口定义：

  public interface ViewResolver {
      @Nullable
      View resolveViewName(String viewName, Locale locale) throws Exception;
  }
  

• 主流程：

  1. Controller 返回 ModelAndView("viewName", model)
  2. DispatcherServlet 调用 ViewResolver 解析视图名
  3. 获得具体的 View 实例，渲染输出

1.2 常用实现类

• InternalResourceViewResolver：JSP/Servlet 视图解析
• BeanNameViewResolver：根据 Bean 名字解析
• XmlViewResolver：基于 XML 配置
• ResourceBundleViewResolver：基于资源文件
• ContentNegotiatingViewResolver：内容协商，支持多种视图类型
• ViewResolverComposite：组合模式，链式解析

---

二、主流程源码剖析

2.1 DispatcherServlet 主流程

流程图

核心源码分析

DispatcherServlet#doDispatch

protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception {
    // ...省略前置代码
    ModelAndView mv = ha.handle(processedRequest, response, mappedHandler.getHandler());
    // 视图渲染
    processDispatchResult(processedRequest, response, mappedHandler, mv, dispatchException);
}

DispatcherServlet#resolveViewName

@Nullable
private View resolveViewName(String viewName, @Nullable ModelMap model, Locale locale, HttpServletRequest request) throws Exception {
    for (ViewResolver viewResolver : this.viewResolvers) {
        View view = viewResolver.resolveViewName(viewName, locale);
        if (view != null) {
            return view;
        }
    }
    return null;
}

速记口诀：

“控制器返回名，解析器找视图，模型数据带输出。”

---

三、InternalResourceViewResolver 深度剖析

3.1 设计思想与技巧

• 模板方法模式：父类 UrlBasedViewResolver 定义主流程，子类实现细节。
• 配置灵活性：支持前缀/后缀拼接，简化视图名书写。
• IOC 容器集成：通过 Bean 配置自动装配。

3.2 核心源码分解

主要属性

public class InternalResourceViewResolver extends UrlBasedViewResolver {
    private boolean alwaysInclude = false; // 是否总是 include
}

关键方法

resolveViewName

@Override
public View resolveViewName(String viewName, Locale locale) throws Exception {
    if (!canHandle(viewName, locale)) {
        return null;
    }
    InternalResourceView view = (InternalResourceView) buildView(viewName);
    view.setAlwaysInclude(this.alwaysInclude);
    return applyLifecycleMethods(viewName, view);
}

buildView

protected View buildView(String viewName) throws Exception {
    InternalResourceView view = new InternalResourceView();
    view.setUrl(getPrefix() + viewName + getSuffix());
    return view;
}

行级注释：

// 判断当前 viewName 是否能处理
if (!canHandle(viewName, locale)) {
    return null; // 不支持则返回 null，交给下一个 ViewResolver
}
// 创建 InternalResourceView 实例
InternalResourceView view = (InternalResourceView) buildView(viewName);
// 配置是否总是 include
view.setAlwaysInclude(this.alwaysInclude);
// 应用生命周期方法（如 exposeContextBeansAsAttributes）
return applyLifecycleMethods(viewName, view);

速记口诀：

“拼前缀加后缀，生成视图看配置。”

3.3 优缺点分析

• 优点：

  • 简单易用，配置灵活
  • 支持 JSP、Servlet 等传统视图
  • 与 Spring IoC 无缝集成

• 缺点：

  • 依赖 Servlet 容器，不支持非 Servlet 环境
  • 不适合 RESTful 或多视图类型协商场景

---

四、ContentNegotiatingViewResolver 进阶解析

4.1 设计思想

• 责任链模式：维护一组 ViewResolver，根据请求内容类型选择最优视图。
• 内容协商：支持根据 Accept 头、扩展名、参数等自动选择视图类型（如 JSON/XML/HTML）。

4.2 核心源码

resolveViewName 主流程

public View resolveViewName(String viewName, Locale locale) throws Exception {
    List<View> candidateViews = new ArrayList<>();
    for (ViewResolver viewResolver : this.viewResolvers) {
        View view = viewResolver.resolveViewName(viewName, locale);
        if (view != null) {
            candidateViews.add(view);
        }
    }
    View bestView = getBestView(candidateViews, requestedMediaTypes);
    return bestView;
}

速记口诀：

“遍历候选视图，内容类型选优。”

---

五、典型业务场景与调试优化

5.1 JSP 视图渲染流程举例

配置示例：

<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
    <property name="prefix" value="/WEB-INF/jsp/"/>
    <property name="suffix" value=".jsp"/>
</bean>

Controller 示例：

@RequestMapping("/home")
public String home(Model model) {
    model.addAttribute("user", "张三");
    return "home";
}

渲染流程：

1. 返回 "home"，ViewResolver 拼接为 "/WEB-INF/jsp/home.jsp"
2. DispatcherServlet 调用 JSP 渲染，输出 HTML

调试技巧：

• 开启 DEBUG 日志，追踪视图解析流程
• 检查 viewResolvers 配置顺序，避免优先级冲突
• 利用 HandlerInterceptor 拦截视图渲染过程

5.2 性能优化建议

• 合理配置缓存（如 ViewResolver#setCache）
• 精简视图解析链，避免过多责任链
• 静态资源采用 CDN 或单独路径处理

---

六、技术集成与高阶应用

6.1 集成 Thymeleaf

<bean id="viewResolver" class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
    <property name="templateEngine" ref="templateEngine"/>
    <property name="order" value="1"/>
</bean>

• 支持多视图类型，ViewResolver 可链式配置
• 与 RESTful 及内容协商兼容（可与 ContentNegotiatingViewResolver 结合）

6.2 高阶扩展方案

• 自定义 ViewResolver，支持动态视图选择
• 利用 Spring Boot 自动装配，简化配置
• 集成前后端分离场景，返回 JSON 或 SPA 视图

---

七、底层实现与架构演进

7.1 设计模式应用

• 责任链模式：多 ViewResolver 链式处理
• 模板方法模式：父类定义主流程，子类定制细节
• 组合模式：ViewResolverComposite

7.2 算法与架构演变

• 早期以 JSP 为主，后期支持多视图类型（JSON/XML/模板引擎）
• Spring Boot 通过自动配置，简化 ViewResolver 管理

---

八、权威参考资料

• Spring 官方文档 - ViewResolvers
• Spring 源码 GitHub

---

九、全文总结与系统认知

Spring WebMvc 的 ViewResolver 体系采用多种设计模式与架构技巧，实现了灵活、高效、可扩展的视图解析机制。通过对主流程、核心源码、典型实现、业务场景、调试优化、高阶应用及底层架构的系统性剖析，可以深入理解其工作原理、优缺点及演进方向。掌握 ViewResolver，有助于在实际项目中快速定位视图问题、优化性能、扩展新特性，并实现与其他技术栈的高效集成。

速记口诀：

“控制器给名，解析器找视图，责任链选优，渲染输出快。”

---

结语

本文从源码到架构，从业务到优化，系统性解构了 Spring MVC 的 ViewResolver 体系。希望读者能举一反三，深入实践，成为 Spring WebMvc 视图层的高手！

---

如需更多源码注释、流程图、调试脚本或业务案例，可留言交流。