SpringMVC工程基础入门实践

【1】注册SpringMVC的前端控制器DispatcherServlet

① 默认配置方式

此配置作用下，SpringMVC的配置文件默认位于

WEB-INF

下，默认名称为

<servlet-name>-servlet.xml

，例如，以下配置所对应

SpringMVC

的配置文件位于

WEB-INF

下，文件名为

springMVCservlet.xml

<!-- 配置SpringMVC的前端控制器，对浏览器发送的请求统一进行处理 -->
<servlet>
  <servlet-name>springMVC</servlet-name>
  <servlet-class>org.springframework.web.servlet.DispatcherServlet</servletclass>
</servlet>
<servlet-mapping>
  <servlet-name>springMVC</servlet-name>
  <url-pattern>/</url-pattern>
</servlet-mapping>

设置

springMVC

的核心控制器所能处理的请求的请求路径。

所匹配的请求可以是

/login

或

.html

或

.js

或

.css

方式的请求路径，但是

不能匹配

.jsp

请求路径的请求。

② 扩展配置方式

可通过

init-param

标签设置SpringMVC配置文件的位置和名称，通过

load-on-startup

标签设置

SpringMVC前端控制器DispatcherServlet的初始化时间

<!-- 配置SpringMVC的前端控制器，对浏览器发送的请求统一进行处理 -->
<servlet>
  <servlet-name>springMVC</servlet-name>
  <servlet-class>org.springframework.web.servlet.DispatcherServlet</servletclass>
  <!-- 通过初始化参数指定SpringMVC配置文件的位置和名称 -->
  <init-param>
  <!-- contextConfigLocation为固定值 -->
  <param-name>contextConfigLocation</param-name>
  <!-- 使用classpath:表示从类路径查找配置文件，例如maven工程中的src/main/resources -->
  <param-value>classpath:springMVC.xml</param-value>
  </init-param>
  <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
  <servlet-name>springMVC</servlet-name>
  <url-pattern>/</url-pattern>
</servlet-mapping>

<url-pattern>

标签中使用

和

/*

的区别

所匹配的请求可以是

/login或.html或.js或.css方式

的请求路径，但是

不能匹配

.jsp

请求路径的请

求.因此就可以避免在访问jsp页面时，该请求被DispatcherServlet处理，从而找不到相应的页面

/*

则能够匹配所有请求。例如在使用过滤器时，若需要对所有请求进行过滤，就需要使用

/*

的写法。

【2】与Thymeleaf整合

创建springMVC的配置文件

<!-- 自动扫描包 -->
<context:component-scan base-package="com.mvc.controller"/>
<!-- 配置Thymeleaf视图解析器 -->
<bean id="viewResolver"
  class="org.thymeleaf.spring5.view.ThymeleafViewResolver">
  <property name="order" value="1"/>
  <property name="characterEncoding" value="UTF-8"/>
  <property name="templateEngine">
    <bean class="org.thymeleaf.spring5.SpringTemplateEngine">
      <property name="templateResolver">
        <bean
          class="org.thymeleaf.spring5.templateresolver.SpringResourceTemplateResolver">
          <!-- 视图前缀 -->
          <property name="prefix" value="/WEB-INF/templates/"/>
          <!-- 视图后缀 -->
          <property name="suffix" value=".html"/>
          <property name="templateMode" value="HTML5"/>
          <property name="characterEncoding" value="UTF-8" />
        </bean>
      </property>
    </bean>
  </property>
</bean>

<!--
处理静态资源，例如html、js、css、jpg若只设置该标签，则只能访问静态资源，其他请求则无法访问
此时必须设置<mvc:annotation-driven/>解决问题
-->
<mvc:default-servlet-handler/>

<!-- 开启mvc注解驱动 -->
<mvc:annotation-driven>
  <mvc:message-converters>
    <!-- 处理响应中文内容乱码 -->
    <bean
      class="org.springframework.http.converter.StringHttpMessageConverter">
      <property name="defaultCharset" value="UTF-8" />
      <property name="supportedMediaTypes">
        <list>
          <value>text/html</value>
          <value>application/json</value>
        </list>
      </property>
    </bean>
  </mvc:message-converters>
</mvc:annotation-driven>

浏览器发送请求，若请求地址符合前端控制器的

url-pattern

，该请求就会被前端控制器

DispatcherServlet

处理。前端控制器会读取SpringMVC的核心配置文件，通过扫描组件找到控制器，将请求地址和控制器中

@RequestMapping

注解的

value

属性值进行匹配，若匹配成功，该注解所标识的控制器方法就是处理请求的方法。处理请求的方法需要返回一个字符串类型的视图名称，该视图名称会被视图解析器解析，加上前缀和后缀组成视图的路径，通过Thymeleaf对视图进行渲染，最终转发到视图所对应页面。

【3】CharacterEncodingFilter

Servlet Filter 允许为请求指定一个字符编码。这很有用，因为当前浏览器通常不设置字符编码，即使在HTML页面或表单中指定了字符编码。

如果请求尚未指定编码，则此Filter可以应用其编码，或者在任何情况下强制执行此Filter的编码（

“forceEncoding”=“true”

）。在后一种情况下，编码也将作为默认响应编码应用（尽管这通常会被视图中设置的完整内容类型覆盖）。

<filter>
   <filter-name>CharacterEncodingFilter</filter-name>
   <filter-class>org.springframework.web.filter.CharacterEncodingFilter</filter-class>
   <init-param>
       <param-name>encoding</param-name>
       <param-value>UTF-8</param-value>
   </init-param>
   <init-param>
       <param-name>forceResponseEncoding</param-name>
       <param-value>true</param-value>
   </init-param>
</filter>
<filter-mapping>
   <filter-name>CharacterEncodingFilter</filter-name>
   <url-pattern>/*</url-pattern>
</filter-mapping>

解决GET请求乱码的一种方式是可以修改

Tomcat的server.xml在Connector

标签里面配置

URIEncoding="UTF-8"

，但是只是针对当前Tomcat哦。

原生Servlet中解决POST乱码的一种方式是

request.setCharacterEncoding("UTF-8");

但是在SpringMVC中不好用。因为DispatchServlet在目标方法前从request中获取了参数，故而在目标方法里面再使用

request.setCharacterEncoding("UTF-8");

不生效。

同时注册CharacterEncodingFilter与HiddenHttpMethodFilter次序

在web.xml中注册时，必须先注册

CharacterEncodingFilter

，再注册

HiddenHttpMethodFilter

。原因如下：

在 CharacterEncodingFilter 中通过 request.setCharacterEncoding(encoding)
方法设置字

符集的。
request.setCharacterEncoding(encoding) 方法要求前面不能有任何获取请求参数的操作
而 HiddenHttpMethodFilter 恰恰有一个获取请求方式的操作： String paramValue = request.getParameter(this.methodParam);

【4】域对象共享数据

① 使用ServletAPI向request域对象共享数据

@RequestMapping("/testServletAPI")
public String testServletAPI(HttpServletRequest request){
  request.setAttribute("testScope", "hello,servletAPI");
  return "success";
}

② 使用ModelAndView向request域对象共享数据

@RequestMapping("/testModelAndView")
public ModelAndView testModelAndView(){
  /**
  * ModelAndView有Model和View的功能
  * Model主要用于向请求域共享数据
  * View主要用于设置视图，实现页面跳转
  */
  ModelAndView mav = new ModelAndView();
  //向请求域共享数据
  mav.addObject("testScope", "hello,ModelAndView");
  //设置视图，实现页面跳转
  mav.setViewName("success");
  return mav;
}

③ 使用Model向request域对象共享数据

@RequestMapping("/testModel")
public String testModel(Model model){
  model.addAttribute("testScope", "hello,Model");
  return "success";
}

④ 使用map向request域对象共享数据

@RequestMapping("/testMap")
public String testMap(Map<String, Object> map){
  map.put("testScope", "hello,Map");
  return "success";
}

⑤ 使用ModelMap向request域对象共享数据

@RequestMapping("/testModelMap")
public String testModelMap(ModelMap modelMap){
  modelMap.addAttribute("testScope", "hello,ModelMap");
  return "success";
}

⑥ Model、ModelMap、Map的关系

Model、ModelMap、Map类型的参数其实本质上都是 BindingAwareModelMap 类型的的实例。

public interface Model{}
public class ModelMap extends LinkedHashMap<String, Object> {}
public class ExtendedModelMap extends ModelMap implements Model {}
public class BindingAwareModelMap extends ExtendedModelMap {}

⑦ 向session域共享数据

@RequestMapping("/testSession")
public String testSession(HttpSession session){
  session.setAttribute("testSessionScope", "hello,session");
  return "success";
}

⑧ 向application域共享数据

@RequestMapping("/testApplication")
public String testApplication(HttpSession session){
  ServletContext application = session.getServletContext();
  application.setAttribute("testApplicationScope", "hello,application");
  return "success";
}

【5】SpringMVC的视图

SpringMVC中的视图是View接口，视图的作用渲染数据，将模型Model中的数据展示给用户。SpringMVC视图的种类很多，默认有转发视图和重定向视图。

① 转发视图

当控制器方法中所设置的视图名称

没有任何前缀

时，此时的视图名称会被SpringMVC配置文件中所配置

的视图解析器解析，

视图名称拼接视图前缀和视图后缀所得到的最终路径

，会通过转发的方式实现跳转。

@RequestMapping("/")
  public String index(){
      return "index";
  }

若使用的视图技术为Thymeleaf，在SpringMVC的配置文件中配置了Thymeleaf的视图解析器，由此视图解析器解析之后所得到的是

ThymeleafView

。

SpringMVC中默认的转发视图是

InternalResourceView

。当控制器方法中所设置的视图名称以

"forward:"

为前缀时，创建

InternalResourceView

视图，此时的视图名称不会被SpringMVC配置文件中所配置的视图解析器解析，而是会将前缀

"forward:"

去掉，剩余部分作为最终路径通过转发的方式实现跳转。当工程引入jstl的依赖，转发视图会自动转换为

JstlView

。

② 重定向视图

SpringMVC中默认的重定向视图是RedirectView。当控制器方法中所设置的视图名称以

"redirect:"

为前缀时，创建RedirectView视图，此时的视图名称不会被SpringMVC配置文件中所配置的视图解析器解析，而是会将前缀

"redirect:"

去掉，剩余部分作为最终路径通过重定向的方式实现跳转。

@RequestMapping("/testRedirect")
public String testRedirect(){
  return "redirect:/testParam";
}

③ 视图控制器view-controller

<!--
path：设置处理的请求地址
view-name：设置请求地址所对应的视图名称
-->
<mvc:view-controller path="/testView" view-name="success"></mvc:view-controller>

SpringMVC工程基础入门实践

【1】注册SpringMVC的前端控制器DispatcherServlet

① 默认配置方式

② 扩展配置方式

【2】与Thymeleaf整合

【3】CharacterEncodingFilter

【4】域对象共享数据

① 使用ServletAPI向request域对象共享数据

② 使用ModelAndView向request域对象共享数据

③ 使用Model向request域对象共享数据

④ 使用map向request域对象共享数据

⑤ 使用ModelMap向request域对象共享数据

⑥ Model、ModelMap、Map的关系

⑦ 向session域共享数据

⑧ 向application域共享数据

【5】SpringMVC的视图

① 转发视图

② 重定向视图

③ 视图控制器view-controller

继续阅读

吃透MVC，驯服烂代码吃透MVC，驯服烂代码

驯服烂代码_C＃中的驯服配置

Spring Cloud整合Sleuth，当请求完成后，Zipkin没有链路信息

JAVA自学之路——马士兵

Rabbitmq命令行手动创建队列

整合 Spring 开发框架及服务端技术

SSM整合02---Spring-SpringMVC层一、添加web框架支持二、web.xml三、spring-mvc.xml

SSM框架（二）------------表现层的SpringMVC

Intellij idea基于Maven 的SSM 框架整合

Spring数据和Redis

SpringMVC的启动过程源码分析1 SpringMVC 配置XML的方式启动2 SpringMVC纯注解模式启动

Java Spring 框架

debian9升级4.9.0内核到4.19.2内核过程

SpringCloud微服务（四）之ribbon笔记ribbon是什么？入门案例自定义均衡负载算法

SpringMVC返回客户端Json/XML数据

Ajax发送和获取json数据到Spring mvc 1.spring mvc后端2.web前段