精盡Spring MVC源碼分析 - RequestToViewNameTranslator 組件

該系列文檔是本人在學習 Spring MVC 的源碼過程當中總結下來的，可能對讀者不太友好，請結合個人源碼註釋 Spring MVC 源碼分析 GitHub 地址 進行閱讀

Spring 版本：5.2.4.RELEASE

該系列其餘文檔請查看：《精盡 Spring MVC 源碼分析 - 文章導讀》

RequestToViewNameTranslator 組件

RequestToViewNameTranslator 組件，視圖名稱轉換器，用於解析出請求的默認視圖名。就是說當 ModelAndView 對象不爲 null，可是它的 View 對象爲 null，則須要經過 RequestToViewNameTranslator 組件根據請求解析出一個默認的視圖名稱。

回顧

先來回顧一下在 DispatcherServlet 中處理請求的過程當中哪裏使用到 RequestToViewNameTranslator 組件，能夠回到《一個請求的旅行過程》中的 DispatcherServlet 的 doDispatch 方法中看看，以下：

protected void doDispatch(HttpServletRequest request, HttpServletResponse response) throws Exception {
    HttpServletRequest processedRequest = request;
    try {
        ModelAndView mv = null;
        try {
            // ... 省略相關代碼
            
            // <6> 真正的調用 handler 方法，也就是執行對應的方法，並返回視圖
            mv = ha.handle(processedRequest, response, mappedHandler.getHandler());
            
            // ... 省略相關代碼
            
            // <8> 無視圖的狀況下設置默認視圖名稱
            applyDefaultViewName(processedRequest, mv);
            
            // ... 省略相關代碼
        }
        catch (Exception ex) {
            dispatchException = ex; // <10> 記錄異常
        }
        // <11> 處理正常和異常的請求調用結果
        processDispatchResult(processedRequest, response, mappedHandler, mv, dispatchException);
    }
    catch (Exception ex) { // <12> 已完成處理 攔截器 }
    finally { }
}

private void applyDefaultViewName(HttpServletRequest request, @Nullable ModelAndView mv) throws Exception {
    if (mv != null && !mv.hasView()) {
        String defaultViewName = getDefaultViewName(request);
        if (defaultViewName != null) {
            mv.setViewName(defaultViewName);
        }
    }
}

@Nullable
protected String getDefaultViewName(HttpServletRequest request) throws Exception {
    return (this.viewNameTranslator != null ? this.viewNameTranslator.getViewName(request) : null);
}

在上面方法的<8>處，會調用 applyDefaultViewName(HttpServletRequest request, @Nullable ModelAndView mv) 方法，若是返回的 ModelAndView 對象不爲 null，可是他的 View 對象爲 null，則須要經過 viewNameTranslator 的 getViewName(HttpServletRequest request) 方法，從請求中獲取默認的視圖名，若是獲取到了則設置到 ModelAndView 對象中

applyDefaultViewName(HttpServletRequest request, @Nullable ModelAndView mv) 這個方法還會在處理異常的時候調用，由於處理異常也返回 ModelAndView 對象，因此須要作「相似」的處理

RequestToViewNameTranslator 接口

org.springframework.web.servlet.RequestToViewNameTranslator，視圖名稱轉換器，用於解析出請求的默認視圖名，代碼以下：

public interface RequestToViewNameTranslator {
	/**
	 * 根據請求，得到其視圖名
	 */
	@Nullable
	String getViewName(HttpServletRequest request) throws Exception;
}

RequestToViewNameTranslator 接口體系的結構以下：

Spring MVC 就提供一個實現類：org.springframework.web.servlet.view.DefaultRequestToViewNameTranslator

我看了一下，Spring Boot 沒有提供其餘的實現類

初始化過程

在 DispatcherServlet 的 initRequestToViewNameTranslator(ApplicationContext context) 方法，初始化 RequestToViewNameTranslator 組件，方法以下：

private void initRequestToViewNameTranslator(ApplicationContext context) {
    try {
        this.viewNameTranslator =
                context.getBean(REQUEST_TO_VIEW_NAME_TRANSLATOR_BEAN_NAME, RequestToViewNameTranslator.class);
        if (logger.isTraceEnabled()) {
            logger.trace("Detected " + this.viewNameTranslator.getClass().getSimpleName());
        }
        else if (logger.isDebugEnabled()) {
            logger.debug("Detected " + this.viewNameTranslator);
        }
    }
    catch (NoSuchBeanDefinitionException ex) {
        // We need to use the default.
        /**
         * 若是未找到，則獲取默認的 RequestToViewNameTranslator 對象
         * {@link org.springframework.web.servlet.view.DefaultRequestToViewNameTranslator}
         */
        this.viewNameTranslator = getDefaultStrategy(context, RequestToViewNameTranslator.class);
        if (logger.isTraceEnabled()) {
            logger.trace("No RequestToViewNameTranslator '" + REQUEST_TO_VIEW_NAME_TRANSLATOR_BEAN_NAME +
                    "': using default [" + this.viewNameTranslator.getClass().getSimpleName() + "]");
        }
    }
}

1. 得到 Bean 名稱爲 "viewNameTranslator"，類型爲 RequestToViewNameTranslator 的 Bean ，將其設置爲 viewNameTranslator

2. 若是未得到到，則得到默認配置的 RequestToViewNameTranslator 實現類，調用 getDefaultStrategies(ApplicationContext context, Class<T> strategyInterface) 方法，就是從 DispatcherServlet.properties 文件中讀取 RequestToViewNameTranslator 的默認實現類，以下：

   org.springframework.web.servlet.RequestToViewNameTranslator=org.springframework.web.servlet.view.DefaultRequestToViewNameTranslator

DefaultRequestToViewNameTranslator

org.springframework.web.servlet.view.DefaultRequestToViewNameTranslator 實現 RequestToViewNameTranslator 接口，默認且是惟一的 RequestToViewNameTranslator 實現類

構造方法

public class DefaultRequestToViewNameTranslator implements RequestToViewNameTranslator {

	private static final String SLASH = "/";
	/**
	 * 前綴
	 */
	private String prefix = "";
	/**
	 * 後綴
	 */
	private String suffix = "";
	/**
	 * 分隔符
	 */
	private String separator = SLASH;
	/**
	 * 是否移除開頭 {@link #SLASH}
	 */
	private boolean stripLeadingSlash = true;
	/**
	 * 是否移除末尾 {@link #SLASH}
	 */
	private boolean stripTrailingSlash = true;
	/**
	 * 是否移除拓展名
	 */
	private boolean stripExtension = true;
	/**
	 * URL 路徑工具類
	 */
	private UrlPathHelper urlPathHelper = new UrlPathHelper();
}

getViewName

實現 getViewName(HttpServletRequest request) 方法，代碼以下：

@Override
public String getViewName(HttpServletRequest request) {
    // 得到請求路徑
    String lookupPath = this.urlPathHelper.getLookupPathForRequest(request);
    // 得到視圖名
    return (this.prefix + transformPath(lookupPath) + this.suffix);
}

@Nullable
protected String transformPath(String lookupPath) {
    String path = lookupPath;
    // 移除開頭 SLASH
    if (this.stripLeadingSlash && path.startsWith(SLASH)) {
        path = path.substring(1);
    }
    // 移除末尾 SLASH
    if (this.stripTrailingSlash && path.endsWith(SLASH)) {
        path = path.substring(0, path.length() - 1);
    }
    // 移除拓展名
    if (this.stripExtension) {
        path = StringUtils.stripFilenameExtension(path);
    }
    // 替換分隔符
    if (!SLASH.equals(this.separator)) {
        path = StringUtils.replace(path, SLASH, this.separator);
    }
    return path;
}

1. 經過 urlPathHelper 獲取該請求的請求路徑
2. 調用 transformPath(String lookupPath) 方法，得到視圖名，並添加先後綴（默認都是空的）。實際上就是你的請求 URI

總結

本文對 Spring MVC 的RequestToViewNameTranslator 組件進行了分析，視圖名稱轉換器，用於解析出請求的默認視圖名。當 ModelAndView 對象不爲 null，可是它的 View 對象爲 null，則須要經過 RequestToViewNameTranslator 組件根據請求解析出一個默認的視圖名稱。默認的 DefaultRequestToViewNameTranslator 實現類返回的就是請求的 URI。

咱們目前最經常使用的 @ResponseBody 註解，對應的 RequestResponseBodyMethodProcessor 返回值處理器，所獲得的 ModelAndView 對象爲 null，因此不會用到該組件，也不會進行視圖渲染，先後端分離嘛~

很輕鬆~ 哈哈 😄

參考文章：芋道源碼《精盡 Spring MVC 源碼分析》