SpringBoot视图解析实现原理深入分析-Java开发

视图解析其实就是SpringBoot某一个controller的方法执行完成之后，它是跳转到那个页面。由于我们springboot项目默认打包为jar包，是形成压缩包的形式，而jsp又不支持压缩，所以我们SpringBoot不知JSP的，需要引入第三方模板引擎才可以处理

一、写在前面

前面我们分析了Spring boot是如何解析请求参数和如何处理相应信息的

那么它是如何进行视图解析，找到我们要跳转的视图并进行视图渲染的呢？

二、写个demo

为了研究视图解析原理，我们写一个测试代码

首先是控制器类IndexController.java

package com.decade.controller;
import com.decade.pojo.User;
import org.springframework.stereotype.Controller;
import org.springframework.ui.Model;
import org.springframework.util.StringUtils;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.PostMapping;
import javax.servlet.http.HttpSession;
@Controller
public class IndexController {
    /**
     * 来登录页
     * @return 跳转登录页
     */
    @GetMapping(value = {"/","/login"})
    public String loginPage(){
        return "login";
    }
    @PostMapping("/login")
    public String main(User user, HttpSession session, Model model){
        if(StringUtils.hasLength(user.getUserName()) && "123456".equals(user.getPassword())){
            //把登陆成功的用户保存到session中
            session.setAttribute("loginUser", user);
            //登录成功重定向到main.html;  重定向防止刷新首页时表单重复提交
            return "redirect:/main.html";
        }else {
            model.addAttribute("msg","账号密码错误");
            //回到登录页面
            return "login";
        }
    }
    /**
     * 去main页面
     * @return 跳转主页面
     */
    @GetMapping("/main.html")
    public String mainPage(HttpSession session,Model model){
        //是否登录。  拦截器，过滤器
        Object loginUser = session.getAttribute("loginUser");
        if(loginUser != null){
            return "main";
        }else {
            //回到登录页面
            model.addAttribute("msg","请重新登录");
            return "login";
        }
    }
}

<!DOCTYPE html>
<html lang="en" xmlns:th="http://www.thymeleaf.org">
<head>
    <meta charset="utf-8">
    <meta name="viewport" content="width=device-width, initial-scale=1.0, maximum-scale=1.0">
    <meta name="description" content="">
    <meta name="author" content="ThemeBucket">
    <link rel="shortcut icon" href="#" rel="external nofollow"  type="image/png">
    <title>Login</title>
    <link href="css/style.css" rel="external nofollow"  rel="stylesheet">
    <link href="css/style-responsive.css" rel="external nofollow"  rel="stylesheet">
    <!-- HTML5 shim and Respond.js IE8 support of HTML5 elements and media queries -->
    <!--[if lt IE 9]>
    <script src="js/html5shiv.js"></script>
    <script src="js/respond.min.js"></script>
    <![endif]-->
</head>
<body class="login-body">
<div class="container">
    <form class="form-signin" action="index.html" method="post" th:action="@{/login}">
        <div class="form-signin-heading text-center">
            <h1 class="sign-title">Sign In</h1>
            <img src="images/login-logo.png" alt=""/>
        </div>
        <div class="login-wrap">
            <label style="color: red" th:text="${msg}"></label>
            <input type="text" name="userName" class="form-control" placeholder="User ID" autofocus>
            <input type="password" name="password" class="form-control" placeholder="Password">
            <button class="btn btn-lg btn-login btn-block" type="submit">
                <i class="fa fa-check"></i>
            </button>
            <div class="registration">
                Not a member yet?
                <a class="" href="registration.html" rel="external nofollow" >
                    Signup
                </a>
            </div>
            <label class="checkbox">
                <input type="checkbox" value="remember-me"> Remember me
                <span class="pull-right">
                    <a data-toggle="modal" href="#myModal" rel="external nofollow" > Forgot Password?</a>
                </span>
            </label>
        </div>
        <!-- Modal -->
        <div aria-hidden="true" aria-labelledby="myModalLabel" role="dialog" tabindex="-1" id="myModal" class="modal fade">
            <div class="modal-dialog">
                <div class="modal-content">
                    <div class="modal-header">
                        <button type="button" class="close" data-dismiss="modal" aria-hidden="true">&times;</button>
                        <h4 class="modal-title">Forgot Password ?</h4>
                    </div>
                    <div class="modal-body">
                        <p>Enter your e-mail address below to reset your password.</p>
                        <input type="text" name="email" placeholder="Email" autocomplete="off" class="form-control placeholder-no-fix">
                    </div>
                    <div class="modal-footer">
                        <button data-dismiss="modal" class="btn btn-default" type="button">Cancel</button>
                        <button class="btn btn-primary" type="button">Submit</button>
                    </div>
                </div>
            </div>
        </div>
        <!-- modal -->
    </form>
</div>
<script src="js/jquery-1.10.2.min.js"></script>
<script src="js/bootstrap.min.js"></script>
<script src="js/modernizr.min.js"></script>
</body>
</html>

三、流程解析

我们在登录页随机输入用户名和错误的密码，然后点击登录

我们跟踪断点，他还是进入到DispatcherServlet这个类下的doDispatch()方法

然后我们走到RequestMappingHandlerAdapter类下的handleInternal()—>invokeHandlerMethod()

设置参数解析器和返回值处理器

在这里，它就会走到ServletInvocableHandlerMethod类下的invokeAndHandle()方法，通过this.invokeForRequest(webRequest, mavContainer, providedArgs)去调用控制器类中的具体方法

我们发现，如果方法的参数是一个自定义类型对象（例如demo中的User），调用完具体方法后，我们会把他放在ModelAndViewContainer中

断点继续深入，我们走到了HandlerMethodReturnValueHandlerComposite类下的handleReturnValue()，这里它会使用this.selectHandler(returnValue, returnType)去获取自己适合的返回值解析器

然后我们进入到ViewNameMethodReturnValueHandler这个返回值解析器

public void handleReturnValue(@Nullable Object returnValue, MethodParameter returnType, ModelAndViewContainer mavContainer, NativeWebRequest webRequest) throws Exception {
    if (returnValue instanceof CharSequence) {
    	// 获取视图名称
        String viewName = returnValue.toString();
        mavContainer.setViewName(viewName);
        // 判断是否是重定向页面
        if (this.isRedirectViewName(viewName)) {
            mavContainer.setRedirectModelScenario(true);
        }
    } else if (returnValue != null) {
        throw new UnsupportedOperationException("Unexpected return type: " + returnType.getParameterType().getName() + " in method: " + returnType.getMethod());
    }
}

重点：我们可以发现，目标方法处理的过程中，所有数据都会被放在 ModelAndViewContainer 里面。包括数据和视图地址

经过上述处理之后，我们返回到RequestMappingHandlerAdapter类中

ModelAndView var15 = this.getModelAndView(mavContainer, modelFactory, webRequest);

这行代码会将ModelAndViewContainer 中的数据放到ModelAndView中

然后返回到DispatcherServlet这个类中，处理派发结果（页面该如何响应）的关键代码this.processDispatchResult(processedRequest, response, mappedHandler, mv, (Exception)dispatchException);

我们进入该方法进行分析

this.render(mv, request, response); 进行页面渲染逻辑

String viewName = mv.getViewName();获取视图名称

view = this.resolveViewName(viewName, mv.getModelInternal(), locale, request);循环遍历当前系统中所有的视图解析器尝试是否能根据当前返回值得到View对象，符合条件的视图解析器为ContentNegotiatingViewResolver（ContentNegotiationViewResolver 里面包含了下面所有的视图解析器，内部还是利用下面所有视图解析器得到视图对象），最后返回的视图对象为ThymeleafView

下面是几种不同返回值所对应的视图对象

返回值以 forward: 开始： new InternalResourceView(forwardUrl); —> 转发，底层为request.getRequestDispatcher(path).forward(request, response);
返回值以 redirect: 开始： new RedirectView() —> render底层就是重定向
返回值是普通字符串： new ThymeleafView（）—>通过对应的解析处理，并通过writer输出流写出到页面