【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
当控制器方法中,仅仅用来实现页面跳转,即只需要设置视图名称时,可以将处理器方法使用<mvc:view-controller/>
标签进行表示。
<!-- path:设置处理的请求地址 view-name:设置请求地址所对应的视图名称 --> <mvc:view-controller path="/testView" view-name="success"></mvc:view-controller>
当SpringMVC中设置任何一个view-controller
时,其他控制器中的请求映射将全部失效,此时需要在SpringMVC的核心配置文件中设置开启mvc注解驱动的标签:<mvc:annotation-driven />