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"> 
        <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/> 
        </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中的内容