# 一、springMVC-quickStar
- 解决maven加载项目过慢
```java
archetypeCatalog
internal
```
- 导入依赖
```xml
5.0.2.RELEASE
org.springframework
spring-context
${spring.version}
org.springframework
spring-web
${spring.version}
org.springframework
spring-webmvc
${spring.version}
javax.servlet
servlet-api
2.5
provided
javax.servlet.jsp
jsp-api
2.0
provided
```
- web.xml配置
```xml
dispatcherServlet
org.springframework.web.servlet.DispatcherServlet
contextConfigLocation
classpath:springmvc.xml
1
dispatcherServlet
/
```
在 SpringMVC 的各个组件中，处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。 使 用 < mvc:annotation-driven> 自动加载 RequestMappingHandlerMapping （处理映射器） 和 RequestMappingHandlerAdapter （ 处 理 适 配 器 ） ， 可 用 在 SpringMVC.xml 配 置 文 件 中 使 用 < mvc:annotation-driven>替代注解处理器和适配器的配置。
- 创建控制器类
```java
package club.leyvan.controller
//控制器类
@Controller
public class HelloController {
@RequestMapping(path="/hello")
public String sayHello(){
System.out.println("Hello SpringMvc");
return "success";
}
}
```
# 二、@RequestMapping注解
1. RequestMapping注解的作用是建立请求URL和处理方法之间的对应关系
2. RequestMapping注解可以作用在方法和类上
1. 作用在类上：第一级的访问目录
2. 作用在方法上：第二级的访问目录
3. 细节：路径可以不编写 / 表示应用的根目录开始
4. 细节：${ pageContext.request.contextPath }也可以省略不写，但是路径上不能写 /
3. RequestMapping的属性
1. **path** 指定请求路径的url
2. **value** value属性和path属性是一样的 **源码中声明了：@AliasFor("path")**
3. **mthod** 指定该方法的请求方式 **例：method={RequestMethod.POST}**
4. **params** 指定限制请求参数的条件 **例：params={"username=123"} 请求中必须含有username参数且值必须为123，否则不接受此请求**
5. **headers** 发送的请求中必须包含的请求头 **例：设置一个防爬虫的请求头及值，如果不是用户请求头则不接受访问**
# 三、请求参数绑定
1. 请求参数的绑定说明
1. 绑定机制
1. 表单提交的数据都是k=v格式的 username=haha&password=123
2. SpringMVC的参数绑定过程是把表单提交的请求参数，作为控制器中方法的参数进行绑定的
3. **要求：提交表单的name和方法参数的名称是相同的**
2. 支持的数据类型
1. 基本数据类型和字符串类型
2. 实体类型（JavaBean）
3. 集合数据类型（List、map集合等）
2. 基本数据类型和字符串类型
1. 提交表单的name和参数的名称是相同的
2. 区分大小写
3. 实体类型（JavaBean）
1. 提交表单的name和JavaBean中的属性名称需要一致
2. 如果一个JavaBean类中包含其他的引用类型，那么表单的name属性需要编写成：对象.属性 例如：address.name
4. 给集合属性数据封装
1. JSP页面编写方式：list[0].属性
5. **请求参数中文乱码的解决** :在web.xml中配置Spring提供的过滤器类
```xml
characterEncodingFilter
org.springframework.web.filter.CharacterEncodingFilter
encoding
UTF-8
characterEncodingFilter
/*
username:String;password:String;money:Double
* 请求的连接：通过form提交post请求
*
*
*
*
*
*
*/
@RequestMapping("/saveAccount")
public String saveAccount(Account account) {
System.out.println(account.toString());
return "success";
}
/**
* 3.JavaBean中含有User类型的参数的参数绑定
* account:Account->username:String;password:String;money:Double;user:User
* user:User->uname:String;age:String
* 请求的连接：通过form提交post请求
*
*
*
*
*
*
*
*
*/
@RequestMapping("/saveAccount")
public String saveAccount(Account account) {
System.out.println(account.toString());
return "success";
}
/**
* 4.集合数组的参数绑定
* account:Account->username:String;password:String;money:Double;user:User
* list:List;map:Map
* 请求的连接：通过form提交post请求
*
*
*
*
*
*
*
*
*
*
*/
```
# 四、自定义类型转换器解决日期格式转换的错误
由于页面提交的数据全都是字符串的形式但SpringMVC内部自动的将字符串类型的数据进行了转换，大多数的类型都帮助转换好了，但还有可能存在问题：
默认转换的日期格式：2020/3/28 但你想要的是2020-3-28这个时候就需要自定义类型转换器
1.定义一个类、实现接口Converter S:源类型 T:目标类型
```java
/**
* 把字符串转换成日期的转换器
*/
public class StringToDateConverter implements Converter{
/**
* String source 传入进来的字符串
*/
public Date convert(String source) {
// 判断
if(source == null) {
throw new RuntimeException("参数不能为空");
}
try {
DateFormat df = new SimpleDateFormat("yyyy-MM-dd");
// 解析字符串
Date date = df.parse(source);
return date;
} catch (Exception e) {
throw new RuntimeException("类型转换错误");
}
}
}
```
2.在springMVC的配置文件中配置自定义类型转换器
```xml
```
3.让自定义的类型转换器生效
```xml
```
# 五、@RequestParam
1.作用：把请求中指定名称的参数给控制器中的形参赋值(当形参于参数名不同时使用)。
2.位置：在方法的参数类型前
3.参数：
1. value：请求参数中的名称。
2. required：请求参数中是否必须提供此参数。默认值：true。表示必须提供，如果不提供将报错。
# 六、@RequestBody
1.作用：用于获取请求体内容。直接使用得到是 key=value&key=value...结构的数据,get 请求方式不适用。 **用于异步请求的json数据获取**
2.位置：在方法的参数类型前
3.参数：
1. required：是否必须有请求体。默认值是:true。当取值为 true 时,get 请求方式会报错。如果取值为 false，get 请求得到是 null。
# 七、@PathVariable和RESTful风格
- **@PathVariable**
1.作用：于@RequestMapping("/test/{id}")联合使用，用于获取RequestMapping中的sid的值;用于绑定 url 中的占位符。例如：请求 url 中 https://img.qb5200.com/download-x/delete/**{id}**，这个**{id}**就是 url 占位符。 **@PathVariable(name="id")**
**url:test/10**
2.位置：在方法的参数类型前
3.参数：
1. value：用于指定 url 中占位符名称。
2. required：是否必须提供占位符。
- **什么是 rest：**
REST（英文：Representational State Transfer，简称 REST）描述了一个架构样式的网络系统，比如 web 应用程序。它首次出现在 2000 年 Roy Fielding 的博士论文中，他是 HTTP 规范的主要编写者之 一。在目前主流的三种 Web 服务交互方案中，REST 相比于 SOAP（Simple Object Access protocol，简单 对象访问协议）以及 XML-RPC 更加简单明了，无论是对 URL 的处理还是对 Payload 的编码，REST 都倾向于用更加简单轻量的方法设计和实现。值得注意的是 REST 并没有一个明确的标准，而更像是一种设计的风格。它本身并没有什么实用性，其核心价值在于如何设计出符合 REST 风格的网络接口。
- **restful** **的优点**
它结构清晰、符合标准、易于理解、扩展方便，所以正得到越来越多网站的采用。
- **restful** **的特性：**
**资源**（**Resources**）：网络上的一个实体，或者说是网络上的一个具体信息。
它可以是一段文本、一张图片、一首歌曲、一种服务，总之就是一个具体的存在。可以用一个 URI（统一 资源定位符）指向它，每种资源对应一个特定的 URI 。要 获取这个资源，访问它的 URI 就可以，因此 **URI** 即为每一个资源的独一无二的识别符。
**表现层**（**Representation**）：把资源具体呈现出来的形式，叫做它的表现层。
比如，文本可以用 txt 格式表现，也可以用 HTML 格式、XML 格式、JSON 格式表现，甚至可以采用二进制格式。
**状态转化**（**State Transfer**）：每 发出一个请求，就代表了客户端和服务器的一次交互过程。 HTTP 协议，是一个无状态协议，即所有的状态都保存在服务器端。因此，如果客户端想要操作服务器，必须通过某种手段，让服务器端发生**“**状态转化**”**（**State Transfer**）。而这种转化是建立在表现层之上的，所以 就是 **“**表现层状态转化**”**。具体说，就是 **HTTP** 协议里面，四个表示操作方式的动词：**GET** 、**POST** 、**PUT**、**DELETE**。它们分别对应四种基本操作：**GET** 用来获取资源，**POST** 用来新建资源，**PUT** 用来更新资源，**DELETE** 用来 删除资源。
- **restful** **的示例：**
/account/1 HTTP **GET** ： 得到 id = 1 的 account
/account/1 HTTP **DELETE**： 删除 id = 1 的 account
/account/1 HTTP **PUT**： 更新 id = 1 的 account
# 八、@RequestHeader
1.作用：用于获取请求消息头。
2.位置：在方法的参数类型前
3.参数：
1. value：获取消息头名称
2. required：是否必须有此消息头
# 九、@CookieValue
1.作用：用于把指定 cookie 名称的值传入控制器方法参数。
2.位置：在方法的参数类型前
3.参数：
1. value：指定 cookie 的名称。
2. required：是否必须有此 cookie。
# 十、@ModelAttribute
1.作用：它可以用于修饰方法和参数。出现在方法上，表示当前方法会在控制器的方法执行之前，先执行。它可以修饰没有返回值的方法，也可以修饰有具体返回值的方法。出现在参数上，获取指定的数据给参数赋值。
3.参数：
1. value：用于获取数据的 key。key 可以是 POJO 的属性名称，也可以是 map 结构的 key
# 十一、@SessionAttribute
1.作用：用于将值存入session域中。
2.位置：在类上
3.参数：
1. value：用于指定存入的属性名称
2. type：用于指定存入的数据类型。
4.其他：
1. Model类，将值存入request域中
2. ModelMap类，可以从域中取值，包括session
3. sessionStatus.setComplete();用于删除session中的内容
