文章目录
Spring MVC概述
SpringMVC是主流的实现MVC设计模式的‘’框架,是Spring框架的一个子模块,开发起来更加快捷
MVC设计模式
将程序分为Model、view、Controller三层,Controller接受客户端请求,调用Model生成业务数据,传递给View
Spring MVC就是对这套流程的封装,屏蔽了很多底层代码,开放出接口,让开发者可以更加轻松、边界地完成基于MVC模式的Web开发
Spring MVC的核心组件
- DispatcherServlet:前置控制器,是整个控制流程的核心,控制其他组件的执行,进行统一调度,降低组件之间的耦合,相当于总指挥
- Handler:处理器,完成具体的业务逻辑,相当于Servlet或Action
- HandlerMapping:DispatcherServlet接收到请求后,通过HandlerMapping将不同的请求映射到不同的Handler
- HandlerIntercepter:处理器拦截器,是一个接口,如果需要完成一些拦截处理,可以实现该接口
- HandlerExecutionChain:处理器执行链,包括两部分:Handler和HandlerInterceptor(系统会有一个默认的HandlerInterceptor,如果需要额外设置拦截,可以添加拦截器)
- HandlerAdapter:处理适配器,Handler执行业务方法之前,需要进行一系列的操作,包括表单数据的验证、数据类型的转换、将表单数据封装到JavaBean等,这些操作都是由HandlerAdapter来完成,开发者只需要将注意力集中业务逻辑的处理上,DispatcherServlet通过HandlerAdapter执行不同的Handler。
- ModelAndView:装载率模型数据和视图信息,作为Handler的处理结果,返回给DispatcherServlet
- ViewResoler:视图解析器,DispatcherServlet通过它将逻辑视图解析为物理视图,最终将渲染结果响应给客户端
Spring MVC的工作流程
- 客户端请求被DispatcherServlet接收
- 根据HandlerMapping映射到Handler
- 生成Handler和HandlerInterceptor
- Handler和Handlerinterceptor以HandlerExecutionChain的形式一并返回给DispatcherServlet
- DispatcherServlet同伙HandlerAdapter调用Handler的方法完成业务逻辑处理
- Handler返回一个ModelAndView给DispatcherServlet
- DispatcherServlet将获取的ModelAndView对象传给ViewResolver视图计息期,将逻辑视图解析为物理视图
- ViewResolver返回一个View给DispatcherServlet
- DispatcherServlet根据View进行视图渲染(将模型数据Model填充到视图View中)
10.DispatcherServlet将渲染后的结果响应给客户端
如何使用
SpringMVC流程非常复杂,但实际开发很简单,因为大部分组件不需要开发者创建、管理,只需要通过配置文件的方式完成配置即可。真正需要开发者进行处理的只有Handler、View
创建Maven工程,pom.xml
当看到build success时,项目就已经创建成功
在main中新建两个文件夹:java和resources
分别标记为root文件,这样才能是maven项目文件
在maven文件中编写pom.xml
改为
<dependencies>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.0.11.RELEASE</version>
</dependency>
</dependencies>
如果中间爆红,打开右边竖着的maven
刷新一下即可
在web.xml中配置DispatcherServlet,添加如下代码
<servlet>
<servlet-name>dispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<init-param>
<param-name>contextConfigLocation</param-name> <!--上下文配置路径-->
<param-value>classpath:springmvc.xml</param-value><!--classpath是指resources根目录-->
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>dispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
配置springmvc.xml
在source中创建springmvc.xml
写入以下代码
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xsi:schemaLocation="
http://www.springframework.org/schema/beans
http://www.springframework.org/schema/beans/spring-beans.xsd
http://www.springframework.org/schema/context
http://www.springframework.org/schema/context/spring-context.xsd">
<!-- 自动扫描 -->
<context:component-scan base-package="com.makerjack"></context:component-scan>
<!-- 配置视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
</beans>
创建Handler
package com.makerjack.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
public class HelloHandler {
@RequestMapping("/index")
public String index(){
System.out.println("执行了index...");
return "index";
}
}
用Tomcat运行即可
Spring MVC注解
@RequestMapping
SpringMVC通过@RequestMapping注解将URL请求与业务方法进行映射,在Handler的类定义处以及方法定义处都可以添加@RequestMapping,在类定义处添加,相当于客户端多了一层访问路径
相关参数
- value:指定URL请求的实际地址,是@RequestMapping的默认值(可省略)
@RequestMapping("/hello")
//相当于
@RequestMapping(value="/hello")
- method:指定请求的method类型,GET POST PUT DELETE
public class HelloHandler {
@RequestMapping("/index",method = RequestMethod.GET)
public String index(){
System.out.println("执行了index...");
return "index";
}
}
表示index方法只能接受GET请求
如果发送post请求,就返回服务器不允许
- params:指定请求中必须包含某些参数,否则不返回
public class HelloHandler {
@RequestMapping(value = "/index",method = RequestMethod.GET,params = {"name","id"})
public String index(){
System.out.println("执行了index...");
return "index";
}
}
如果参数有限定(比如id=10)那么只有当id=10时,才能返回
如果想获取客户端发来的数据
public class HelloHandler {
@RequestMapping(value = "/index",method = RequestMethod.GET,params = {"name","id=10"})
public String index(String name,String id){
System.out.println("执行了index...name="+name+",id="+id);
return "index";
}
}
如果index的参数与params名称不一致,无法获取客户端传递的值
如果强制需要不一致,那么添加@Requestparam注解完成HTTp请求与业务方法映射
public class HelloHandler {
@RequestMapping(value = "/index",method = RequestMethod.GET,params = {"m","s=10"})
public String index(@Requestparam("m") String name,@Requestparam("s") int id){
System.out.println("执行了index...name="+name+",id="+id);
return "index";
}
}
此处讲请求的参数m s分别赋值给形参name id,同时自动完成数据类型转换,将“10”转为int类型的10
@Controller
@Controller在类的定义处添加,将该类交给IoC容器来管理(结合springmvc.xml的自动扫描配置使用),同时使其成为一个控制器,可以接受客户端请求
package com.makerjack.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
@Controller
@RequestMapping("/hello")
/*为了应对重复映射的情况,给当前Handler加上前缀,
添加前访问http://localhost:8080/index即可,
添加后访问http://localhost:8080/hello/index
*/
public class HelloHandler {
@RequestMapping("/index")
public String index(){
System.out.println("执行了index...");
return "index";
}
}
@CookieValue
Spring MVC通过映射可以直接在业务方法中获取Cookie的值
@RequestMapping("/cookie")
public String cookie(@CookieValue(value = "JSESSIONID") String sessionId){
System.out.println(sessionId);
return "index";
}
JavaBean
JavaBean绑定参数,Spring MVC会根据请求参数名和JavaBean属性名进行自动匹配,自动为对象填充属性值,同时支持级联属性(对象中含有对象)
新建一个class类以存储用户对象
Lombok是一个Java库,能自动插入编辑器并构建工具,简化Java开发。通过添加注解的方式,不需要为类编写getter或eques方法,同时可以自动化日志变量。
在pom.xml中添加如下依赖
<dependency>
<groupId>org.projectlombok</groupId>
<artifactId>lombok</artifactId>
<version>1.18.6</version>
<scope>provided</scope>
</dependency>
</dependencies>
创建register注册页面
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<form action="/hello/save" method="post">
用户id:<input type="text" name="id"/><br>
用户名:<input type="text" name="name"/><br>
<input type="submit" value="注册"/>
</form>
</body>
</html>
在处理器中添加如下函数映射
@RequestMapping(value = "/save",method = RequestMethod.POST)
public String save(User user){
System.out.println(user);
return "index";
}
运行服务器,访问localhost:8080/register.jsp
如果用户名是中文,则会出现
解决中文乱码的方式,就是在web.xml中添加个过滤器,编码格式设为UTF-8
<filter>
<filter-name>encodingFilter</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>
</filter>
<filter-mapping>
<filter-name>encodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
添加级联
随便增加一个类,给主类做属性用
添加这个输入框
这里不同于上面的id name他们是变量,可以直接赋值,而address是对象,不能直接赋值,要制定其内部的变量
运行后输出user的值如下
jsp页面转发和重定向
Spring MVC默认是以转发的形式响应JSP
转发
@RequestMapping("/forward")
public String forward(){
return "forward:/index.jsp";
//return "index";效果一样
}
其页面地址并未发生改变
重定向
@RequestMapping("redirect")
public String redirect(){
return "redirect:/index.jsp";
}
访问后其会地址会改变
Spring MVC数据绑定
数据绑定:在后端的业务方法中直接获取客户端HTTP请求的参数,将请求参数映射到业务方法的形参中,Spring MVC中数据绑定工作是由HandlerAdapter来完成的
基础类型
@RequestMapping("baseType")
@ResponseBody
public String baseType(int id){
return id+"";
}
此处如果不加@ResponseBody注解,SpringMVC会按视图解析的方式,将业务方法的返回值传递给DispatcherServlet,再由DispatcherServlet调用viewResolver对返回值进行解析,映射到jsp文件返回给客户端
加注解,它就直接给页面返回响应值
包装类型
相较于基础类型,包装类型有更高的兼容性,如果客户端无传递值,相当于传递null,而基础类型很少有能接受null值的
但如果是包装类型
就没问题,正常传递如下
@RequestMapping("/packageType")
@ResponseBody
public String packageType(Integer id){
return id+"";
}
这个是在请求时传递参数,并且请求变量名必须一致
如果不一致,如果不一致需要添加映射
此处传递的变量名就是num
其还有一个参数是 是否必须传递值
默认就是true,如果想要传递参数有默认值,那就改成false并且添加默认值
如果传递多个值用数组接收
@RequestMapping("/array")
@ResponseBody
public String array(String[] name){
String str = Arrays.toString(name);
return str;
}
优化
可以看到这里每个函数都加了@ResponseBody注解
可以全部提取到类外部
@RestController
表示该控制器会直接将业务方法返回值响应给客户端,不进行视图解析
@Controller
表示该控制器业务方法返回值会交给视图解析器进行解析,如果只需要将数据响应给客户端,而不需要进行视图解析,则需要在对应的业务方法定义处添加@ResponseBody
也就是说
@RestController
@RequestMapping("/data")
public class DataBindHandler {
@RequestMapping("/baseType")
public String baseType(int id){
return id+"";
}
}
等于
@Controller
@RequestMapping("/data")
public class DataBindHandler {
@ResponseBody
@RequestMapping("/baseType")
public String baseType(int id){
return id+"";
}
}
List
Spring MVC不支持List类型的直接转换,需要自己封装
package com.makerjack.entity;
import lombok.Data;
import java.util.List;
@Data
public class UserList {
private List<User> users;
}
jsp
<%--
Created by IntelliJ IDEA.
User: EZIO
Date: 2021/1/30
Time: 17:42
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<form action="/data/list" method="post">
用户1编号:<input type="text" name="users[0].id"/>
用户1名称:<input type="text" name="users[0].name"/>
用户2编号:<input type="text" name="users[1].id"/>
用户2名称:<input type="text" name="users[1].name"/>
用户3编号:<input type="text" name="users[2].id"/>
用户3名称:<input type="text" name="users[2].name"/>
<input type="submit" value="提交">
</form>
</body>
</html>
业务方法
@RequestMapping("/list")
public String list(UserList userList){
StringBuffer str = new StringBuffer();
for(User user:userList.getUsers()){
str.append(user.toString());
}
return str.toString();
}
处理@ResponseBody中文乱码
如果从后台把数据返回给前端,内容包含中文,会出现乱码,此时就需要添加一个消息转化器的配置
<mvc:annotation-driven>
<!-- 消息转化器 -->
<mvc:message-converters register-defaults="true">
<bean class="org.springframework.http.converter.StringHttpMessageConverter">
<property name="supportedMediaTypes" value="text/html;charset=UTF-8"></property>
</bean>
</mvc:message-converters>
</mvc:annotation-driven>
Map
自定义封装类
package com.makerjack.entity;
import lombok.Data;
import java.util.Map;
@Data
public class UserMap {
private Map<String,User> users;
}
业务方法
@RequestMapping("/map")
public String map(UserMap userMap){
StringBuffer str = new StringBuffer();
for(String key:userMap.getUsers().keySet()){
User user = userMap.getUsers().get(key);
str.append(user);
}
return str.toString();
}
JSP
<%--
Created by IntelliJ IDEA.
User: EZIO
Date: 2021/1/30
Time: 18:48
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<form action="/data/map" method="post">
用户1编号:<input type="text" name="users['a'].id"/>
用户1名称:<input type="text" name="users['a'].name"/>
用户2编号:<input type="text" name="users['b'].id"/>
用户2名称:<input type="text" name="users['b'].name"/>
用户3编号:<input type="text" name="users['c'].id"/>
用户3名称:<input type="text" name="users['c'].name"/>
<input type="submit" value="提交">
</form>
</body>
</html>
JSON
客户端发送JSON格式的数据,直接通过Spring MVC绑定到业务方法的形参中
处理Spring MVC无法加载静态资源,在web.xml中添加配置即可
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.js</url-pattern>
</servlet-mapping>
添加完记得点击maven的刷新按钮
还是不行就rebuild
jsp
<%--
Created by IntelliJ IDEA.
User: EZIO
Date: 2021/1/30
Time: 19:33
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
<script type="text/javascript" src="js/jquery-3.3.1.min.js"></script>
<script type="text/javascript">
$(function () {
var user = {
"id":1,
"name":"张三"
};
$.ajax({
url:"/data/json",
data:JSON.stringify(user),
type:"POST",
contentType:"application/json;charset=UTF-8",
dataType:"JSON",
success:function(data){
alert(data.id+"-------"+data.name);
}
})
});
</script>
</head>
<body>
</body>
</html>
业务方法
@RequestMapping("/json")
public User json(@RequestBody User user){
System.out.println(user);
user.setId(147);
user.setName("赵六");
return user;
}
Spring MVC 中的Json和javaBean转换需要借助fastjson,pom.xml引入相关依赖
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.32</version>
</dependency>
同时Springmvc.xml中添加fastjson配置
<!-- 配置fastjson -->
<bean class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter"></bean>
Spring MVC模型数据解析
jsp四大作用域对应的内置对象:pageContext、request、session、application
模型数据的绑定是由ViewResolver来完成,实际开发中,我们需要先添加模型数据,再交给ViewResolver来绑定
SpringMVC提供了以下几种方式添加模型数据
Map
package com.makerjack.controller;
import com.makerjack.entity.User;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;
import java.util.Map;
@Controller
@RequestMapping("/view")
public class ViewController {
@RequestMapping("/map")
public String map(Map<String,User> map){
User user = new User();
user.setId(123);
user.setName("张三");
map.put("user",user);
return "view";
}
}
jsp
<%--
Created by IntelliJ IDEA.
User: EZIO
Date: 2021/1/31
Time: 11:06
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ page isELIgnored="false" %> <!-- 解析第12行文本 -->
<html>
<head>
<title>Title</title>
</head>
<body>
${requestScope.user}
</body>
</html>
Model
@RequestMapping("/model")
public String model(Model model){
User user = new User();
user.setId(123);
user.setName("张三");
model.addAttribute("user",user);
return "view";
}
ModelAndView
@RequestMapping("/modelAndView")
public ModelAndView modelAndView(){
User user = new User();
user.setId(123);
user.setName("张三");
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("user",user);
modelAndView.setViewName("view");
return modelAndView;
}
HttpServletRequest
@RequestMapping("/request")
public String request(HttpServletRequest request){
User user = new User();
user.setId(123);
user.setName("张三");
request.setAttribute("user",user);
return "view";
}
Spring MVC的文件上传和下载
通过io流+网络请求实现上传下载
单文件上传
底层是使用Apache fileupload组件完成上传,Spring MVC对这种方式进行了封装
pom.xml
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.5</version>
</dependency>
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.3.3</version>
</dependency>
jsp上传组件
input的type设置为file
form的method设置为post(get请求只能将文件名上传给服务器)
form的enctype设置为multipart-form-data(如果不设置只能将文件名给服务器)
<%--
Created by IntelliJ IDEA.
User: EZIO
Date: 2021/2/1
Time: 15:45
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ page isELIgnored="false" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<form action="/file/upload" method="post" enctype="multipart/form-data">
<input type="file" name="img"/>
<input type="submit" value="上传"/>
</form>
<img src="${path}">
</body>
</html>
Handler
@PostMapping("/upload")
public String upload(MultipartFile img, HttpServletRequest request){
if(img.getSize()>0){
//获取保存上传文件的file路径,此时path是待放置的文件夹路径
String path = request.getServletContext().getRealPath("file");
//获取上传的文件名
String name = img.getOriginalFilename();
File file = new File(path,name);
if(!file.exists()){
file.getParentFile().mkdir();
}
try {
img.transferTo(file);
//保存上传后的文件路径
request.setAttribute("path","/file/"+name);
} catch (IOException e) {
e.printStackTrace();
}
}
return "upload";
}
springmvc.xml
<!-- 配置上传组件 -->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"></bean>
想要上传后 前端出现预览图
如果直接给前端返回
前端会出现无法解析的现象
图片作为静态资源需要特殊处理,否则Servlet会当做逻辑请求处理
在web.xml中添加这个配置,(声明文件格式就写什么后缀)现在知道为什么有的网站上传文件制定文件类型了
多文件上传
客户端上传数组形式的文件,后端遍历数组,依次取出文件
我编译器其实并未通过,其无法解析forEach标签
jsp文件
<%--
Created by IntelliJ IDEA.
User: EZIO
Date: 2021/2/1
Time: 20:12
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<%@ page isELIgnored="false" %>
<%@ taglib prefix="c" uri="http://jakarta.apache.org/taglibs/standard/permittedTaglibs" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<form action="/file/uploads" method="post" enctype="multipart/form-data">
file1:<input type="file" name="imgs"/><br>
file2:<input type="file" name="imgs"/><br>
file3:<input type="file" name="imgs"/><br>
<input type="submit" value="上传">
</form>
<c:forEach items="${files}" var="file">
<img src="${file}" width="300px">
</c:forEach>
</body>
</html>
Handler
@PostMapping("/uploads")
public String uploads(MultipartFile[] imgs,HttpServletRequest request){
List<String> files = new ArrayList<>();
for (MultipartFile img:imgs){
//获取保存上传文件的file路径,此时path是待放置的文件夹路径
String path = request.getServletContext().getRealPath("file");
//获取上传的文件名
String name = img.getOriginalFilename();
File file = new File(path,name);
if(!file.exists()){
file.getParentFile().mkdir();
}
try {
img.transferTo(file);
//保存上传后的文件路径
files.add("/file/"+name);
} catch (IOException e) {
e.printStackTrace();
}
}
//给前端返回路径集合
request.setAttribute("files",files);
return "uploads";
}
pom.xml中引入Servlet相关的标签库
<dependency>
<groupId>jstl</groupId>
<artifactId>jstl</artifactId>
<version>1.2</version>
</dependency>
<dependency>
<groupId>taglibs</groupId>
<artifactId>standard</artifactId>
<version>1.1.2</version>
</dependency>
下载
jsp
<%--
Created by IntelliJ IDEA.
User: EZIO
Date: 2021/2/2
Time: 10:57
To change this template use File | Settings | File Templates.
--%>
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
</head>
<body>
<a href="/file/upload/1">1.jpg</a>
<a href="/file/upload/2">2.jpg</a>
<a href="/file/upload/3">3.jpg</a>
</body>
</html>
Handler
@GetMapping("/download/{name}")
public void download(@PathVariable("name") String name, HttpServletRequest request, HttpServletResponse response){
if(name != null){
String path = request.getServletContext().getRealPath("file");
File file = new File(path,name);
OutputStream outputStream = null;
if(file.exists()){
response.setContentType("application/forc-download");
response.setHeader("Content-Disposition","attachment;filename="+name);
try {
outputStream = response.getOutputStream();
outputStream.write(FileUtils.readFileToByteArray(file));
outputStream.flush();
} catch (IOException e) {
e.printStackTrace();
}finally {
if(outputStream != null){
try {
outputStream.close();
} catch (IOException e) {
e.printStackTrace();
}
}
}
}
}
}