【springmvc】springmvc基本知识
SpringMVC概述
SpringMVC是一种基于Java 的实现MVC设计模型的请求驱动类型的轻量级Web框架，属于SpringFrameWork的后续产品，已经融合在Spring中。
SpringMVC已经成为目前最主流的MVC框架之一，并且随着Spring3.0的发布，全面超越Struts2，成为最优秀的MVC框架。它通过一套注解，让一个简单的Java类成为处理请求的控制器，而无须实现任何接口。同时它还支持RESTful编程风格的请求。
springmvc组件解析
SpringMVC执行流程（会自己描述）
- 用户发送请求至前端控制器DispatcherServlet；
- DispatcherServlet收到请求调用HandlerMapping处理器映射器；
- 处理器映射器找到具体的处理器(可以根据xml配置、注解进行查找)，生成处理器对象及处理器拦截器(如果有则生成)一并返回给DispatcherServlet；
- DispatcherServlet调用HandlerAdapter处理器适配器；
- HandlerAdapter经过适配调用具体的处理器(Controller，也叫后端控制器)；
- Controller执行完成返回ModelAndView；
- HandlerAdapter将Controller执行结果ModelAndView返回给DispatcherServlet；
- DispatcherServlet将ModelAndView传给ViewReslover视图解析器；
- ViewReslover解析后返回具体View；
- DispatcherServlet根据View进行渲染视图（即将模型数据填充至视图中）；
- DispatcherServlet响应用户。
springmvc各组件简介
前端控制器DispatcherServlet
用户请求到达前端控制器，它就相当于MVC模式中的C，DispatcherServlet是整个流程控制的中心，由它调用其它组件处理用户的请求，DispatcherServlet的存在降低了组件之间的耦合性。
处理器映射器HandlerMapping
HandlerMapping负责根据用户请求找到Handler即处理器，SpringMVC提供了不同的映射器实现不同的映射方式，例如：配置文件方式，实现接口方式，注解方式等。
处理器适配器HandlerAdapter
通过HandlerAdapter对处理器进行执行，这是适配器模式的应用，通过扩展适配器可以对更多类型的处理器进行执行。
处理器Handler
就是我们上面写的Controller，由DispatcherServlet把用户请求转发到Handler。由Handler 对具体的用户请求进行处理。
视图解析器ViewResolver
ViewResolver负责将处理结果生成View视图，ViewResolver 首先根据逻辑视图名解析成物理视图名，即具体的页面地址，再生成View视图对象，最后对View进行渲染将处理结果通过页面展示给用户。
视图view
SpringMVC框架提供了很多View视图类型的支持，包括：jspView、freemarkerView、pdfView等。最常用的视图就是JSP。一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户，需要由程序员根据业务需求开发具体的页面。
springmvc注解解析
@RequestMapping
作用：用于建立请求URL和处理请求类及方法之间的对应关系。
位置：
- 类上，请求URL的第一级访问目录。此处不写的话，就相当于应用的根目录；
- 方法上，请求URL的第二级访问目录，与类上的使用@RequestMapping标注的一级目录一起组成访问路径。
属性：
- value：用于指请求的URL，它和path属性的作用是一样的；
- method：用于指定请求的方式；
@RequestMapping(value = "/hello", method = RequestMethod.POST)
public String hello() {
return "/jsp/success.jsp";
}
params：用于指定限制请求参数的条件，它支持简单的表达式，要求请求参数的key和value必须和配置的一模一样
例如：
- params = {“accountName”}，表示请求参数必须有accountName
- params = {“moeny!100”}，表示请求参数中money不能是100
@RequestMapping(value = "/hello", method = RequestMethod.GET, params = {"username"})
public String hello() {
return "/jsp/success.jsp";
}
如果限制请求的方式，可以使用如下注解进行地址映射：
- @GetMapping(地址)，限制只接收get请求；
- @PostMapping(地址)，限制只接收post请求。
@Controller
指定这是一个控制器类，这个注解的作用和@Component作用是一样的，用来配置bean让Spring容器进行管理。配置了@Controller注解之后，需要在SpringMVC配置文件中配置包扫描：
<context:component-scan />
SpringMVC的XML配置解析
配置视图解析器
<bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<!-- 配置视图名称前缀 -->
<property name="prefix" value="/jsp/" />
<!-- 配置视图名称后缀 -->
<property name="suffix" value=".jsp" />
</bean>
修改HelloController中的方法
/**
* 配置视图解析器的前缀后缀之后，视图的写法
*/
@RequestMapping("/hello")
public String hello() {
return "success";
}
转发和重定向
我们在Controller中写的方法，默认以转发的方式转发到相应名称的试图，如果希望明确配置转发和重定向，在视图名称前加上
forward:或者redirect:。
/**
* 转发
*/
@RequestMapping("/hello1")
public String hello1() {
return "forward:/jsp/success.jsp";
}
/**
* 重定向
*/
@RequestMapping("/hello2")
public String hello2() {
return "redirect:/jsp/success.jsp";
}
SpringMVC的数据响应
数据响应方式概述
页面跳转
直接返回字符串
通过ModelAndView返回
回写数据
直接返回字符串
返回对象或集合
配置:
- 新建一个Controller，用来对请求进行处理
@Controller
@RequestMapping("/test")
public class TestController {
}
- 新建success.jsp，用来作为跳转之后的页面
/webapp/jsp/success.jsp
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>success</title>
</head>
<body>
<p>success</p>
</body>
</html>
- SpringMVC的配置文件
<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
xmlns:mvc="http://www.springframework.org/schema/mvc"
xmlns:context="http://www.springframework.org/schema/context"
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
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
http://www.springframework.org/schema/mvc http://www.springframework.org/schema/mvc/spring-mvc.xsd">
<context:component-scan base-package="com.qfedu" />
<!-- 配置视图解析器 -->
<bean id="viewResolver"
class="org.springframework.web.servlet.view.InternalResourceViewResolver">
<property name="prefix" value="/jsp/" />
<property name="suffix" value=".jsp" />
</bean>
</beans>
页面跳转-返回字符串形式
直接返回字符串：此种方式会将返回的字符串与视图解析器的前后缀拼接后跳转。
/**
* 直接返回字符串
*/
@RequestMapping("/test0")
public String test0() {
return "success";
}
页面跳转-返回ModelAndView形式
在Controller中方法返回ModelAndView对象，并且设置视图名称
/**
* 使用ModelAndView返回数据和视图
*/
@RequestMapping("/test1")
public ModelAndView test1() {
/*
Model:模型 作用封装数据
View：视图 作用展示数据
*/
ModelAndView mv = new ModelAndView();
//设置模型数据
mv.addObject("username", "zs");
//设置视图名称
mv.setViewName("success");
return mv;
}
@RequestMapping("/test2")
public ModelAndView test2(ModelAndView mv) {
mv.addObject("username", "ls");
mv.setViewName("success");
return mv;
}
页面跳转-使用Model对象
/**
* 使用Model返回数据
*/
@RequestMapping("/test3")
public String test3(Model m) {
m.addAttribute("username", "王五");
return "success";
}
页面跳转-使用Servlet相关对象
在Controller方法的形参上可以直接使用原生的Servlet对象，只需声明即可
/**
* 获取ServletAPI
*/
@RequestMapping("/test4")
public String test4(HttpServletRequest request, HttpSession session) {
request.setAttribute("k1", "v1");
session.setAttribute("k2", "v2");
ServletContext context = request.getServletContext();
context.setAttribute("k3", "v3");
return "success";
}
回写数据-回写字符串
通过SpringMVC框架注入的response对象，使用response.getWriter().print(“hello world”) 回写数据，此时不需要视图跳转，业务方法返回值为void
将需要回写的字符串直接返回，但此时需要通过@ResponseBody注解告知SpringMVC框架，方法返回的字符串不是跳转是直接在http响应体中返回
/**
* 回写字符串
*/
@RequestMapping("/test5")
public void test5(HttpServletResponse response) throws IOException {
PrintWriter out = response.getWriter();
out.println("<p style=\"border:1px solid #dddddd;color:blue;\">hello world</p>");
}
/**
* 回写字符串
*/
@RequestMapping("/test6")
@ResponseBody
public String test6() {
return "hello SpringMVC";
}
回写数据-回写JSON格式字符串
/**
* 返回JSON字符串
*/
@RequestMapping("/test7")
@ResponseBody
public String test7() {
return "{\"username\":\"zhangsan\",\"age\":10}";
}
手动拼接json格式字符串的方式很麻烦，开发中往往要将复杂的java对象转换成json格式的字符串，我们可以使用web阶段学习过的json转换工具jackson进行转换,通过jackson转换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.9.0</version>
</dependency>
<dependency>
<groupId>com.fasterxml.jackson.core</groupId>
<artifactId>jackson-annotations</artifactId>
<version>2.9.0</version>
</dependency>
/**
* 返回JSON字符串
*/
@RequestMapping("/test8")
@ResponseBody
public String test8() throws JsonProcessingException {
User user = new User();
user.setUsername("ZhangSan");
user.setAge(10);
//使用json的转换工具将对象转换成json格式字符串在返回
ObjectMapper mapper = new ObjectMapper();
String s = mapper.writeValueAsString(user);
return s;
}
回写数据-返回对象或集合
通过SpringMVC帮助我们将对象或集合进行JSON字符串的转换并回写，为处理器适配器配置消息转换参数，指定使用jackson进行对象或集合的转换，因此需要在spring-mvc.xml中进行如下配置：
<!-- 配置处理器映射器
目的：配置消息转换器，实现bean对象到json的转换
-->
<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>
上面配置处理器映射器比较麻烦，可以使用<mvc:annotation-driven/>代替。使用<mvc:annotation-driven />默认底层就会集成jackson进行对象或集合的json格式字符串的转换。
如果一个Controller中所有的方法都要返回JSON，可以进行如下操作：
- 将Controller使用@Controller和@ResponseBody进行修饰；
- 将Controller使用@RestController进行修饰（建议使用这种方式）。
/**
* 返回对象，将对象转换成JSON
*
* 这种情况需要在spring-mvc.xml中进行配置
*/
@RequestMapping("/test9")
@ResponseBody
public User test9() {
User user = new User();
user.setUsername("LiSi");
user.setAge(20);
return user;
}
/**
* 返回对象，将对象转换成JSON
*
* 这种情况需要在spring-mvc.xml中进行配置
*/
@RequestMapping("/test10")
@ResponseBody
public List<User> test10() {
User user1 = new User();
user1.setUsername("LiSi");
user1.setAge(20);
User user2 = new User();
user2.setUsername("Tom");
user2.setAge(15);
User user3 = new User();
user3.setUsername("Bob");
user3.setAge(16);
List<User> list = new ArrayList<>();
list.add(user1);
list.add(user2);
list.add(user3);
return list;
}
/**
* 返回对象，将对象转换成JSON
*
* 这种情况需要在spring-mvc.xml中进行配置
*/
@RequestMapping("/test11")
@ResponseBody
public Map<String, String> test11() {
Map<String, String> map = new HashMap<>();
map.put("birthday", new Date().toString());
map.put("tomorrow", new Date().toString());
return map;
}
/**
* 返回对象，将对象转换成JSON
*
* 这种情况需要在spring-mvc.xml中进行配置
*/
@RequestMapping("/test12")
@ResponseBody
public Set<User> test12() {
Set<User> set = new HashSet<>();
User u1 = new User();
u1.setUsername("zs");
u1.setAge(10);
User u2 = new User();
u2.setUsername("ls");
u2.setAge(11);
set.add(u1);
set.add(u2);
return set;
}
SpringMVC的请求
客户端请求参数的格式是：
name=value&name=value……服务器端要获得请求的参数，有时还需要进行数据的封装，SpringMVC可以接收如下类型的参数:
- 基本类型参数
- POJO类型参数
- 数组类型参数
- 集合类型参数
获得基本类型参数(重要)
Controller中的业务方法的参数名称要与请求参数的name一致，参数值会自动映射匹配；并且能自动做类型转换（String向其他类型转换）。
/**
* 获取基本数据类型参数
* 请求参数名和方法参数相同，会进行自动映射，方法参数和请求参数值相同
*/
@RequestMapping("/test1")
public String test1(String username, int age) {
System.out.println(username);
System.out.println(age);
return "success";
}
发送请求测试：
http://localhost:8080/test/test1?username=Tom&password=123456
获得POJO类型参数（重要）
Controller中的业务方法的POJO参数的属性名与请求参数的key一致，参数值会自动映射匹配。
User.java
public class Student {
private Integer id;
private String name;
private String addr;
//页面传递过来的String类型的时间会转换为Date类型
@DateTimeFormat(pattern = "yyyy-MM-dd HH:mm:ss")
private Date birthday;
//set、get
//toString
}
/**
* 获取pojo类型参数
* 请求参数和bean的属性名相同，SpringMVC会自动进行封装
*/
@RequestMapping("/test2")
public String test2(User user) {
System.out.println(user);
return "success";
}
发送请求测试：
http://localhost:8080/test/test2?id=1&name=zs&addr=qd&birthday=2020-10-10 18:10:30
获得数组类型参数（重要）
Controller中的业务方法数组名称与请求参数的name一致，参数值会自动映射匹配。
/**
* 获取数组类型参数
* 数组名称和参数名称一致，SpringMVC会进行自动映射
*/
@RequestMapping("/test3")
public String test3(String[] hobby) {
System.out.println(Arrays.toString(hobby));
return "success";
}
发送请求测试：
http://localhost:8080/test/test2?hobby=学习1&hobby=学习2&hobby=学习3
获得集合类型参数1-集合封装到POJO中
获得集合参数时，要将集合参数包装到一个POJO中才可以。
Person.java里面封装了集合
public class Person {
List<User> list;
Map<String, User> map;
Set<User> set;
public Person() {
/**
* 封装set类型参数时，在Person类中一定要先初始化，不然会报错
*/
set = new HashSet<>();
set.add(new User());
set.add(new User());
}
// get set toString 方法
}
/** * 获取集合类型参数，如果普通的get提交或者通过form表单提交，要将集合封装到一个pojo类中才能接收
*
* 如果提交的是json数据，集合可以直接接收，不需要封装到pojo类中
*/
@RequestMapping("/test4")
public String test4(Person person) {
System.out.println(person.getList());
System.out.println(person.getMap());
/**
* 封装set类型参数时，在Person类中一定要先初始化，不然会报错
*/
System.out.println(person.getSet());
return "success";
}
<form action="${pageContext.request.contextPath}/test/test4" method="post">
<input type="text" name="list[0].username" /><br/>
<input type="text" name="list[0].age" /><br/>
<input type="text" name="list[1].username" /><br/>
<input type="text" name="list[1].age" /><br/>
<input type="text" name="map['1'].username" /><br/>
<input type="text" name="map['1'].age" /><br/>
<input type="text" name="map['2'].username" /><br/>
<input type="text" name="map['2'].age" /><br/>
<input type="text" name="set[0].username" /><br/>
<input type="text" name="set[0].age" /><br/>
<input type="text" name="set[1].username" /><br/>
<input type="text" name="set[1].age" /><br/>
<button type="submit">提交</button>
</form>
获得集合类型参数2-使用@RequestBody（重要）
当使用ajax提交时，可以指定contentType为json形式（接受json格式数据），那么在方法参数位置使用@RequestBody可以直接接收集合数据而无需使用POJO进行包装.
<script src="${pageContext.request.contextPath}/js/jquery-3.3.1.js"></script>
<script>
var userList = new Array();
userList.push({username:'zs',age:10});
userList.push({username:'ls',age:12});
userList.push({username:'tom',age:20});
$.ajax({
type:'POST',
url:'${pageContext.request.contextPath}/test/test5',
data:JSON.stringify(userList),
contentType:"application/json;charset=utf-8"
})
</script>
@RequestMapping("/test5")
public void test5(@RequestBody List<User> users) {
System.out.println(users);
}
静态资源访问的开启（重要）
当有静态资源需要加载时，比如jquery文件，通过谷歌开发者工具抓包发现，没有加载到jquery文件，原因是SpringMVC的前端控制器DispatcherServlet的url-pattern配置的是/,代表对所有的资源都进行过滤操作，我们可以通过以下三种方式指定放行静态资源。
1）DispathcerServlet采用其他的url-pattern
<servlet>
<servlet-name>dispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
</servlet>
<servlet-mapping>
<servlet-name>dispatcherServlet</servlet-name>
<url-pattern>*.action</url-pattern>
</servlet-mapping>
此时，所有访问handler的路径都要以 action结尾。
2）在spring-mvc.xml配置文件中指定放行的资源
<!-- 配置静态资源不拦截 -->
<mvc:resources mapping="/js/**" location="/js/" />
<mvc:resources mapping="/css/**" location="/css/" />
<mvc:resources mapping="/img/**" location="/img/" />
3）使用
<mvc:default-servlet-handler/>标签
<mvc:default-servlet-handler />
配置全局乱码过滤器-POST请求（重要）
Tomcat8的版本中***get方式***不会出现乱码了，因为服务器对url的编码格式可以进行自动转换；
当post请求时，数据会出现乱码，我们可以设置一个过滤器来进行编码的过滤。
web.xml
<!-- 解决中文乱码的Filter 最好放在前面 -->
<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>forceEncoding</param-name>
<param-value>true</param-value>
</init-param>
</filter>
<filter-mapping>
<filter-name>CharacterEncodingFilter</filter-name>
<url-pattern>/*</url-pattern>
</filter-mapping>
参数绑定注解@RequestParam
当请求的参数名称与Controller的业务方法参数名称不一致时，就需要通过@RequestParam注解进行绑定
@RequestMapping("/test6")
public String test6(@RequestParam(name="name", required=false, defaultValue="Jim") String username) {
System.out.println(username);
return "success";
}
Restful风格参数获取@PathVariable（以及@GetMapping、@PostMapping）（重要）
Restful是一种软件架构风格、设计风格，而不是标准，只是提供了一组设计原则和约束条件。主要用于客户端和服务器交互类的软件，基于这个风格设计的软件可以更简洁，更有层次，更易于实现缓存机制等。
Restful风格的请求是使用“url+请求方式”表示一次请求目的的，HTTP 协议里面四个表示操作方式的动词如下：
- GET：用于获取资源
- POST：用于新建资源
- PUT：用于更新资源
- DELETE：用于删除资源
例如:
- /user/1 GET ： 得到 id = 1 的 user
- /user/1 DELETE： 删除 id = 1 的 user
- /user/1 PUT： 更新 id = 1 的 user
- /user POST： 新增 user
上述url地址/user/1中的1就是要获得的请求参数，在SpringMVC中可以使用占位符进行参数绑定。地址/user/1可以写成/user/{id}，占位符{id}对应的就是1的值。在业务方法中我们可以使用@PathVariable注解进行占位符的匹配获取工作。
/**
* Restful风格的请求参数
* url+请求类型
*/
@GetMapping("/test7/{username}")
public String test7(@PathVariable("username") String username) {
System.out.println(username);
return "success";
}
请求地址:
http://localhost:8080/test/test7/Bob
自定义类型转换器—日期转换
自定义类型转换器:
public class DateConverter implements Converter<String, Date> {
@Override
public Date convert(String s) {
SimpleDateFormat fmt = new SimpleDateFormat("yyyy-MM-dd");
Date date = null;
try {
date = fmt.parse(s);
} catch (ParseException e) {
e.printStackTrace();
}
return date;
}
}
/**
* 接收Date类型参数，这里需要自定义类型转换器进行支持
*/
@RequestMapping("/test8")
public String test8(Date date) {
System.out.println(date);
return "success";
}
<!-- 配置类型转换器 -->
<bean id="conversionServiceFactoryBean" class="org.springframework.context.support.ConversionServiceFactoryBean">
<property name="converters">
<list>
<bean class="com.qfedu.converter.DateConverter" />
</list>
</property>
</bean>
<!-- 配置spring开启注解mvc的支持 引用类型转换器 -->
<mvc:annotation-driven conversion-service="conversionServiceFactoryBean"/>
获取请求头信息@RequestHeader、@CookieValue
使用@RequestHeader可以获得请求头信息，相当于web阶段学习的request.getHeader(name),@RequestHeader注解的属性如下：
- value：请求头的名称
- required：是否必须携带此请求头
使用@CookieValue可以获得指定Cookie的值,@CookieValue注解的属性如下：
- value：指定cookie的名称
- required：是否必须携带此cookie
/**
* 获取请求头
*/
@RequestMapping("/test10")
public String test10(@RequestHeader(value="User-Agent", required=false) String userAgent,
@RequestHeader(value="Accept-Language", required=false) String acceptLanguage,
@CookieValue(value="JSESSIONID") String sessionId) {
System.out.println(userAgent);
System.out.println(acceptLanguage);
System.out.println(sessionId);
return "success";
}
