SpringMVC最详细笔记partⅠ

一、springMVC-quickStar

• 解决maven加载项目过慢

archetypeCatalog
internal

• 导入依赖

<!-- 版本锁定 -->
<properties>
    <spring.version>5.0.2.RELEASE</spring.version>
</properties> 

<dependencies>
    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-context</artifactId>
        <version>${spring.version}</version>
    </dependency> 

    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-web</artifactId>
        <version>${spring.version}</version>
    </dependency> 

    <dependency>
        <groupId>org.springframework</groupId>
        <artifactId>spring-webmvc</artifactId>
        <version>${spring.version}</version>
    </dependency> 

    <dependency>
        <groupId>javax.servlet</groupId>
        <artifactId>servlet-api</artifactId>
        <version>2.5</version>
        <scope>provided</scope>
    </dependency> 

    <dependency>
        <groupId>javax.servlet.jsp</groupId>
        <artifactId>jsp-api</artifactId>
        <version>2.0</version>
        <scope>provided</scope>
    </dependency>
</dependencies>

• web.xml配置

<!-- SpringMVC的核心控制器 -->
<servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 配置Servlet的初始化参数，读取springmvc的配置文件，创建spring容器 -->
    <init-param>
		<param-name>contextConfigLocation</param-name>
        <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <!-- 配置servlet启动时加载对象 -->
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping

• springMVC的配置文件

<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/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">
    <!-- 配置spring创建容器时要扫描的包 -->
    <context:component-scan base-package="club.leyvan"/>

    <!-- 配置视图解析器 -->
    <bean id="viewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"></property>
        <property name="suffix" value=".jsp"></property>
    </bean>

    <!-- 配置spring开启注解mvc的支持 -->
    <mvc:annotation-driven></mvc:annotation-driven>
</beans>

在 SpringMVC 的各个组件中，处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。 使 用 < mvc:annotation-driven> 自动加载 RequestMappingHandlerMapping （处理映射器） 和 RequestMappingHandlerAdapter （ 处 理 适 配 器 ） ， 可 用 在 SpringMVC.xml 配 置 文 件 中 使 用 < mvc:annotation-driven>替代注解处理器和适配器的配置。

• 创建控制器类

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提供的过滤器类

      <!-- 配置过滤器，解决中文乱码的问题 -->
      <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
      

• 不同类型参数绑定的举例：

  /**
   * 1.基本类型和字符串的参数绑定
   * 请求的连接：testParam?username=hehe&password=123
   * 输出结果:username：hehe
   *         password: 123
   */
  
  @RequestMapping("/testParam")
  public String testParam(String username,String password) {
      System.out.println("username:"+username);
      System.out.println("password:"+password);
      return "success";
  }
  
  /**
   * 2.JavaBean的参数绑定
   * account:Account->username:String;password:String;money:Double
   * 请求的连接：通过form提交post请求
   *			<form action="param/saveAccount" metohd="post">
   *				<input type="text" name="username"/>
   * 				<input type="password" name="password"/>
   * 				<input type="text" name="money"/>
   * 				<input type="submit" value="提交"/>
   *			</form>
   */
  
  @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请求
   *			<form action="param/saveAccount" metohd="post">
   *				<input type="text" name="username"/>
   * 				<input type="password" name="password"/>
   * 				<input type="text" name="money"/>
   * 				<input type="text" name="user.uname"/>
   * 				<input type="text" name="user.age"/>
   * 				<input type="submit" value="提交"/>
   *			</form>
   */
  
  @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<User>;map:Map<String,User>
   * 请求的连接：通过form提交post请求
   *			<form action="param/saveAccount" metohd="post">
   *				<input type="text" name="username"/>
   * 				<input type="password" name="password"/>
   * 				<input type="text" name="money"/>
   * 				<input type="text" name="list[0].uname"/>
   * 				<input type="text" name="list[0].age"/>
   * 				<input type="text" name="map['随便'].uname"/>
   * 				<input type="text" name="map['随便']user.age"/>
   * 				<input type="submit" value="提交"/>
   *			</form>
   */
  
  

四、自定义类型转换器解决日期格式转换的错误

由于页面提交的数据全都是字符串的形式但SpringMVC内部自动的将字符串类型的数据进行了转换，大多数的类型都帮助转换好了，但还有可能存在问题：

默认转换的日期格式：2020/3/28 但你想要的是2020-3-28这个时候就需要自定义类型转换器

1.定义一个类、实现接口Converter<S,T> S:源类型 T:目标类型

/**
 * 把字符串转换成日期的转换器
 */
public class StringToDateConverter implements Converter<String, Date>{
    /**
     * 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的配置文件中配置自定义类型转换器

<!-- 注册自定义类型转换器 -->
<bean id="conversionService"class="org.springframework.context.support.ConversionServiceFactoryBean">
    <property name="converters">
        <set>
            <bean class="cn.itcast.utils.StringToDateConverter"/>
        </set>
    </property>
</bean>

3.让自定义的类型转换器生效

<!-- 开启Spring对MVC注解的支持 -->
<mvc:annotation-driven conversion-service="conversionService"/>

五、@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 中 /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中的内容