1、springMVC简介
(1)什么是MVC?
Spring MVC是一个基于Java的实现了MVC设计模式的请求驱动类型的轻量级Web框架,通过把(M)Model,(V)View,(C)Controller分离,将web层进行职责解耦,把复杂的web应用分成逻辑清晰的几部分,简化开发,减少出错,方便组内开发人员之间的配合。
Model:模型层,工程中的JavaBean,作用是处理数据
JavaBean分为两类:
实体类Bean:专门存储业务数据,就是所谓的实体类;
业务处理Bean:用于处理业务逻辑和数据访问,指Service或Dao对象
View:视图层,指工程中的HTML或jsp界面,作用是与用户进行交互,展示数据。
Controller:控制层,指工程中的servlet,作用是接受请求和响应浏览器。
(2)MVC的工作流程
用户通过视图层发送请求到服务器,在服务器中请求被Controller接收,Controller调用相应的Model层处理请求,处理完毕后将结果返回到Controller,Controller再根据请求处理的结果找到相应的View视图,渲染数据后响应给浏览器。
(3)为什么使用springMVC
在SpringMVC 中,控制器Controller 负责处理由DispatcherServlet 分发的请求,它把用户请求的数据经过业务处理层处理之后封装成一个Model ,然后再把该Model 返回给对应的View 进行展示。在SpringMVC 中提供了一个非常简便的定义Controller 的方法,你无需继承特定的类或实现特定的接口,只需使用@Controller 标记一个类是Controller ,然后使用@RequestMapping 和@RequestParam 等一些注解用以定义URL 请求和Controller 方法之间的映射,这样的Controller 就能被外界访问到。此外Controller 不会直接依赖于HttpServletRequest 和HttpServletResponse 等HttpServlet 对象,它们可以通过Controller 的方法参数灵活的获取到。
2.使用springMVC
(1)创建maven-web项目,修改webapp目录下WEB-INF目录下的web.xml文件
web.xml文件内容如下
<?xml version="1.0" encoding="UTF-8"?>
<web-app xmlns="http://xmlns.jcp.org/xml/ns/javaee"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="http://xmlns.jcp.org/xml/ns/javaee http://xmlns.jcp.org/xml/ns/javaee/web-app_4_0.xsd"
version="4.0">
</web-app>
(2)引入springMVC的依赖
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.3.19</version>
</dependency>
(3)将DispatcherServlet注册到web.xml文件里
<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>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>DispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
(4)创建springmvc.xml文件
在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"
xsi:schemaLocation="http://www.springframework.org/schema/beans http://www.springframework.org/schema/beans/spring-beans.xsd http://www.springframework.org/schema/context https://www.springframework.org/schema/context/spring-context.xsd http://www.springframework.org/schema/mvc https://www.springframework.org/schema/mvc/spring-mvc.xsd">
<!--包扫描,controller的包里面的类要有@Controller注解才能被扫描到-->
<context:component-scan base-package="com.gjx.controller"/>
</beans>
(4)创建一个controller类
//标记该类为处理层类
@Controller
public class UserController {
//把请求路径映射到该方法上
@RequestMapping("hello")
public String hello(){
//请求转发到success.jsp界面
return "success.jsp";
}
}
(5)springMVC运行流程
1. 客户端发生请求http://localhost:8080/springMVC17/hello
2. 来到tomcat服务器。
3. springmvc的前端控制器DipatcherServlet接受所有的请求。
4. 查看你的请求地址和哪个@RequestMaping匹配。
5. 执行对应的方法。方法会返回一个字符串。springmvc把该字符串解析为要转发的网页。
6. 把该字符串经过视图解析器拼接。
7. 拿到拼接的地址,找到对应的网页。
8. 渲染该网页给客户
(6)如何在controller层接受参数
之前我们在servlet层接受参数都是使用的request.getParamer("参数名")的方式接参,接收的值是String类型,需要进行类型转换
1、接收少量参数
只需要给相应的请求方法添加参数,参数名字必须和前端页面的请求参数名称一致。
2、接收大量参数
比如表单的提交,我们可以封装实体类来接收这些参数
上面这个问题是由于日期的格式原因导致,我们至于要将接收请求参数时将日期格式化以下,并在spring MVC 的配置文件中开启特殊注解的驱动即可。
现在在controller层可以接收表单数据,但是会出现中文乱码的问题
我们需要在web.xml文件中注册编码过滤器,我们可以自己写一个编码过滤器,也可以使用springMVC框架自带的编码过滤器,这里使用的时spring MVC自带的编码过滤器
<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>
</filter>
<filter-mapping>
<filter-name>CharacterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
中文乱码的问题解决
(7)静态资源放行
我们页面中的静态资源比如css样式,js文件,图片,在执行时没有效果
我们可以在页面检查中发现图片资源并没有被放行
这样就需要我们在springMVC配置文件中将静态资源放行,加上
<mvn:default-servlet-handler/>
静态资源的问题成功解决。
3.数据回显
(1)将数据显示在界面上
1、使用request保存数据
2、使用springMVC中的model对象保存数据
model对象的级别和request相同
3、使用session保存数据
还可以使用model存储数据,在处理层类上将相应的key设置为session范围
@SessionAttributes({"user1"})
4.如何实现页面重定向
在controller层的方法中,返回值为String类型,返回一个界面使用的是请求转发的方式,如果想要使用重定向跳转至其他页面,在返回值中加上redirect:,/当springmvc看到你返回的字符串中含有redirect:时,将会认为你要进行重定向跳转。
return "redirect:success.jsp";
5.springMVC返回json数据
(1)什么时候需要返回json数据
异步请求,Ajax请求
(2)之前在servlet时返回json数据
借用fastjson,手动将Java对象转为json数据,并使用out.print(json)输出json数据。最后需要关闭out对象。
(3)springMVC如何返回json数据
1、springMVC框架中内置了一个jar包,Jackson的jar包
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.13.2.2</version>
</dependency>
2、在controller返回的数据类型变成javabean对象
在方法上加上@ResponseBody注解,将Java对象转为json数据
@RequestMapping("/allData")
@ResponseBody
public CommonResult allData(){
List<Stu> list = new ArrayList<Stu>();
list.add(new Stu(1,"高景霞","女",new Date()));
list.add(new Stu(2,"张嘉伟","男",new Date()));
list.add(new Stu(3,"何冰","女",new Date()));
list.add(new Stu(4,"梁荣兵","男",new Date()));
CommonResult commonResult = new CommonResult(200,"查询成功",list);
return commonResult;
}
上面的日期格式不是我们想要的格式,我们如何解决这个问题呢?
只需要在实体类的日期属性上添加一行注解@JsonFormat(pattern = "yyyy-MM-dd")就可以解决问题,这个注解是将日期格式的时间转为json格式的数据
6.springMVC的全局异常处理类
全局异常处理类的作用就是当controller层发生错误时,有全局异常处理类执行相对应的方法
@ControllerAdvice注解,标记该类为controller的异常处理类
@ExceptionHandler注解的value值为异常类型,当产生什么类型的异常会触发对应的方法
@ControllerAdvice
public class ExceptionHandle {
@ExceptionHandler(Exception.class)
public String error(){
return "error.jsp";
}
}
需要注意的是,全局异常处理类也要被springMVC的包扫描扫描到,
7.springMVC拦截器
我们之前用到过过滤器,两者之间有什么区别呢?
过滤器:过滤掉资源
拦截器:只会拦截controller层的资源路径
(1)创建拦截器
public class LoginInterceptor implements HandlerInterceptor {
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
response.setContentType("application/json;charset=utf-8");
HttpSession session = request.getSession();
Object user = session.getAttribute("user");
if (user!=null){
return true;
}
PrintWriter writer = response.getWriter();
CommonResult commonResult = new CommonResult(501,"请先登录",null);
ObjectMapper objectMapper = new ObjectMapper();
String s = objectMapper.writeValueAsString(commonResult);
writer.println(s);
writer.flush();
writer.close();
return false;
}
}
我们创建的拦截器类需要实现HandlerInterceptor接口,并且重写preHandle方法。上面是使用拦截器判断用户是否登录。
我们如果要使用我们定义的拦截器,需要在springmvc.xml文件中注册该拦截器
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<mvc:exclude-mapping path="/login"/>
<mvc:exclude-mapping path="/js/**"/>
<mvc:exclude-mapping path="/css/**"/>
<mvc:exclude-mapping path="/images/**"/>
<bean class="com.gjx.interceptor.LoginInterceptor"/>
</mvc:interceptor>
</mvc:interceptors>
/**代表拦截n层路径,/*代表拦截一层路径,
mvc:mapping表示拦截的路径,mvc:exclude-mapping表示不经过拦截的路径
bean表示自定义的拦截器类所在的路径。
8.文件上传
(1)上传到本地服务器
第一步,导入文件上传的依赖
<dependency> <groupId>commons-fileupload</groupId> <artifactId>commons-fileupload</artifactId> <version>1.4</version> </dependency>
第二步,创建一个页面,这里需要注意的是提交方式必须为post提交,表单类型enctype需要设置为multipart/form-data的格式,这里的input标签的name属性不可省略,需要和controller层接收的参数名相同。
<body>
<!-- method:文件上传使用的提交方式必须为post提交
enctype:默认application/x-www-form-urlencoded 表示提交表单数据
multipart/form-data:可以包含文件数据
input:类型为文件类型-->
<form action="upload01" method="post" enctype="multipart/form-data">
<input type="file" name="file"/><br>
<input type="submit" value="提交"/>
</form>
</body>
第三步,在springMVC的配置文件中配置文件上传解析器,bean的id必须为multipartResolver,property的属性maxUploadSize的value值的单位为Byte
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"> <property name="maxUploadSize" value="10485760"/> </bean>
第四步,创建实现文件上传接口的方法,@RequestMapping表示请求的接口,@ResponseBody表示将Java对象转为json数据。
@Controller
public class UploadController {
@RequestMapping("/upload01")
@ResponseBody
public Map upload01(MultipartFile file, HttpServletRequest request){
Map map = new HashMap();
try {
//得到本地服务目录的地址
String path = request.getSession().getServletContext().getRealPath("upload");
File file1 = new File(path);
//判断该目录是否存在,不存在就创建该目录
if (!file1.exists()){
file1.mkdirs();
}
//将file保存到本地服务器的某个文件夹下,使用UUID.randomUUID().toString()方法随机 生成一个字符串,之后拼接上file的名字,这样不会因文件名相同而覆盖
String fileName = UUID.randomUUID().toString().replace("-","")+file.getOriginalFilename();
File target = new File(path + "/" + fileName);
//将file复制到目标文件
file.transferTo(target);
map.put("code",200);
map.put("msg","上传成功");
//这里的文件地址必须为服务器中文件所在地址,而不是本地文件地址
map.put("data","http://localhost:8080/springMVC14/upload/"+fileName);
System.out.println(map);
return map;
} catch (Exception e) {
e.printStackTrace();
}
map.put("code",500);
map.put("msg","上传失败");
map.put("data",null);
System.out.println(map);
return map;
}
}
(2)使用elementUI+vue+axios完成文件上传
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>upload02</title>
<link type="text/css" rel="stylesheet" href="css/index.css"/>
<script type="text/javascript" src="js/vue.js"></script>
<script type="text/javascript" src="js/index.js"></script>
<script type="text/javascript" src="js/axios.min.js"></script>
<script type="text/javascript" src="js/qs.min.js"></script>
<script type="text/javascript" src="js/jquery-3.5.1.min.js"></script>
<style>
.avatar-uploader .el-upload {
border: 1px dashed #d9d9d9;
border-radius: 6px;
cursor: pointer;
position: relative;
overflow: hidden;
}
.avatar-uploader .el-upload:hover {
border-color: #409EFF;
}
.avatar-uploader-icon {
font-size: 28px;
color: #8c939d;
width: 178px;
height: 178px;
line-height: 178px;
text-align: center;
}
.avatar {
width: 178px;
height: 178px;
display: block;
}
</style>
</head>
<body>
<div id="app">
<!--action 为文件上传的访问路径
on-success 为文件上传成功触发的函数
img 标签为数据回显-->
<el-upload
class="avatar-uploader"
action="upload02"
:show-file-list="false"
:on-success="handleAvatarSuccess"
:before-upload="beforeAvatarUpload">
<img v-if="imageUrl" :src="imageUrl" class="avatar">
<i v-else class="el-icon-plus avatar-uploader-icon"></i>
</el-upload>
</div>
<script>
var app = new Vue({
el: "#app",
data:{
imageUrl:"",
},
methods:{
handleAvatarSuccess(res) {
console.log(res);
this.imageUrl = res.data;
},
beforeAvatarUpload(file) {
const isJPG = file.type === 'image/jpeg';
const isLt2M = file.size / 1024 / 1024 < 10;
if (!isJPG) {
this.$message.error('上传头像图片只能是 JPG 格式!');
}
if (!isLt2M) {
this.$message.error('上传头像图片大小不能超过 10MB!');
}
return isJPG && isLt2M;
}
}
})
</script>
</body>
</html>
后台的接口实现和上面的第四步一样
9.上传到阿里云的服务器oss
上传到本地服务器的缺点:如果搭建集群,会导致文件无法共享,而且服务器重启之后数据会丢失。所以我们将文件专门放在一个文件服务器上,这些tomcat服务器都操作同一个文件服务器。
第一步,申请阿里云的oss服务,进入阿里云官网
找到对象存储oss,开通oss服务
创建Bucket
创建之后我们就可以上传我们的文件了
第二步,申请阿里云密钥,没有密钥我们不能使用idea 上传文件
第三步,上传文件到oss
(1)前端
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>upload01</title>
<link type="text/css" rel="stylesheet" href="css/index.css"/>
<script src="js/vue.js"></script>
<script src="js/index.js"></script>
<script src="js/jquery-3.5.1.min.js"></script>
<script src="js/qs.min.js"></script>
<script src="js/axios.min.js"></script>
<style>
.avatar-uploader .el-upload {
border: 1px dashed #d9d9d9;
border-radius: 6px;
cursor: pointer;
position: relative;
overflow: hidden;
}
.avatar-uploader .el-upload:hover {
border-color: #409EFF;
}
.avatar-uploader-icon {
font-size: 28px;
color: #8c939d;
width: 178px;
height: 178px;
line-height: 178px;
text-align: center;
}
.avatar {
width: 178px;
height: 178px;
display: block;
}
</style>
</head>
<body>
<div id="app">
<el-upload
class="avatar-uploader"
action="upload01"
:show-file-list="false"
:on-success="handleAvatarSuccess"
:before-upload="beforeAvatarUpload">
<img v-if="imageUrl" :src="imageUrl" class="avatar">
<i v-else class="el-icon-plus avatar-uploader-icon"></i>
</el-upload>
</div>
<script>
var app = new Vue({
el: "#app",
data:{
imageUrl:"",
},
methods:{
handleAvatarSuccess(res) {
console.log(res);
this.imageUrl = res.data;
},
beforeAvatarUpload(file) {
const isJPG = file.type === 'image/jpeg';
const isLt2M = file.size / 1024 / 1024 < 10;
if (!isJPG) {
this.$message.error('上传头像图片只能是 JPG 格式!');
}
if (!isLt2M) {
this.$message.error('上传头像图片大小不能超过 10MB!');
}
return isJPG && isLt2M;
}
}
})
</script>
</body>
</html>
(2)接口实现
@RequestMapping("/upload01")
@ResponseBody
public CommonResult upload01(MultipartFile file){
String endpoint = "oss-cn-hangzhou.aliyuncs.com";
String accessKeyId = "自己的密钥id";
String accessKeySecret = "自己的密钥密码";
String bucketName = "springmvc-project";
String nowTime = new SimpleDateFormat("yyyy/MM/dd").format(new Date());
String objectName = "springmvc-images/"+nowTime+"/"+UUID.randomUUID().toString().replace("-","")+file.getOriginalFilename();
OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
try {
InputStream inputStream = file.getInputStream();
// 创建PutObject请求。
ossClient.putObject(bucketName, objectName, inputStream);
//https://springmvc-project.oss-cn-hangzhou.aliyuncs.com/springmvc-images/5.jpg
String data = "https://"+bucketName+"."+endpoint+"/"+objectName;
return new CommonResult(200,"上传成功",data);
} catch (Exception e) {
System.out.println("Error Message:" + e.getMessage());
} finally {
if (ossClient != null) {
ossClient.shutdown();
}
}
return new CommonResult(500,"上传失败",null);
}
我们每次每次上传文件都需要写一系列的参数,这样非常不方便,我们可以封装一个工具类
public class UploadOOS {
public static String upload(MultipartFile file) throws IOException {
String endpoint = "oss-cn-hangzhou.aliyuncs.com";
String accessKeyId = "自己的密钥id";
String accessKeySecret = "自己的密钥密码";
String bucketName = "springmvc-project";
String nowTime = new SimpleDateFormat("yyyy/MM/dd").format(new Date());
String objectName = "springmvc-images/"+nowTime+"/"+UUID.randomUUID().toString().replace("-","")+file.getOriginalFilename();
OSS ossClient = new OSSClientBuilder().build(endpoint, accessKeyId, accessKeySecret);
InputStream inputStream = file.getInputStream();
// 创建PutObject请求。
ossClient.putObject(bucketName, objectName, inputStream);
String url = "https://"+bucketName+"."+endpoint+"/"+objectName;
return url;
}
}
这样我们每次上传文件的时候只需要调用工具类中的方法即可,需要更改的参数也就是自己的密钥id和密码,如果其他的参数信息也有变化也需修改,加入工具类之后的实现接口的方法如下:
@RequestMapping("/upload02")
@ResponseBody
public CommonResult upload02(MultipartFile file){
try {
String url = UploadOOS.upload(file);
return new CommonResult(200,"上传成功",url);
} catch (IOException e) {
e.printStackTrace();
}
return new CommonResult(500,"上传失败",null);
}
这样极大的简便了我们的接口实现方法。
10.提交带头像的表单数据
第一步,前端页面
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>upload</title>
<link type="text/css" rel="stylesheet" href="css/index.css"/>
<script src="js/vue.js"></script>
<script src="js/index.js"></script>
<script src="js/jquery-3.5.1.min.js"></script>
<script src="js/qs.min.js"></script>
<script src="js/axios.min.js"></script>
<style>
.avatar-uploader .el-upload {
border: 1px dashed #d9d9d9;
border-radius: 6px;
cursor: pointer;
position: relative;
overflow: hidden;
}
.avatar-uploader .el-upload:hover {
border-color: #409EFF;
}
.avatar-uploader-icon {
font-size: 28px;
color: #8c939d;
width: 178px;
height: 178px;
line-height: 178px;
text-align: center;
}
.avatar {
width: 178px;
height: 178px;
display: block;
}
</style>
</head>
<body>
<div id="app" width="600px">
<el-form ref="form" :model="UserForm" label-width="80px">
<el-form-item label="头像">
<el-upload
class="avatar-uploader"
action="uploadAvatar"
:show-file-list="false"
:on-success="handleAvatarSuccess"
:before-upload="beforeAvatarUpload">
<img v-if="imageUrl" :src="imageUrl" class="avatar">
<i v-else class="el-icon-plus avatar-uploader-icon"></i>
</el-upload>
</el-form-item>
<el-form-item label="姓名">
<el-input v-model="UserForm.name"></el-input>
</el-form-item>
<el-form-item label="年龄">
<el-input v-model="UserForm.age"></el-input>
</el-form-item>
<el-form-item>
<el-button type="primary" @click="onSubmit">提交</el-button>
</el-form-item>
</el-form>
</div>
<script>
var app = new Vue({
el:"#app",
data:{
UserForm:{},
imageUrl:"",
},
methods:{
onSubmit(){
axios.post("addUser",this.UserForm).then(function (result) {
console.log(result);
})
},
handleAvatarSuccess(res, file) {
this.imageUrl = res.data;
this.UserForm.imageUrl = res.data;
},
beforeAvatarUpload(file) {
const isJPG = file.type === 'image/jpeg';
const isLt2M = file.size / 1024 / 1024 < 2;
if (!isJPG) {
this.$message.error('上传头像图片只能是 JPG 格式!');
}
if (!isLt2M) {
this.$message.error('上传头像图片大小不能超过 2MB!');
}
return isJPG && isLt2M;
}
},
})
</script>
</body>
</html>
第二步,后端接口的实现
@RestController
public class AddUserController {
@RequestMapping("uploadAvatar")
public CommonResult uploadAvatar(MultipartFile file){
try {
String url = UploadOOS.upload(file);
return new CommonResult(200,"上传成功",url);
} catch (IOException e) {
e.printStackTrace();
}
return new CommonResult(500,"上传失败",null);
}
@RequestMapping("addUser")
public CommonResult addUser(@RequestBody User user){
System.out.println(user);
return new CommonResult(200,"成功",user);
}
}
11.内容补充
@RestController 等价于 @Controller+@ResponseBody
该注解下所有的方法都是返回json数据
@RequestMapping: 作用: 把请求路径映射到响应的方法上。@RequestParam(value = "u"):设置你接受的请求参数名。查询参数
@Param(value="name"):设置的时mybatis中mapper映射文件中的参数
@RequestMapping(value = "/addUser",method = RequestMethod.POST)
method:表示该接口接受的请求方式.不设置可以接受任意请求方式。
@GetMapping("addUser"):表示只接受get提交方式的请求@RequestBody:把请求的json数据转换为java对象。从前端到后端
@ResponseBody:把java转换为json数据 从后端转前端