0、SpringMVC简介
1、什么是MVC
MVC是一种软件架构思想,将软件按照模型、视图、控制器来划分。
M:Model,模型层,指工程中的JavaBean,作用是处理数据。
JavaBean分为两类:
-
一类称为实体类Bean:专门存储业务数据的,如Student、User等;
-
一类称为业务处理Bean:指Service或Dao对象,专门用于处理业务逻辑和数据访问。
-
也就是说M指的是service和db和entity包的合称
V:View,视图层,指工程中的HTML或JSP等页面,作用是与用户进行交互,展示数据。
C:Controller,控制层,指工程中的Servlet,作用是接收请求和响应浏览器。
MVC的工作流程:
用户通过视图层发送请求到服务器,在服务器中请求被Controller接收,Controller调用相应的Model层处理请求,处理完毕将结果返回到Controller,Controller再根据请求处理的结果找到相应的View视图,渲染数据后最终响应给浏览器。
2、什么是SpringMVC
SpringMVC是Spring的一个后续产品,是Spring的一个子项目。
SpringMVC是Spring为表述层开发提供的一整套完备的解决方案。在表述层框架历经Strust、WebWork、Strust2等诸多产品的历代更迭之后,目前业界普遍选择了SpringMVC作为Java EE项目表述层开发的首选方案。
3、SpringMVC的特点
-
是 Spring 家族原生产品,能够与 IOC 容器等基础设施无缝对接
-
基于原生的 Servlet,通过强大的前端控制器 DispatcherServlet 统一处理请求和响应
-
能够全方位覆盖表述层各细分领域需要解决的问题,并提供全面的解决方案
-
代码清新简洁,大幅提升开发效率
-
内部组件化程度高,可插拔式组件即插即用,只需要配置相应的组件即可获得需要的功能
-
性能卓越,尤其适合现代大型、超大型互联网项目的要求。
4. 如何学好Spring MVC:
-
先了解MVC的概念和基本原理,掌握模型、视图、控制器的作用和关系;
-
深入学习SpringMVC的特点和使用方法,包括如何配置DispatcherServlet、控制器、视图解析器等;
-
熟悉@RequestMapping注解的使用,理解value属性和method属性的含义;
-
掌握SpringMVC的数据绑定、数据校验、异常处理等高级特性;
-
学习SpringMVC与其他技术的整合,如Spring和数据库层的整合;
-
不断实践和总结,深入理解SpringMVC的原理和应用场景,并掌握在实际项目中的应用方法。
了解: 为什么要有mvc
MVC的诞生原因
为了将Tomcat容器和Spring容器统一,MVC将二者整合成一个容器。这意味着要么新建一个容器,要么使用Tomcat的容器或Spring自身的容器。如果要使用Spring注解,就不需要Tomcat容器,而是将所有的请求转到Spring自己的代码中。
例如:访问Tomcat需要通过Servlet,但现在这个Servlet需要转到Spring中。Spring根据请求进行映射,所以需要将Servlet的所有请求转到Spring中处理。
如何将servlet请求转到Spring?
我们需要将所有的servlet请求转到Spring中。
Spring官方提供了一个servlet,用于接收所有的前端请求。Spring会检测并接收这些请求,然后对请求进行路径解析,并将其解析到相应的自定义方法中。
接下来,我们需要统一Tomcat和Spring容器,将所有的servlet请求转到Spring中。
有一次,一个程序员在写Spring的代码时,突然电脑蓝屏了。他重启了电脑,重新打开了IDE,看到他刚刚写的代码全部消失了。他感叹道:“Spring来了,代码没了!”
其他程序员听到这个笑话后,也纷纷调侃起来:“Spring来了,代码全没了!”、“Spring来了,拍拍脑门,重写代码!”等等。
但是,这个程序员并没有气馁,他重新开始写代码,经过不断调试和优化,最终成功实现了他想要的功能。他感叹道:“Spring来了,代码又回来了!”
这个笑话虽然简单,但是却体现了编程中的一个真理:遇到问题不要气馁,要勇敢面对,不断尝试和优化,最终一定能够实现自己想要的功能。
一. 引入SpringMVC
1. 引入依赖
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.3.25</version>
</dependency>
2. 配置包扫描
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
xsi:schemaLocation="
http://www.springframework.org/schema/context
https://www.springframework.org/schema/context/spring-context.xsd
http://www.springframework.org/schema/beans
https://www.springframework.org/schema/beans/spring-beans.xsd">
<!-- 这个是spring ioc和mvc都会使用这个包扫描配置-->
<context:component-scan base-package="com.itszt22"/>
</beans>
3. 引入配置(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.xml配置彻底完成 springioc和servlet的合体-->
<!-- 1. ioc的配置-->
<context-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springioc.xml</param-value>
</context-param>
<!-- 启动ioc 这个将来会自动读取 1.ioc中的配置-->
<listener>
<listener-class>org.springframework.web.context.ContextLoaderListener</listener-class>
</listener>
<!-- 2. mvc的配置 ioc+servlet-->
<!-- 这个DispathServlet就是我们的mvc本体-->
<servlet>
<servlet-name>myDispatchServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
<!-- 加载mvc配置文件-->
<init-param>
<param-name>contextConfigLocation</param-name>
<param-value>classpath:springmvc.xml</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>myDispatchServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
</web-app>
**原理:**dispatchServlet是一个中转站,当我们访问tomcat时,任何请求都会被它接收。接收到请求后,dispatchServlet会分析请求的路径,调用相应的方法,并将请求转发到Spring内部。这样,就完成了一个统一的过程。
Servlet:是spring-mvc的子容器。
DispatcherServlet的上下文在初始化时会建立自己的IOC上下文,用于持有Spring mvc相关的bean。
DispatcherServlet是前端控制器,专门用于监听前端的请求(负责协调和组织不同组件完成请求处理并返回响应工作)。
context-param:是spring的容器,spring-mvc可以理解为该容器的子容器。spring容器是最顶层的父容器,类似于java的继承原理。
SpringMVC的IOC容器中的bean可以引用Spring IOC容器中的bean,反之则不行。原因是:
-
Spring MVC是Spring的子类,子类可以引用父类,父类不能引用子类。
-
从软件层面来说,Spring MVC是控制层,可以调用数据层,但数据层不能调用控制层。
二、HelloWorld
1、静态资源访问配置
当有静态资源需要加载时,比如jquery文件,通过谷歌开发者工具抓包发现,没有加载到jquery文件,原因是SpringMVC的前端控制器DispatcherServlet的url-pattern配置的是/,代表对所有的资源都进行过滤操作,我们可以通过以下两种方式指定放行静态资源:
任何在spring-mvc配置文件中写明的静态资源配置 会导致spirng不再扫描controller中的requestmapping相关的注解 从而导致controller类失效
加上一个注解 指明让spring扫描mvc相关的注解
-
使用
标签
-
通过web.xml文件暴露静态资源文件;
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.js</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.jpg</url-pattern>
</servlet-mapping>
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.html</url-pattern>
</servlet-mapping>
2.在spring-mvc.xml配置文件中指定放行的资源(了解)
xmlns:mvc="http://www.springframework.org/schema/mvc"
http://www.springframework.org/schema/mvc
https://www.springframework.org/schema/mvc/spring-mvc.xsd
<!-- 配置静态资源访问-->
<mvc:resources mapping="/image/**" location="/image/"></mvc:resources>
<!-- mapping: 映射地址-->
<!-- location: 资源路径的位置-->
3.配置default-handler, 所有请求仍然交给springmvc处理, 只不过, springmvc找不到的时候,会提交给tomcat处理
<mvc:annotation-driven/>
<mvc:default-servlet-handler/>
三、@RequestMapping注解
1、@RequestMapping注解的功能
从注解名称上我们可以看到,@RequestMapping注解的作用就是将请求和处理请求的控制器方法关联起来,建立映射关系。
SpringMVC 接收到指定的请求,就会来找到在映射关系中对应的控制器方法来处理这个请求。
2、@RequestMapping注解的位置
@RequestMapping标识一个类:设置映射请求的请求路径的初始信息
@RequestMapping标识一个方法:设置映射请求请求路径的具体信息
@Controller
@RequestMapping("/test")
public class RequestMappingController {
//此时请求映射所映射的请求的请求路径为:/test/testRequestMapping
@RequestMapping("/testRequestMapping")
public String testRequestMapping(){
return "success";
}
}
3、@RequestMapping注解的value属性(了解)
@RequestMapping注解的value属性通过请求的请求地址匹配请求映射
@RequestMapping注解的value属性是一个字符串类型的数组,表示该请求映射能够匹配多个请求地址所对应的请求
@RequestMapping注解的value属性必须设置,至少通过请求地址匹配请求映射
测试@RequestMapping的value属性-->/testRequestMapping 测试@RequestMapping的value属性-->/test
@RequestMapping(value = {"/testRequestMapping", "/test"})
public String testRequestMapping(){
return "success";
}
4、@RequestMapping注解的method属性
@RequestMapping注解的method属性通过请求的请求方式(get或post)匹配请求映射
@RequestMapping注解的method属性是一个RequestMethod类型的数组,表示该请求映射能够匹配多种请求方式的请求
若当前请求的请求地址满足请求映射的value属性,但是请求方式不满足method属性,则浏览器报错405:Request method ‘POST’ not supported
<a href="/testRequestMapping">测试@RequestMapping的value属性-->/test</a><br>
<form action="/test" method="post">
<input type="submit">
</form>
@RequestMapping(
value = {"/testRequestMapping", "/test"},
method = {RequestMethod.GET, RequestMethod.POST}
)
public String testRequestMapping(){
return "success.html";
}
注:
1、对于处理指定请求方式的控制器方法,SpringMVC中提供了@RequestMapping的派生注解
Spring MVC4.X 新特性
处理get请求的映射–>@GetMapping
处理post请求的映射–>@PostMapping
处理put请求的映射–>@PutMapping
处理delete请求的映射–>@DeleteMapping
2、常用的请求方式有get,post,put,delete
但是目前浏览器只支持get和post,若在form表单提交时,为method设置了其他请求方式的字符串(put或delete),则按照默认的请求方式get处理
5、@RequestMapping注解的params属性(纯了解)
@RequestMapping注解的params属性通过请求的请求参数匹配请求映射
@RequestMapping注解的params属性是一个字符串类型的数组,可以通过四种表达式设置请求参数和请求映射的匹配关系
“param”:要求请求映射所匹配的请求必须携带param请求参数
“!param”:要求请求映射所匹配的请求必须不能携带param请求参数
“param=value”:要求请求映射所匹配的请求必须携带param请求参数且param=value
“param!=value”:要求请求映射所匹配的请求必须携带param请求参数但是param!=value
<a href="/test">测试@RequestMapping的params属性-->/test</a><br>
@RequestMapping(
value = {"/testRequestMapping", "/test"}
,method = {RequestMethod.GET, RequestMethod.POST}
,params = {"username","password!=123456"}
)
public String testRequestMapping(){
return "success";
}
注:
若当前请求满足@RequestMapping注解的value和method属性,但是不满足params属性,此时页面回报错400:Parameter conditions “username, password!=123456” not met for actual request parameters: username={admin}, password={123456}
6、@RequestMapping注解的headers属性(了解)
@RequestMapping注解的headers属性通过请求的请求头信息匹配请求映射
@RequestMapping注解的headers属性是一个字符串类型的数组,可以通过四种表达式设置请求头信息和请求映射的匹配关系
“header”:要求请求映射所匹配的请求必须携带header请求头信息
“!header”:要求请求映射所匹配的请求必须不能携带header请求头信息
“header=value”:要求请求映射所匹配的请求必须携带header请求头信息且header=value
“header!=value”:要求请求映射所匹配的请求必须携带header请求头信息且header!=value
若当前请求满足@RequestMapping注解的value和method属性,但是不满足headers属性,此时页面显示404错误,即资源未找到
7、SpringMVC支持ant风格的路径 (了解)
?:表示任意的单个字符
-
:表示任意的0个或多个字符
/**/xxx:表示任意的一层或多层目录
注意:在使用时,只能使用//xxx的方式
8、SpringMVC支持路径中的占位符(重点)
原始方式:/deleteUser?id=1
前端请求 http://localhost:8080/user/124141414,ssdadgsag,adhadha,addgag,adgsdd
后台通过路径占位符接收
@Pathvariable String strs
这样就可以接收多个参数, 通常会在前端需要复选多个选项, 做删除或者查询等处理的时候出现
rest方式:/deleteUser/1
SpringMVC路径中的占位符常用于RESTful风格中,当请求路径中将某些数据通过路径的方式传输到服务器中,就可以在相应的@RequestMapping注解的value属性中通过占位符{xxx}表示传输的数据,在通过@PathVariable注解,将占位符所表示的数据赋值给控制器方法的形参
PathVariable
@RequestMapping("/testRest/{id}/{username}")
public String testRest(@PathVariable("id") String id, @PathVariable("username") String username){
System.out.println("id:"+id+",username:"+username);
return "success";
} //最终输出的内容为-->id:1,username:admin
有一位Java程序员去面试,面试官问他:“你知道Spring框架吗?” Java程序员回答:“当然知道,春天嘛,四季之一。” 面试官无语。
面试官看了看简历,又问道:“那你知道Spring框架有什么用吗?” Java程序员回答:“嗯,当然知道,Spring可以帮助我们管理Bean,实现IOC和AOP。” 面试官稍稍有些满意,继续问道:“那你知道Spring的优点是什么吗?” Java程序员深吸一口气,回答:“Spring是无侵入式的,可以与其他框架良好地兼容;Spring提供了丰富的模块化功能,可以灵活地选择使用;Spring可以帮助我们提高开发效率,降低开发难度;Spring可以帮助我们实现代码重用,提高代码的可维护性和可扩展性。” 面试官顿时惊呆了,心想:“这个Java程序员还真是厉害啊!”
接着,面试官又问道:“那你知道Spring的缺点是什么吗?” Java程序员一脸茫然,想了想,回答:“缺点?Spring还有缺点吗?”
面试官笑了笑,说道:“每个技术都有它的优点和缺点,Spring也不例外。比如,Spring的配置文件可能会比较复杂,而且在某些场景下,Spring的性能可能不如其他框架。但是,这些缺点并不影响Spring在Java开发领域的地位和影响力。”
Java程序员恍然大悟,感谢面试官的指导。最终,他也成功地加入了这家公司,成为了一名优秀的Java开发工程师。
这个笑话虽然有些夸张,但是也反映了一个事实:Spring框架在Java开发领域的影响力非常大,它不仅提供了丰富的功能和模块,还帮助开发者提高了开发效率和代码质量。当然,每个技术都有它的优缺点,我们需要在实际项目中根据具体情况进行选择和应用。
四、SpringMVC获取请求参数(重点)
1、@RequestParam (重要)
@RequestParam是将请求参数和控制器方法的形参创建映射关系
@RequestParam注解一共有三个属性:
value:指定为形参赋值的请求参数的参数名
required:设置是否必须传输此请求参数,默认值为true
若设置为true时,则当前请求必须传输value所指定的请求参数,若没有传输该请求参数,且没有设置defaultValue属性,则页面报错400:Required String parameter ‘xxx’ is not present;若设置为false,则当前请求不是必须传输value所指定的请求参数,若没有传输,则注解所标识的形参的值为null
defaultValue:不管required属性值为true或false,当value所指定的请求参数没有传输或传输的值为""时,则使用默认值为形参赋值
post请求存在中文乱码问题, 后面会解决, 或者用之前学习的过滤器也可以解决
2、通过实体类获取请求参数(重要)
可以在控制器方法的形参位置设置一个实体类类型的形参,此时若浏览器传输的请求参数的参数名和实体类中的属性名一致,那么请求参数就会为此属性赋值
<form action="/testpojo" method="post">
用户名:<input type="text" name="username"><br>
密码:<input type="password" name="password"><br>
性别:<input type="radio" name="sex" value="男">男<input type="radio" name="sex" value="女">女<br>
年龄:<input type="text" name="age"><br>
邮箱:<input type="text" name="email"><br>
<input type="submit">
</form>
@RequestMapping("/testpojo")
public String testPOJO(User user){
System.out.println(user);
return "success";
}
//最终结果–>User{id=null, username=‘张三’, password=‘123’, age=23, sex=‘男’, email=‘[email protected]’}
3. 使用@Requestbody获取json格式的数据
需要加入能够将json字符串转成java对象的工具类的依赖
0.添加依赖
<!-- jackson 这个工具专门用于 json字符串和java对象之间的相互转化-->
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.14.2</version>
</dependency>
1.实体类和代码
User.java Dog.java
import lombok.Data;
@Data
public class User {
private String username;
private String password;
private String sex;
private String age;
private String email;
private Dog dog;
}
@Data
class Dog {
private String name;
private Integer age;
}
2.请求模拟
3.接收代码
@PostMapping("/testpojo")
//spring会自动把请求体中的json格式字符串转化成java对象 这个转化过程需要额外添加一个maven依赖
public String addUser(@RequestBody User user){
System.out.println("user = " + user);
return "";
}
扩展:
使用jackson工具进行json字符串和java对象之间的互相转化
4、解决获取请求参数的乱码问题
解决获取请求参数的乱码问题,可以使用SpringMVC提供的编码过滤器CharacterEncodingFilter,但是必须在web.xml中进行注册
响应没有配置一定会乱码
<!--配置springMVC的编码过滤器-->
<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>
注:
SpringMVC中处理编码的过滤器一定要配置到其他过滤器之前,否则无效
5、通过ServletAPI获取
将HttpServletRequest作为控制器方法的形参,此时HttpServletRequest类型的参数表示封装了当前请求的请求报文的对象
@RequestMapping("/testParam")
public String testParam(HttpServletRequest request){
String username = request.getParameter("username");
String password = request.getParameter("password");
System.out.println("username:"+username+",password:"+password);
return "success";
}
6、通过控制器方法的形参获取请求参数
在控制器方法的形参位置,设置和请求参数同名的形参,当浏览器发送请求,匹配到请求映射时,在DispatcherServlet中就会将请求参数赋值给相应的形参2
@RequestMapping("/testParam2")
public String testParam(String username, String password){
System.out.println("username:"+username+",password:"+password);
return "success";
}
注:
若请求所传输的请求参数中有多个同名的请求参数,此时可以在控制器方法的形参中设置字符串数组或者字符串类型的形参接收此请求参数
若使用字符串数组类型的形参,此参数的数组中包含了每一个数据
若使用字符串类型的形参,此参数的值为每个数据中间使用逗号拼接的结果
7、@RequestHeader (了解)
@RequestHeader是将请求头信息和控制器方法的形参创建映射关系
@RequestHeader注解一共有三个属性:value、required、defaultValue,用法同@RequestParam
8、@CookieValue (了解)
@CookieValue是将cookie数据和控制器方法的形参创建映射关系
@CookieValue注解一共有三个属性:value、required、defaultValue,用法同@RequestParam
五、域对象共享数据
1、使用ServletAPI向request域对象共享数据(了解)
@RequestMapping("/testServletAPI")
public String testServletAPI(HttpServletRequest request){
request.setAttribute("testScope", "hello,servletAPI");
return "/success";
}
注意: 返还的页面字符串必须以/开头 否则, 会被视为相对路径, 相对于当前controller上面标注的@RequestMapping写的内容
2、使用ModelAndView向request域对象共享数据(了解)
@GetMapping(value = "/testmodelView")
public ModelAndView helloForModelView() {
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("data", "modelview data");
modelAndView.setViewName("test.jsp");
return modelAndView;
}
3、使用Model向request域对象共享数据
@GetMapping(value = "/testmodelView")
public String helloForModelView(Model model) {
model.addAttribute("data", "model data");
return "/test.jsp";
}
4、使用map向request域对象共享数据
@RequestMapping("/testMap")
public String testMap(Map map) {
map.put("testScope", "hello, Map");
return "/success";
}
5、使用ModelMap向request域对象共享数据((了解))
@RequestMapping("/testModelMap")
public String testModelMap(ModelMap modelMap) {
modelMap.addAttribute("testScope", "Hello, ModelMap");
return "success";
}
6、向session域共享数据
@RequestMapping("/testSession")
public String testSession(HttpSession session) {
session.setAttribute("testSessionScope", "hello, session");
return "success";
}
7、向application域共享数据
@RequestMapping("/testApplication")
public String testApplication(HttpSession session) {
ServletContext application = session.getServletContext();
application.setAttribute("testApplicationScope", "hello, application");
return "success";
}
如果同时将username的值设置到 request session servletcontext中
jsp会先按照这个顺序去找值显示,找到了就停止继续向下查找
request -> session -> servletcontext
reqeust中存放的数据只能被转发的servlet接收处理
session只能被同一个sessionid的请求接收处理
servletcontext能被同一个tomcat中的请求处理
六、SpringMVC的视图
SpringMVC中的视图是View接口,视图的作用渲染数据,将模型Model中的数据展示给用户
SpringMVC视图的种类很多,默认有转发视图和重定向视图
当工程引入jstl的依赖,转发视图会自动转换为JstlView
1、转发视图
SpringMVC中默认的转发视图是InternalResourceView
SpringMVC中创建转发视图的情况:
当控制器方法中所设置的视图名称以“forward:”为前缀时,创建InternalResourceView视图,此时的视图名称不会被SpringMVC配置文件中所配置的视图解析器解析,而是会将前缀“forward:”去掉,剩余部分作为最终路径通过转发的方式实现跳转
例如“forward:/”,“forward:/employee”
The following code uses the Spring Framework in Java:
@RequestMapping("/testForward")
public String testForward() {
return "forward:/testHello";
}
It maps the URL "/testForward" to a method that forwards the request to the URL "/testHello".
2、重定向视图
SpringMVC中默认的重定向视图是RedirectView
当控制器方法中所设置的视图名称以“redirect:”为前缀时,创建RedirectView视图,此时的视图名称不会被SpringMVC配置文件中所配置的视图解析器解析,而是会将前缀“redirect:”去掉,剩余部分作为最终路径通过重定向的方式实现跳转
例如“redirect:/”,“redirect:/employee”
@RequestMapping("/testRedirect")
public String testRedirect() {
return "redirect:/testHello";
}
注:
重定向会把model中的数据通过url的方式传递到浏览器端
重定向视图在解析时,会先将redirect:前缀去掉,然后会判断剩余部分是否以/开头,若是则会自动拼接上下文路径
3、视图控制器view-controller
当控制器方法中,仅仅用来实现页面跳转,即只需要设置视图名称时,可以将处理器方法使用view-controller标签进行表示
<!-- 转发控制器-->
<mvc:view-controller path="/huiyuan" view-name="/WEB-INF/huiyuan.jsp"/>
<!-- 重定向控制器-->
<!-- <mvc:redirect-view-controller path="/bd" redirect-url="www.baidu.com"/>-->
七、RESTful案例
1、准备工作
和传统 CRUD 一样,实现对员工信息的增删改查。
请求方式 |
操作 |
传统接口 |
rest风格接口 |
POST |
新增操作 |
addUser |
/user |
DELETE |
删除操作 |
deleteUser?id=1 |
/user/1 |
PUT |
更新操作 |
updateUser?id=1 |
/user/1 |
GET |
查询操作 |
getUser?id=1 |
/user/1 |
6、@RestController注解
Spring MVC4.X 新特性
@RestController注解是springMVC提供的一个复合注解,标识在控制器的类上,就相当于为类添加了@Controller注解,并且为其中的每个方法添加了@ResponseBody注解,每个方法的返回结果会被spring自动调用jackson工具转化成json字符串后作为响应体返回给前端
7、ResponseEntity
ResponseEntity用于控制器方法的返回值类型,该控制器方法的返回值就是响应到浏览器的响应报文
Get请求时
return ResponseEntity.ok();
@GetMapping({“findAll”})
public ResponseEntity<PageResult> findAll(@RequestParam(name = “admin”, required = false) String admin,
@RequestParam(name = “page”, defaultValue = “1”) Integer page,
@RequestParam(name = “rows”, defaultValue = “10”) Integer rows) {
PageResult userPageResult = this.userService.findAll(admin, page, rows);
return ResponseEntity.ok(userPageResult);
}
Post请求新增一条记录时,有返回值
return ResponseEntity.status(HttpStatus.CREATE).body(); ()存放返回的内容
@PostMapping("save")
public ResponseEntity save(@RequestBody User user) throws Exception {
return ResponseEntity.status(HttpStatus.CREATED).body(this.userService.save(user));
}
Post请求新增一条记录时,无返回值
return new ResponseEntity(HttpStatus.CREATED);
Delete删除请求,无返回
return new ResponseEntity(HttpStatus.NO_CONTENT);
@DeleteMapping({“delete”})
public ResponseEntity delete(@RequestParam(name = “ids”) Integer ids) {
return ResponseEntity.ok(this.userService.delete(ids));
}
Put更新请求,无返回值
ResponseEntity.noContent().build();
@PutMapping({“update”})
public ResponseEntity update(@RequestBody User user) throws Exception {
return ResponseEntity.ok(this.userService.update(user));
}
有一天,HTTP走进了一家酒吧。
"GET一个啤酒。"他说。
"404." 酒保回答道。
HTTP感到很困惑,"404是啥意思?"
酒保解释道:"你要的啤酒没找到。"
八、文件上传和下载
1、文件下载
使用ResponseEntity实现下载文件的功能
import org.springframework.http.HttpStatus;
import org.springframework.http.ResponseEntity;
import org.springframework.web.bind.annotation.GetMapping;
import org.springframework.web.bind.annotation.RestController;
import javax.servlet.ServletContext;
import javax.servlet.http.HttpServletRequest;
import java.io.FileInputStream;
import java.io.FileNotFoundException;
import java.io.IOException;
@RestController
public class FileController {
@GetMapping("/download")
public ResponseEntity download(HttpServletRequest request) throws IOException {
ServletContext servletContext = request.getServletContext();
String realPath = servletContext.getRealPath("456.jpg");
FileInputStream fileInputStream = new FileInputStream(realPath);
byte[] bytes = new byte[fileInputStream.available()];
fileInputStream.read(bytes);
return ResponseEntity
.status(HttpStatus.OK)
.header("Content-Disposition", "attachment;filename=test.jpg")
.body(bytes);
}
}
2、文件上传
文件上传要求form表单的请求方式必须为post,并且添加属性enctype=“multipart/form-data”
前端form表单中的button按钮会按照get方式提交 不会被form上的method
以后form表单中的按钮 不要使用
使用input type submit
SpringMVC中将上传的文件封装到MultipartFile对象中,通过此对象可以获取文件相关信息
上传步骤:
注意:5.3版本 当中 可以获取到后缀名
a>添加依赖:
commons-fileupload commons-fileupload 1.3.1
b>在SpringMVC的配置文件中添加配置:
multipartResolver 这个配置的bean的id必须是这个名字,大小写也要完全一致
这个bean的id必须叫做multipartResolver , 类的名字是CommonsMultipartResolver
<!-- 添加文件上传的bean对象-->
<bean id="multipartResolver" class="org.springframework.web.multipart.commons.CommonsMultipartResolver"/>
c>控制器方法:
/**
* 文件上传
* @return
*/
@PostMapping("/file")
public ResponseEntity uploadFile(MultipartFile upFile, HttpServletRequest request) throws IOException {
String originalFilename = upFile.getOriginalFilename();
System.out.println("originalFilename = " + originalFilename);
InputStream inputStream = upFile.getInputStream();
ServletContext servletContext = request.getServletContext();
//必须要关联一个已存在的文件或者文件夹
String realPath = servletContext.getRealPath("/image");
realPath += ("/" + originalFilename);
FileOutputStream fileOutputStream = new FileOutputStream(realPath);
IOUtils.copy(inputStream, fileOutputStream);
fileOutputStream.close();
return ResponseEntity.ok().build();
}
九、拦截器
1、拦截器的配置
SpringMVC中的拦截器用于拦截控制器方法的执行
SpringMVC中的拦截器需要实现HandlerInterceptor
import org.springframework.web.servlet.HandlerInterceptor;
import org.springframework.web.servlet.ModelAndView;
import javax.servlet.annotation.WebFilter;
import javax.servlet.http.HttpServletRequest;
import javax.servlet.http.HttpServletResponse;
/**
* 标识当前这个拦截器应当拦截哪些请求, 在mvc配置文件中进行配置
*/
public class LoginInterceptor implements HandlerInterceptor {
/*
拦截一个请求, 在请求访问到具体的controller方法之前, 下面这个方法被触发
这个方法返回了一个布尔值, 如果是true表示放行, false则表示请求被拦截
*/
@Override
public boolean preHandle(HttpServletRequest request, HttpServletResponse response, Object handler) throws Exception {
//表明这个前置拦截被触发了
System.out.println("小手一指rap开始");
//1. 查询有无通行证, 有则放行
//if (request.getSession().getAttribute("userNow") != null) {
if (true) {
return true;
} else {
//如果想要给响应内容 调用response就可以了
return false;
}
}
/*
当被拦截的请求访问controller方法之后, controller方法执行完成后, 会触发一下下面的方法 (了解)
*/
@Override
public void postHandle(HttpServletRequest request, HttpServletResponse response, Object handler, ModelAndView modelAndView) throws Exception {
System.out.println("猪隐犯了");
}
}
SpringMVC的拦截器必须在SpringMVC的配置文件中进行配置:
<!-- 拦截器的具体配置-->
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<mvc:exclude-mapping path="/file"/>
<bean class="com.itszt22.interceptor.LoginInterceptor"/>
</mvc:interceptor>
</mvc:interceptors>
2、拦截器的三个抽象方法
SpringMVC中的拦截器有三个抽象方法:
preHandle:控制器方法执行之前执行preHandle(),其boolean类型的返回值表示是否拦截或放行,返回true为放行,即调用控制器方法;返回false表示拦截,即不调用控制器方法
postHandle:控制器方法执行之后执行postHandle()
afterComplation:处理完视图和模型数据,渲染视图完毕之后执行afterComplation() [了解]
<% java code %>
3、多个拦截器的执行顺序(了解)
a>若每个拦截器的preHandle()都返回true
此时多个拦截器的执行顺序和拦截器在SpringMVC的配置文件的配置顺序有关:
preHandle()会按照配置的顺序执行,而postHandle()和afterComplation()会按照配置的反序执行
b>若某个拦截器的preHandle()返回了false
preHandle()返回false和它之前的拦截器的preHandle()都会执行,postHandle()都不执行,返回false的拦截器之前的拦截器的afterCompletion()会执行
Java程序员在生活中碰到问题时,通常会想:
“这个问题我用代码怎么解决呢?”
十、统一异常处理器
传统的方式是通过方法的返回值的不同, 来确定是否校验失败的
企业级的方式是通过异常的抛出来通知上层, 校验失败了
//@ControllerAdvice将当前类标识为异常处理的组件
import org.springframework.ui.Model;
import org.springframework.web.bind.annotation.ControllerAdvice;
import org.springframework.web.bind.annotation.ExceptionHandler;
@ControllerAdvice
public class CommonExceptionHandler {
//通用的异常处理器, 当controller方法执行过程中出现了异常, 并且controller方法中没有try catch处理
//那就会被当前这个方法给捕获到
@ExceptionHandler(Exception.class) //如果申明的是Exception 表示捕获所有当前异常或者其子类
public String commonExceptionHandler(Exception exception, Model model){
exception.printStackTrace();
//获取异常信息
String message = exception.getMessage();
model.addAttribute("errorInfo", message);
return "/error.jsp";
}
}
十一、注解配置SpringMVC(了解)
使用配置类和注解代替web.xml和SpringMVC配置文件的功能
1、创建初始化类,代替web.xml
在Servlet3.0环境中,tomcat容器会在类路径中查找实现javax.servlet.ServletContainerInitializer接口的类,如果找到的话就用它来配置Servlet容器。
Spring提供了这个接口的实现,名为SpringServletContainerInitializer,这个类反过来又会查找实现WebApplicationInitializer的类并将配置的任务交给它们来完成。Spring3.2引入了一个便利的WebApplicationInitializer基础实现,名为AbstractAnnotationConfigDispatcherServletInitializer,当我们的类扩展了AbstractAnnotationConfigDispatcherServletInitializer并将其部署到Servlet3.0容器的时候,容器会自动发现它,并用它来配置Servlet上下文。
import org.springframework.web.filter.CharacterEncodingFilter;
import org.springframework.web.servlet.support.AbstractAnnotationConfigDispatcherServletInitializer;
import javax.servlet.Filter;
/**
* 顶替web.xml
*/
//public class WebInit extends AbstractAnnotationConfigDispatcherServletInitializer {
public class WebInit {
/* *//**
* 指定spring-ioc的配置类
* @return
*//*
@Override
protected Class<?>[] getRootConfigClasses() {
return new Class[]{SpringConfig.class};
}
*//**
* 指定SpringMVC的配置类
* @return
*//*
@Override
protected Class<?>[] getServletConfigClasses() {
return new Class[]{WebConfig.class};
}
*//**
* 指定DispatcherServlet的映射规则,即url-pattern
* @return
*//*
@Override
protected String[] getServletMappings() {
return new String[]{"/"};
}
*//**
* 添加过滤器
* @return
*//*
@Override
protected Filter[] getServletFilters() {
CharacterEncodingFilter encodingFilter = new CharacterEncodingFilter();
encodingFilter.setEncoding("UTF-8");
encodingFilter.setForceRequestEncoding(true);
return new Filter[]{encodingFilter};
}*/
}
2、创建SpringConfig配置类,代替spring的配置文件
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
@Configuration
@ComponentScan("com.itszt20.springmvc")
public class SpringConfig {
}
3、创建WebConfig配置类,代替SpringMVC的配置文件
import com.itszt20.springmvc.intercepters.LoginInterCepter2;
import org.springframework.context.annotation.Bean;
import org.springframework.context.annotation.ComponentScan;
import org.springframework.context.annotation.Configuration;
import org.springframework.web.multipart.commons.CommonsMultipartResolver;
import org.springframework.web.servlet.HandlerExceptionResolver;
import org.springframework.web.servlet.config.annotation.*;
import org.springframework.web.servlet.handler.SimpleMappingExceptionResolver;
import java.util.List;
import java.util.Properties;
//@Configuration
//扫描组件
//@ComponentScan("com.itszt20.springmvc.controller")
//开启MVC注解驱动
//@EnableWebMvc
public class WebConfig implements WebMvcConfigurer {
//使用默认的servlet处理静态资源
@Override
public void configureDefaultServletHandling(DefaultServletHandlerConfigurer configurer) {
configurer.enable();
}
//配置文件上传解析器
@Bean
public CommonsMultipartResolver multipartResolver(){
return new CommonsMultipartResolver();
}
//配置拦截器
@Override
public void addInterceptors(InterceptorRegistry registry) {
// LoginInterCepter2 loginInterCepter2 = new LoginInterCepter2();
// registry.addInterceptor(loginInterCepter2).addPathPatterns("/**");
}
//配置视图控制
@Override
public void addViewControllers(ViewControllerRegistry registry) {
// registry.addViewController("/").setViewName("index");
}
//配置异常映射
/* @Override
public void configureHandlerExceptionResolvers(List<HandlerExceptionResolver> resolvers) {
SimpleMappingExceptionResolver exceptionResolver = new SimpleMappingExceptionResolver();
Properties prop = new Properties();
prop.setProperty("java.lang.ArithmeticException", "error");
//设置异常映射
exceptionResolver.setExceptionMappings(prop);
//设置共享异常信息的键
exceptionResolver.setExceptionAttribute("ex");
resolvers.add(exceptionResolver);
}*/
}
十二. 总结
这篇文档介绍了Spring MVC中的一些功能,包括HTTP请求的处理、文件上传和下载、拦截器和异常处理器。
其中,文件下载使用了ResponseEntity实现,文件上传使用了MultipartFile对象,拦截器需要实现HandlerInterceptor接口,异常处理器可以基于配置或注解实现。
此外,还介绍了如何使用注解配置Spring MVC,代替传统的web.xml和SpringMVC配置文件。
文章评论