JavaBean、JSP、Servlet,减少耦合,提高可维护性。
Spring MVC 是 Spring 对 MVC 思想实现,其有以下好处:
在 MVC 框架中都存在一个前端控制器,在 WEB 应用的前端(Front)设置一个入口控制器(Controller),是用来提供一个集中的请求处理机制,所有的请求都被发往该控制器统一处理,然后把请求分发给各自相应的处理程序。一般用来做一个共同的处理,如权限检查,授权,日志记录等。因为前端控制的集中处理请求的能力,因此提高了可重用性和可拓展性。
1.1、没有前端控制器
1.2、有前端控制器
Spring MVC 已经提供了一个 DispatcherServlet 类作为前端控制器,所以要使用 Spring MVC 必须在 web.xml 中配置前端控制器。
把处理请求的对象称之为处理器或后端控制器,Spring MVC 中习惯称之为 Controller,如处理员工请求的就会命名为 EmployeeController。
项目名 springmvc-demo,注意打包方式是 war。拷贝依赖和插件:
<groupId>cn.wolfcodegroupId>
<artifactId>springmvc-demoartifactId>
<version>1.0.0version>
<packaging>warpackaging>
<properties>
<spring.version>5.0.8.RELEASEspring.version>
<project.build.sourceEncoding>UTF-8project.build.sourceEncoding>
<maven.compiler.source>11maven.compiler.source>
<maven.compiler.target>11maven.compiler.target>
properties>
<dependencies>
<dependency>
<groupId>org.springframeworkgroupId>
<artifactId>spring-webmvcartifactId>
<version>${spring.version}version>
dependency>
<dependency>
<groupId>javax.servletgroupId>
<artifactId>javax.servlet-apiartifactId>
<version>3.0.1version>
<scope>providedscope>
dependency>
dependencies>
<build>
<plugins>
<plugin>
<groupId>org.opoo.mavengroupId>
<artifactId>tomcat9-maven-pluginartifactId>
<version>3.0.1version>
<configuration>
<path>/path>
<port>80port>
configuration>
plugin>
plugins>
build>
package cn.wolfcode.web.controller;
@Controller
public class HelloController {
// 提供方法处理请求,在浏览器地址栏输入如下 localhost/hello,就会执行下面的方法
@RequestMapping("/hello")
public ModelAndView save() {
ModelAndView mv = new ModelAndView();
// 往作用域或者模型中存入数据
mv.addObject("msg", "Hello Spring MVC");
// 找视图
mv.setViewName("/WEB-INF/views/welcome.jsp");
return mv;
}
}
对应上面的代码路径建 JSP 文件,使用 EL 表达式取值即可。
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
入门
${msg}
在 resources 目录下新建 mvc.xml,配置如下:
<context:component-scan base-package="cn.wolfcode.web.controller"/>
<mvc:annotation-driven/>
在 main 目录新建 webapp/WEB-INF/web.xml,内容如下:
<web-app xmlns="http://java.sun.com/xml/ns/javaee" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://java.sun.com/xml/ns/javaee
http://java.sun.com/xml/ns/javaee/web-app_3_0.xsd"
version="3.0">
<servlet>
<servlet-name>dispatcherServletservlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServletservlet-class>
<init-param>
<param-name>contextConfigLocationparam-name>
<param-value>classpath:mvc.xmlparam-value>
init-param>
<load-on-startup>1load-on-startup>
servlet>
<servlet-mapping>
<servlet-name>dispatcherServletservlet-name>
<url-pattern>/url-pattern>
servlet-mapping>
web-app>
打开浏览器,在地址栏收入 localhost/hello,访问看下效果。
load-on-startup 元素是可选的:若值为 0 或者大于 0 时,表示容器在应用启动时就构建 Servlet 并调用其 init 方法做初始化操作(非负数的值越小,启动该 Servlet 的优先级越高);若值为一个负数时或者没有指定时,则在第一次请求该 Servlet 才加载。
配置的话,就可以让 SpringMVC 初始化的工作在容器启动的时候完成,而不是丢给用户请求去完成,提高用户访问的体验性。
DispatcherServlet 默认会去 WEB-INF 目录下去按照 servletName-servlet.xml 路径去加载 Spring MVC 配置文件。若 servlet-name 元素文本内容是 hello,则去 WEB-INF 目录下寻找 hello-servlet.xml 文件。
一般地,我们从 classpath 路径,显示去加载 SpringMVC 的配置文件。
<init-param>
<param-name>contextConfigLocationparam-name>
<param-value>classpath:mvc.xmlparam-value>
init-param>
RequestMapping 注解是一个用来处理请求地址映射的注解,可用于类或方法上。用于类上,表示类中的所有响应请求的方法都是以该地址作为父路径。还可以限定请求类型和响应类型等。
配置了会往容器中存入 RequestMappingHandlerMapping、RequestMappingHandlerAdapter、ExceptionHandlerExceptionResolver 等三个 bean。除此之外:
可以在 webapp 目录下新建 static/demo.html,访问验证上面的说法。
Tomcat 容器处理静态资源是交由内置 DefaultServlet 来处理的(拦截路径是 /),处理 JSP 资源是交由内置的 JspServlet 处理的(拦截路径是*.jsp | *.jspx)。
启动项目时,先加载容器的 web.xml,而后加载项目中的 web.xml。当拦截路径在两者文件中配置的一样,后面会覆盖掉前者。
所以前端控制器配置拦截路径是 / 的所有静态资源都会交由前端控制器处理,而拦截路径配置 /*,所有静态资源和 JSP 都会交由前端控制器处理。
在 web.xml 中修改,修改前端控制器的映射路径如下:
<servlet-mapping>
<servlet-name>dispatcherServletservlet-name>
<url-pattern>*.dourl-pattern>
servlet-mapping>
但注意,访问控制器里的处理方法时,请求路径须携带 .do。
在 mvc.xml,配置如下即可:
<mvc:default-servlet-handler/>
上述配置会在 Spring MVC 上下文中创建存入一个 DefaultServletHttpRequestHandler 的 bean,它会对进入 DispatcherServlet 的请求进行筛查,若不是映射的请求,就将该请求交由容器默认的 Servlet 处理。
响应处理是指怎么编写控制器里面的处理方法接受请求做响应,找视图文件和往作用域中存入数据。要处理方法要做响应,一般处理方法返回的类型为 ModelAndView 和 String。
方法中返回 ModelAndView 对象,此对象中设置模型数据并指定视图。
package cn.wolfcode.web.controller;
@Controller
public class ResponseController {
// 提供方法处理请求,localhost/resp1
@RequestMapping("/resp1")
public ModelAndView resp1() {
// 通过创建这个类对象,告诉 Spring MVC 找什么视图文件, 往作用域或者说往模型中存入什么数据
ModelAndView mv = new ModelAndView();
// 往作用域或者模型中存入数据
mv.addObject("msg", "方法返回类型是 ModelAndView");
// 找视图
mv.setViewName("/WEB-INF/views/resp.jsp");
return mv;
}
在对应路径下新建 resp.jsp,内容如下:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
响应
${msg}
返回 String 类型(使用广泛),要共享数据,此时和 Model 参数组合使用,用其往作用域或模型中存入数据。
package cn.wolfcode.web.controller;
@Controller
public class ResponseController {
// 提供方法处理请求,localhost/resp2
@RequestMapping("/resp2")
public String resp2(Model model) {
// 往作用域或者模型中存入数据
model.addAttribute("msg", "方法返回类型是 String");
// 返回视图名
return "/WEB-INF/views/resp.jsp";
}
}
因为视图会固定放在一个位置,又因为统一选用一种视图技术,所以视图后缀名也是一样的,那么在处理方法设置视图路径的代码随着项目变大,存在着大量重复。而 Spring MVC 提供可通过配置的方法消除视图路径重复,只需要在 mvc.xml,配置如下即可:
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/WEB-INF/views/"/>
<property name="suffix" value=".jsp"/>
bean>
地址栏 | WEB-INF | 共享请求数据 | 表达重复提交 | |
---|---|---|---|---|
请求转发 | 不变 | 可以访问 | 共享 | 有 |
URL 重定向 | 变 | 不可访问 | 不共享 | 无 |
加上 forward 前缀方式,表示请求转发,相当于 request.getRequestDispatcher().forward(request,response),转发后浏览器地址栏不变,共享之前请求中的数据。
package cn.wolfcode.web.controller;
@Controller
public class ResponseController {
// localhost/f
@RequestMapping("/f")
public String forward() {
return "forward:/WEB-INF/views/welcome.jsp";
}
}
加上 redirect 前缀方式,表示重定向,相当于 response.sendRedirect(),重定向后浏览器地址栏变为重定向后的地址,不共享之前请求的数据。
package cn.wolfcode.web.controller;
@Controller
public class ResponseController {
// localhost/r
@RequestMapping("/r")
public String redirect() {
return "redirect:/static/demo.html";
}
}
在请求转发或者 URL 重定向时,若路径:
/response/test6 —> “redirect:/hello.html” —> localhost:/hello.html
/response/test6 —> “redirect:hello.html” —> localhost:/response/hello.html
处理方法如何获取请求中的参数,而这些参数值是期望用基本数据类型及其包装类、String 和 BigDecimal 等形参接收。
比如请求路径 /req1?username=xx&age=18,就需要编写如下处理方法来接受请求的参数。
package cn.wolfcode.web.controller;
@Controller
public class RequestController {
@RequestMapping("/req1")
public ModelAndView resp1(String username, int age) {
System.out.println(username);
System.out.println(age);
return null;
}
}
比如请求路径 /req2?username=xx&age=18,就需要编写如下处理方法来接受请求的参数。
package cn.wolfcode.web.controller;
@Controller
public class RequestController {
@RequestMapping("/req2")
// 此时请求参数为 name,而形参名为 username
public ModelAndView resp2(@RequestParam("username")String name, int age) {
System.out.println(name);
System.out.println(age);
return null;
}
}
Tomcat7 及之前手动修改配置文件,使用代码手动转;但若使用 Maven 的话,可以 pom.xml 中的 Tomcat 插件配置一行也可以解决:
<uriEncoding>UTF-8uriEncoding>
Tomcat8 已处理这个问题,不需要额外配置。
在 web.xml 直接使用 Spring MVC 内置的过滤器来处理。
<filter>
<filter-name>characterEncodingFilterfilter-name>
<filter-class>org.springframework.web.filter.CharacterEncodingFilterfilter-class>
<init-param>
<param-name>encodingparam-name>
<param-value>UTF-8param-value>
init-param>
filter>
<filter-mapping>
<filter-name>characterEncodingFilterfilter-name>
<url-pattern>/*url-pattern>
filter-mapping>
处理方法如何获取请求中的参数,而这些参数值是期望用自定义类型、数组类型等形参接收。
比如请求路径 /req3?ids=1&ids=2&ids=3,就需要编写如下处理方法来接受请求的参数。
package cn.wolfcode.web.controller;
@Controller
public class RequestController {
@RequestMapping("/req3")
public ModelAndView resp3(Long[] ids) {
System.out.println(Arrays.toString(ids));
return null;
}
}
比如有个保存用户的需求,请求时携带用户名和密码参数,后端期望创建一个用户对象来封装这些参数值。
用来封装参数值。
package cn.wolfcode.domain;
public class User {
private Long id;
private String Username;
private String password;
// 省略 setter getter toString
}
比如请求路径 /req4?username=hehe&password=666,注意传递参数名与封装对象的属性名一致,就需要编写如下处理方法。
package cn.wolfcode.web.controller;
@Controller
public class RequestController {
@RequestMapping("/req4")
public ModelAndView resp4(User user) {
System.out.println(user);
return null
}
}
底层 Spring MVC 根据请求地址对应调用处理方法,调用方法时发现要传递 User 类型的实参,Spring MVC 会反射创建 User 对象,之后通过请求参数名找对应的属性,给对象的属性设置对应的参数值。
开发中处理时间字符串的格式是比较常遇到的问题,之前你们是怎么做的?那使用 Spring MVC 肯定帮我们简化很多工作,但有些东西是简化不了的,你们觉得是什么?
比如请求路径 /req5?date=2020-05-19,就需要编写如下处理方法来接受请求的参数。
package cn.wolfcode.web.controller;
@Controller
public class RequestController {
@RequestMapping("/req5")
// 注意形参的类型为 java.util.Date
public ModelAndView resp5(@DateTimeFormat(pattern="yyyy-MM-dd")Date date) {
System.out.println(date.toLocaleString());
return null;
}
}
package cn.wolfcode.domain;
public class User {
private Long id;
private String Username;
private String password;
// 增加下面这个字段,并贴注解
@DateTimeFormat(pattern="yyyy-MM-dd")
private Date date;
// 省略 setter getter toString
}
比如请求路径 /req6?date=2020-05-19,就需要编写如下处理方法来接受请求的参数。
package cn.wolfcode.web.controller;
@Controller
public class RequestController {
@RequestMapping("/req6")
public ModelAndView resp6(User user) {
System.out.println(user);
return null;
}
}
可以贴在方法和形参上,这里重点讲贴在形参。形参前提是自定义类型,会存到模型中,可在视图中获取到。后期项目用于查询条件回显用。
package cn.wolfcode.web.controller;
@Controller
public class RequestController {
@RequestMapping("/req7")
public String resp7(User user) {
return "m";
}
}
新建 webapp/WEB-INF/views/m.jsp,文件内容如下:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
ModelAttribute 注解
${user}
访问路径 请求路径 /req7?username=hehe&password=666
package cn.wolfcode.web.controller;
@Controller
public class RequestController {
@RequestMapping("/req7")
// 给形参贴 @ModelAttribute,用来修改存在模型中使用的 key
public String resp7(@ModelAttribute("u")User user) {
return "m";
}
}
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
ModelAttribute 注解
${u}
访问路径 请求路径 /req7?username=hehe&password=666
回顾之前使用 Servlet3.0 来解决文件上传的问题,编写上传表单(POST、multipart/form-data),还在处理方法 doPost 中编写解析上传文件的代码。但现在我们使用 Spring MVC,其可以帮我们简化开发。你们觉得能简化什么地方?
新建 webapp/static/upload.html,注意请求数据类型必须是:multipart/form-data,且请求方式是 POST。
DOCTYPE html>
<html>
<head>
<meta charset="UTF-8">
<title>文件上传title>
head>
<body>
<form action="/upload" method="POST" enctype="multipart/form-data">
文件:<input type="file" name="pic"><br>
<input type="submit" value="提交"/>
form>
body>
html>
设置文件上传大小等。
<servlet>
<servlet-name>dispatcherServletservlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServletservlet-class>
<init-param>
<param-name>contextConfigLocationparam-name>
<param-value>classpath:mvc.xmlparam-value>
init-param>
<load-on-startup>1load-on-startup>
<multipart-config>
<max-file-size>52428800max-file-size>
<max-request-size>52428800max-request-size>
multipart-config>
servlet>
<servlet-mapping>
<servlet-name>dispatcherServletservlet-name>
<url-pattern>/url-pattern>
servlet-mapping>
在 mvc.xml,配置上传解析器,注意上传解析器这个 bean 名称是固定的,必须为 multipartResolver。
<bean id="multipartResolver" class="org.springframework.web.multipart.support.StandardServletMultipartResolver"/>
package cn.wolfcode.web.controller;
@Controller
public class UploadController {
// Spring 容器存在 ServletContext 类型的对象,所以定义好 ServletContext 类型字段贴 @Autowired 注解即可获取到
@Autowired
private ServletContext servletContext;
@RequestMapping("/upload")
public ModelAndView upload(Part pic) throws Exception {
System.out.println(pic.getContentType()); // 文件类型
System.out.println(pic.getName()); // 文件参数名
System.out.println(pic.getSize()); // 文件大小
System.out.println(pic.getInputStream()); // 文件输入流
// FileCopyUtils.copy(in, out),一个 Spring 提供的拷贝方法
// 获取项目 webapp 目录下 uploadDir 目录的绝对路径
System.out.println(servletContext.getRealPath("/uploadDir"));
return null;
}
}
Spring MVC 提供的,若配置在 Spring MVC 配置文件中,则被 Spring 容器管理,主要用于对请求访问控制器的方法进行拦截,在后面的项目中用于登录与权限判断。
package cn.wolfcode.web.interceptor;
public class MyInterceptor implements HandlerInterceptor {
// 处理方法之前
// 返回 false,就被拦截;返回 true 就放行
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
System.out.println("preHandle");
return true;
}
// 处理方法之后,渲染视图之前
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("postHandle");
}
// 渲染视图之后
@Override
public void afterCompletion(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) throws Exception {
System.out.println("afterCompletion");
}
}
在 mvc.xml,配置如下
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<bean class="cn.wolfcode.web.interceptor.MyInterceptor"/>
mvc:interceptor>
mvc:interceptors>
在浏览器输入地址访问某个控制器中某个方法,看下控制台的打印结果。