spring-MVC
快速入门
1.导入依赖
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>5.2.10.RELEASE</version>
</dependency>
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>5.2.10.RELEASE</version>
</dependency>
2.在web.xml中配置SpringMVC的前端控制器
<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:spring-mvc.xml</param-value>
</init-param>
</servlet>
<servlet-mapping>
<servlet-name>dispatcherServlet</servlet-name>
<url-pattern>/</url-pattern>
</servlet-mapping>
springMVC流程图
注解解析
@RequestMapping
作用:用于建立请求URL和处理请求方法之间的对应关系
位置:
类上:请求URL的第一级访问目录。此处不写的话,就相当于应用的根目录
方法上:请求URL的第二级访问目录,与类上的使用@RequestMapping标注的一级目录一起组成访问虚拟路径
属性:
value:用于指定请求的URL。它和path属性的作用是一样的
**method:用于指定请求的方式 **
例如:@RequestMapping(value = “/login”,method = RequestMethod.POST,params = {“accountName”})
params:用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的key和value必须和配置的一模一样
例如:
params = {“accountName”},表示请求参数必须有accountName
params = {“moeny!100”},表示请求参数中money不能是100
自定义视图解析器
<bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/jsp/"></property>
<property name="suffix" value=".jsp"></property>
</bean>
数据响应
响应方式
页面跳转
1.返回字符串形式
直接返回字符串:此种方式会将返回的字符串与视图解析器的前后缀拼接后跳转。
2.返回ModelAndView对象
@RequestMapping("/quick")
public ModelAndView quickMethod(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.setViewName("redirect:index.jsp");
return modelAndView;
}
@RequestMapping("/quick")
public ModelAndView quickMethod(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.setViewName("forward:/WEB-INF/views/index.jsp");
return modelAndView;
}
3.向request域中存数据
通过SpringMVC框架注入的request对象setAttribute()方法设置
@RequestMapping("/quick")
public String quickMethod(HttpServletRequest request){
request.setAttribute("name","zhangsan");
return "index";
}
通过ModelAndView的addObject()方法设置
@RequestMapping("/quick")
public ModelAndView quickMethod(){
ModelAndView modelAndView = new ModelAndView();
modelAndView.setViewName("forward:/WEB-INF/views/index.jsp");
modelAndView.addObject("name","lisi");
return modelAndView;
}
回写数据
1.直接返回字符串
1.通过SpringMVC框架注入的response对象,使用response.getWriter().print(“hello world”)回写数据,此时不需要视图跳转,业务方法返回值为void。
@RequestMapping("/quick")
public void quickMethod(HttpServletResponse response) throws
IOException {
response.getWriter().print("hello world");
}
2.将需要回写的字符串直接返回,但此时需要通过@ResponseBody注解告知SpringMVC框架,方法 返回的字符串不是跳转是直接在http响应体中返回。
@RequestMapping("/quick")
@ResponseBody
public String quickMethod() throws IOException {
return "hello springMVC!!!";
}
在异步项目中,客户端与服务器端往往要进行json格式字符串交互,此时我们可以手动拼接json字符串返回。
@RequestMapping("/quick")
@ResponseBody
public String quickMethod() throws IOException {
return "{\"name\":\"zhangsan\",\"age\":18}";
}
使用json的转换工具jackson
导入依赖
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-core</artifactId>
<version>2.9.0</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-databind</artifactId>
<version>2.10.0</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
<version>2.10.0</version>
</dependency>
通过jackon工具转换json
@RequestMapping("/quick")
@ResponseBody
public String quickMethod() throws IOException {
User user = new User();
user.setUsername("zhangsan");
user.setAge(18);
ObjectMapper objectMapper = new ObjectMapper();
String s = objectMapper.writeValueAsString(user);
return s;
}
2.返回对象或集合
通过SpringMVC帮助我们将对象或集合进行json字符串的自动转换并回写,为处理器适配器配置消息转换参数,
指定使用jackson进行对象或集合的转换,因此需要在spring-mvc.xml中进行如下配置:
<bean class="org.springframework.web.servlet.mvc.method.annotation.RequestMappingHandlerAdapter">
<property name="messageConverters">
<list>
<bean class="org.springframework.http.converter.json.MappingJackson2HttpMessageConverter">
</bean>
</list>
</property>
</bean>
@RequestMapping("/quick")
@ResponseBody
public User quickMethod() throws IOException {
User user = new User();
user.setUsername("zhangsan");
user.setAge(18);
return user;
}
在方法上添加@ResponseBody就可以返回json格式的字符串,但是这样配置比较麻烦,配置的代码比较多,因此,我们可以使用mvc的注解驱动代替上述配置。
<mvc:annotation-driven/>
在 SpringMVC 的各个组件中,处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。 使用自动加载 RequestMappingHandlerMapping(处理映射器)和 RequestMappingHandlerAdapter( 处 理 适 配 器 ),可用在Spring-mvc.xml配置文件中使用 mvc:annotation-driven/ 替代注解处理器和适配器的配置。 同时使用默认底层就会集成jackson进行对象或集合的json格式字符串的转换。
获取请求数据
获取请求参数
SpringMVC可以接收如下类型的参数
获得基本类型参数
Controller中的业务方法的参数名称要与请求参数的name一致,参数值会自动映射匹配。
http://localhost:8080/quick?username=zhangsan&age=12
@RequestMapping("/quick")
@ResponseBody
public void quickMethod(String username,int age) throws IOException {
System.out.println(username);
System.out.println(age);
}
获得POJO类型参数
Controller中的业务方法的POJO参数的属性名与请求参数的name一致,参数值会自动映射匹配。
http://localhost:8080/quick?username=zhangsan&age=12
public class User {
private String username;
private int age;
getter/setter…
}
@RequestMapping("/quick")
@ResponseBody
public void quickMethod(User user) throws IOException {
System.out.println(user);
}
获得数组类型参数
Controller中的业务方法数组名称与请求参数的name一致,参数值会自动映射匹配。
http://localhost:8080/quick?strs=111&strs=222&strs=333
@RequestMapping("/quick")
@ResponseBody
public void quickMethod(String[] strs) throws IOException {
System.out.println(Arrays.asList(strs));
}
获得集合类型参数
获得集合参数时,要将集合参数包装到一个POJO中才可以。
<form action="${pageContext.request.contextPath}/quick" method="post">
<input type="text" name="userList[0].username"><br>
<input type="text" name="userList[0].age"><br>
<input type="text" name="userList[1].username"><br>
<input type="text" name="userList[1].age"><br>
<input type="submit" value="提交"><br>
</form>
public class Vo {
private List<User> list;
public List<User> getList() {
return list;
}
public void setList(List<User> list) {
this.list = list;
}
}
@RequestMapping("/quick")
@ResponseBody
public void quickMethod(Vo vo) throws IOException {
System.out.println(vo.getUserList());
}
当使用ajax提交时,可以指定contentType为json形式,那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装。
<script>
//模拟数据
var userList = new Array();
userList.push({username: "zhangsan",age: "20"});
userList.push({username: "lisi",age: "20"});
$.ajax({
type: "POST",
url: "/quick",
data: JSON.stringify(userList),
contentType : 'application/json;charset=utf-8'
});
</script>
@RequestMapping("/quick")
@ResponseBody
public void quickMethod(@RequestBody List<User> userList) throws
IOException {
System.out.println(userList);
}
过滤静态资源
<mvc:resources mapping="/js/**" location="/js/"/>
<!--tomcat默认资源处理 -->
<mvc:default-servlet-handler/>
请求数据乱码问题
当post请求时,数据会出现乱码,我们可以设置一个过滤器来进行编码的过滤。
在web.xml配置文件中配置过滤器
<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>
参数绑定注解@requestParam
当请求的参数名称与Controller的业务方法参数名称不一致时,就需要通过@RequestParam注解显示的绑定。
<form action="${pageContext.request.contextPath}/quick" method="post">
<input type="text" name="name"><br>
<input type="submit" value="提交"><br>
</form>
@RequestMapping("/quick")
@ResponseBody
public void quickMethod(@RequestParam("name") String username) throws
IOException {
System.out.println(username);
}
获得Restful风格的参数
Restful是一种软件架构风格、设计风格,而不是标准,只是提供了一组设计原则和约束条件。主要用于客户端和服务器交互类的软件,基于这个风格设计的软件可以更简洁,更有层次,更易于实现缓存机制等。
上述url地址/user/1中的1就是要获得的请求参数,在SpringMVC中可以使用占位符进行参数绑定。地址/user/1可以写成 /user/{id},占位符{id}对应的就是1的值。在业务方法中我们可以使用@PathVariable注解进行占位符的匹配获取工作。
http://localhost:8080/quick/zhangsan
@RequestMapping("/quick/{name}")
@ResponseBody
public void quickMethod(@PathVariable(value = "name",required = true) String name){
System.out.println(name);
}
@RequestBody注解
@RequestBody主要用来接收前端传递给后端的json字符串中的数据的(请求体中的数据的)
json数据就会自动匹配到被注解修饰的对象中的属性中了
@PostMapping("/login")
public R<Employee> login(HttpServletRequest request, @RequestBody Employee employee){
return null;
}
employee就可以取出前端传入的Jason类型的参数映射的实体类,需要变量名一致才能自动映射
自定义类型转换器
[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-VHdsJLWX-1686635340950)(https://gitee.com/waiting-for-you-in-the-fog/typora-images/raw/master/java/202306111636920.png)]
自定义类型转换器步骤
1.定义转换器类实现Converter接口
public class DateConverter implements Converter<String,Date>{
//<String,Date> String是要转换的字符串,Date是转换后的类型
@Override
public Date convert(String source) {
SimpleDateFormat format = new SimpleDateFormat("yyyy-MM-dd");
try {
Date date = format.parse(source);
return date;
} catch (ParseException e) {
e.printStackTrace();
}
return null;
}
}
2.在配置文件中声明转换器
<bean id="converterService"
class="org.springframework.context.support.ConversionServiceFactoryBean">
<property name="converters">
<list>
<bean class="com.feng.converter.DateConverter"/>
</list>
</property>
</bean>
3.在中引用转换器
<mvc:annotation-driven conversion-service="converterService"/>
获得Servlet相关API
@RequestMapping("/quick")
@ResponseBody
public void quickMethod(HttpServletRequest request,HttpServletResponse
response,
HttpSession session){
System.out.println(request);
System.out.println(response);
System.out.println(session);
}
获得请求头
@RequestHeader
@RequestMapping("/quick")
@ResponseBody
public void quickMethod(
@RequestHeader(value = "User-Agent",required = false) String
headerValue){
System.out.println(headerValue);
}
@CookieValue
@RequestMapping("/quick")
@ResponseBody
public void quickMethod(
@CookieValue(value = "JSESSIONID",required = false) String jsessionid){
System.out.println(jsessionid);
}
文件上传
<form action="${pageContext.request.contextPath}/quick" method="post"
enctype="multipart/form-data">
名称:<input type="text" name="name"><br>
文件:<input type="file" name="file"><br>
<input type="submit" value="提交"><br>
</form>
单文件上传步骤
1.导入fileupload和io依赖
<dependency>
<groupId>commons-fileupload</groupId>
<artifactId>commons-fileupload</artifactId>
<version>1.2.2</version>
</dependency>
<dependency>
<groupId>commons-io</groupId>
<artifactId>commons-io</artifactId>
<version>2.4</version>
</dependency>
2.配置文件上传解析器
<bean id="multipartResolver"
class="org.springframework.web.multipart.commons.CommonsMultipartResolver">
<!--上传文件总大小 5m-->
<property name="maxUploadSize" value="5242800"/>
<!--上传单个文件的大小 5m-->
<property name="maxUploadSizePerFile" value="5242800"/>
<!--上传文件的编码类型-->
<property name="defaultEncoding" value="UTF-8"/>
</bean>
3.编写文件上传代码
@RequestMapping("/quick")
@ResponseBody
//参数MultipartFile uploadFile 是spring封装的文件对象
//需要和web页面的文件:<input type="file" name="uploadFile">
//name属性保持一致
public void quickMethod(String name,MultipartFile uploadFile) throws
IOException {
//获得文件名称
String originalFilename = uploadFile.getOriginalFilename();
//保存文件
uploadFile.transferTo(new File("C:\\upload\\"+originalFilename));
}
多文件上传步骤
多文件上传,只需要将页面修改为多个文件上传项,将方法参数MultipartFile类型修改为MultipartFile[]即可
<h1>多文件上传测试</h1>
<form action="${pageContext.request.contextPath}/quick" method="post"
enctype="multipart/form-data">
名称:<input type="text" name="name"><br>
文件1:<input type="file" name="uploadFiles"><br>
文件2:<input type="file" name="uploadFiles"><br>
文件3:<input type="file" name="uploadFiles"><br>
<input type="submit" value="提交"><br>
</form>
@RequestMapping("/quick")
@ResponseBody
public void quickMethod(String name,MultipartFile[] uploadFiles) throws
IOException {
for (MultipartFile uploadFile : uploadFiles){
String originalFilename = uploadFile.getOriginalFilename();
uploadFile.transferTo(new File("C:\\upload\\"+originalFilename));
}
}
拦截器
**Spring MVC 的拦截器类似于 Servlet 开发中的过滤器 Filter,用于对处理器进行预处理和后处理。 **
将拦截器按一定的顺序联结成一条链,这条链称为拦截器链(Interceptor Chain)。在访问被拦截的方法或字段时,拦截器链中的拦截器就会按其之前定义的顺序被调用。拦截器也是AOP思想的具体实现。
拦截器和过滤器的区别
快速入门
1.创建拦截器类实现HandlerInterceptor接口
public class MyHandlerInterceptor1 implements HandlerInterceptor {
//在目标方法执行之前
public boolean preHandle(HttpServletRequest request, HttpServletResponse
response, Object handler) {
System.out.println("preHandle running...");
//返回值默认是false,代表不放行
//返回true代表放行
return true;
}
//在目标方法执行之后视图对象返回之前执行
public void postHandle(HttpServletRequest request, HttpServletResponse
response, Object handler, ModelAndView modelAndView) {
System.out.println("postHandle running...");
}
//在整个流程都执行完毕,再执行
public void afterCompletion(HttpServletRequest request, HttpServletResponse
response, Object handler, Exception ex) {
System.out.println("afterCompletion running...");
}
}
2.在spring-mvc.xml中配置
<!--配置拦截器-->
<mvc:interceptors>
<mvc:interceptor>
<mvc:mapping path="/**"/>
<bean class="com.feng.Interceptor.MyInterceptor"/>
</mvc:interceptor>
</mvc:interceptors>
3.测试
@RequestMapping("/quick")
@ResponseBody
public ModelAndView quickMethod() throws IOException, ParseException {
System.out.println("目标方法执行....");
ModelAndView modelAndView = new ModelAndView();
modelAndView.addObject("name","itcast");
modelAndView.setViewName("index");
return modelAndView;
}
http://localhost:8080/quick
多拦截器操作
同上,在编写一个MyHandlerInterceptor2操作,测试执行顺序
先过去的后执行
执行顺序和在spring-mvc.xml中配置的顺序有关系
配置在上面的先执行
拦截器方法说明
异常
系统中异常包括两类:预期异常和运行时异常RuntimeException,前者通过捕获异常从而获取异常信息,后 者主要通过规范代码开发、测试等手段减少运行时异常的发生。
系统的Dao、Service、Controller出现都通过throws Exception向上抛出,最后由SpringMVC前端控制器交 由异常处理器进行异常处理
异常处理方式
1.使用Spring MVC提供的简单异常处理器SimpleMappingExceptionResolver
SpringMVC已经定义好了该类型转换器,在使用时可以根据项目情况进行相应异常与视图的映射配置
<!--简单映射异常处理 -->
<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
<!-- 通用的默认异常处理页面 value是跳转的页面,可以被视图解析器解析-->
<property name="defaultErrorView" value="404"/>
<!-- 指定的异常处理页面 key是异常类型 value是跳转的界面-->
<property name="exceptionMappings">
<map>
<entry key="java.lang.ClassCastException" value="500"/>
<entry key="java.lang.NullPointerException" value="403"/>
</map>
</property>
</bean>
2.实现Spring的异常处理接口HandlerExceptionResolver 自定义自己的异常处理器
1.创建异常处理器类实现HandlerExceptionResolver 并重写方法
/**
* 参数Exception ex
* 是指出现的异常对象
* 返回值ModelAndView
*是要跳转到错误视图的信息
*/
public ModelAndView resolveException(HttpServletRequest request, HttpServletResponse response, Object handler, Exception ex) {
ModelAndView modelAndView = new ModelAndView();
if (ex instanceof NullPointerException){
modelAndView.addObject("msg","空指针异常");
}else {
modelAndView.addObject("msg","其他异常");
}
modelAndView.setViewName("500");
return modelAndView;
}
2.配置异常处理器
<bean id="exceptionResolver"
class="com.feng.resolver.MyExceptionResolver"/>
spring-mvc配置文件整合
<?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:mvc="http://www.springframework.org/schema/mvc"
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/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd
http://www.springframework.org/schema/context http://www.springframework.org/schema/context/spring-context.xsd
">
<!-- mvc的注解驱动 可以直接返回jason格式字符串-->
<mvc:annotation-driven/>
<!-- 配置视图解析器 -->
<bean class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/pages/"/>
<property name="suffix" value=".jsp"/>
</bean>
<!--放行静态资源 tomcat默认的servlet-->
<mvc:default-servlet-handler/>
<!--组件扫描 主要扫描controller-->
<context:component-scan base-package="com.feng.controller"/>
<!--配置拦截器-->
<mvc:interceptors>
<mvc:interceptor>
<!--拦截哪些-->
<mvc:mapping path="/**"/>
<!--哪些不被拦截-->
<mvc:exclude-mapping path="/login"/>
<bean class="com.feng.Interceptor.MyInterceptor"/>
</mvc:interceptor>
</mvc:interceptors>
<!--简单映射异常处理 -->
<bean class="org.springframework.web.servlet.handler.SimpleMappingExceptionResolver">
<!-- 通用的默认异常处理页面 value是跳转的页面,可以被视图解析器解析-->
<property name="defaultErrorView" value="404"/>
<!-- 指定的异常处理页面 key是异常类型 value是跳转的界面-->
<property name="exceptionMappings">
<map>
<entry key="java.lang.ClassCastException" value="500"/>
<entry key="java.lang.NullPointerException" value="403"/>
</map>
</property>
</bean>
</beans>