Spring MVC之——入门程序、请求参数绑定、其他常用注解

SpringMVC 的基本概念

三层架构

我们的开发架构一般都是基于两种形式,一种是 C/S 架构,也就是客户端/服务器,另一种是 B/S 架构,也就
是浏览器服务器。在 JavaEE 开发中,几乎全都是基于 B/S 架构的开发。那么在 B/S 架构中,系统标准的三层架构
包括:表现层、业务层、持久层。三层架构在我们的实际开发中使用的非常多

  • 表现层:

    也就是我们常说的web层。它负责接收客户端请求,向客户端响应结果,通常客户端使用http协议请求
    web 层,web 需要接收 http 请求,完成 http 响应。
    表现层包括展示层和控制层:控制层负责接收请求,展示层负责结果的展示。
    表现层依赖业务层,接收到客户端请求一般会调用业务层进行业务处理,并将处理结果响应给客户端。
    表现层的设计一般都使用 MVC 模型。(MVC 是表现层的设计模型,和其他层没有关系)

  • 业务层:

    也就是我们常说的 service 层。它负责业务逻辑处理,和我们开发项目的需求息息相关。web 层依赖业
    务层,但是业务层不依赖 web 层。
    业务层在业务处理时可能会依赖持久层,如果要对数据持久化需要保证事务一致性。(也就是我们说的,
    事务应该放到业务层来控制)

  • 持久层:

    也就是我们是常说的 dao 层。负责数据持久化,包括数据层即数据库和数据访问层,数据库是对数据进
    行持久化的载体,数据访问层是业务层和持久层交互的接口,业务层需要通过数据访问层将数据持久化到数据库
    中。通俗的讲,持久层就是和数据库交互,对数据库表进行曾删改查的。

MVC 模型

MVC 全名是 Model View Controller,是模型(model)-视图(view)-控制器(controller)的缩写,
是一种用于设计创建 Web 应用程序表现层的模式。MVC 中每个部分各司其职:

  • Model(模型):

    通常指的就是我们的数据模型。作用一般情况下用于封装数据。

  • View(视图):

    通常指的就是我们的 jsp 或者 html。作用一般就是展示数据的。
    通常视图是依据模型数据创建的。

  • Controller(控制器):

    是应用程序中处理用户交互的部分。作用一般就是处理程序逻辑的。
    它相对于前两个不是很好理解,这里举个例子:

    例如:
    我们要保存一个用户的信息,该用户信息中包含了姓名,性别,年龄等等。
    这时候表单输入要求年龄必须是 1~100 之间的整数。姓名和性别不能为空。并且把数据填充到模型之中。
    此时除了 js 的校验之外,服务器端也应该有数据准确性的校验,那么校验就是控制器的该做的。
    当校验失败后,由控制器负责把错误页面展示给使用者。
    如果校验成功,也是控制器负责把数据填充到模型,并且调用业务层实现完整的业务需求。

SpringMVC 是什么

SpringMVC 是一种基于 Java 的实现 MVC 设计模型的请求驱动类型的轻量级 Web 框架,属于 Spring
FrameWork 的后续产品,已经融合在 Spring Web Flow 里面。Spring 框架提供了构建 Web 应用程序的全功
能 MVC 模块。使用 Spring 可插入的 MVC 架构,从而在使用 Spring 进行 WEB 开发时,可以选择使用 Spring
的 Spring MVC 框架或集成其他 MVC 开发框架,如 Struts1(现在一般不用),Struts2 等。
SpringMVC 已经成为目前最主流的 MVC 框架之一,并且随着 Spring3.0 的发布,全面超越 Struts2,成
为最优秀的 MVC 框架。
它通过一套注解,让一个简单的 Java 类成为处理请求的控制器,而无须实现任何接口。同时它还支持
RESTful 编程风格的请求。

SpringMVC 在三层架构的位置

SpringMVC 在三层架构的位置

SpringMVC 的优势

  • 1、清晰的角色划分:
    • 前端控制器(DispatcherServlet)
    • 请求到处理器映射(HandlerMapping)
    • 处理器适配器(HandlerAdapter)
    • 视图解析器(ViewResolver)
    • 处理器或页面控制器(Controller)
    • 验证器( Validator)
    • 命令对象(Command 请求参数绑定到的对象就叫命令对象)
    • 表单对象(Form Object 提供给表单展示和提交到的对象就叫表单对象)。
  • 2、分工明确,而且扩展点相当灵活,可以很容易扩展,虽然几乎不需要。
  • 3、由于命令对象就是一个 POJO,无需继承框架特定 API,可以使用命令对象直接作为业务对象。
  • 4、和 Spring 其他框架无缝集成,是其它 Web 框架所不具备的。
  • 5、可适配,通过 HandlerAdapter 可以支持任意的类作为处理器。
  • 6、可定制性,HandlerMapping、ViewResolver 等能够非常简单的定制。
  • 7、功能强大的数据验证、格式化、绑定机制。
  • 8、利用 Spring 提供的 Mock 对象能够非常简单的进行 Web 层单元测试。
  • 9、本地化、主题的解析的支持,使我们更容易进行国际化和主题的切换。
  • 10、强大的 JSP 标签库,使 JSP 编写更容易。

………………还有比如RESTful风格的支持、简单的文件上传、约定大于配置的契约式编程支持、基于注解的零配
置支持等等。

SpringMVC 和 Struts2 的优略分析(面试)

  • 共同点:
    • 它们都是表现层框架,都是基于 MVC 模型编写的。
    • 它们的底层都离不开原始 ServletAPI。
    • 它们处理请求的机制都是一个核心控制器。
  • 区别:
    • Spring MVC 的入口是 Servlet, 而 Struts2 是 Filter
    • Spring MVC 是基于方法设计的,而 Struts2 是基于类,Struts2 每次执行都会创建一个动作类。所以 Spring MVC 会稍微比 Struts2 快些。
    • Spring MVC 使用更加简洁,同时还支持 JSR303, 处理 ajax 的请求更方便

(JSR303 是一套 JavaBean 参数校验的标准,它定义了很多常用的校验注解,我们可以直接将这些注
解加在我们 JavaBean 的属性上面,就可以在需要校验的时候进行校验了。)
Struts2 的 OGNL 表达式使页面的开发效率相比 Spring MVC 更高些,但执行效率并没有比 JSTL 提
升,尤其是 struts2 的表单标签,远没有 html 执行效率高。

SpringMVC 的入门程序

1、引入开发jar包

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
<!-- 版本锁定 -->
<properties>
<spring.version>5.0.2.RELEASE</spring.version>
</properties>

<dependencies>
<!-- Spring核心 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-context</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- Springmvc需要用到 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-web</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- Springmvc需要用到 -->
<dependency>
<groupId>org.springframework</groupId>
<artifactId>spring-webmvc</artifactId>
<version>${spring.version}</version>
</dependency>
<!-- servlet的jar包 -->
<dependency>
<groupId>javax.servlet</groupId>
<artifactId>servlet-api</artifactId>
<version>2.5</version>
<scope>provided</scope>
</dependency>
<!-- jsp需要用到的jar包 -->
<dependency>
<groupId>javax.servlet.jsp</groupId>
<artifactId>jsp-api</artifactId>
<version>2.0</version>
<scope>provided</scope>
</dependency>
</dependencies>

2、配置核心的控制器(在web.xml文件中配置核心控制器DispatcherServlet)

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
<!-- SpringMVC的核心控制器 -->
<servlet>
<servlet-name>dispatcherServlet</servlet-name>
<servlet-class>org.springframework.web.servlet.DispatcherServlet</servletclass>

<!-- 配置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>

注意:通过上面url-pattern的配置,所有URL请求都将被Spring MVC的DispatcherServlet截获,所以静态资源会访问不到,所以我们需要配置放行静态资源,一般用**<mvc:default-servlet-handler />**

在SpringMVC配置文件中配置了**<mvc:default-servlet-handler />后,会在Spring MVC上下文中定义一个org.springframework.web.servlet.resource.DefaultServletHttpRequestHandler**,它会像一个检查员,对进入DispatcherServlet的URL进行筛查,如果发现是静态资源的请求,就将该请求转由Web应用服务器默认的Servlet处理,如果不是静态资源的请求,才由DispatcherServlet继续处理。

一般Web应用服务器默认的Servlet名称是”default”,因此DefaultServletHttpRequestHandler可以找到它。如果你所有的Web应用服务器的默认Servlet名称不是”default”,则需要通过default-servlet-name属性显示指定:

<mvc:default-servlet-handler default-servlet-name="所使用的Web服务器默认使用的Servlet名称" />

3、编写springmvc.xml的配置文件

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
<?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/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="com.itheima"></context:component-scan>

<!-- 配置视图解析器 -->
<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>-->

<!-- 设置静态资源不过滤
location:元素表示webapp目录下的包下的所有文件
mapping:元素表示请求路径,**表示所有
-->
<mvc:resources location="/css/" mapping="/css/**"/> <!-- 样式 -->
<mvc:resources location="/images/" mapping="/images/**"/> <!-- 图片 -->
<mvc:resources location="/js/" mapping="/js/**"/> <!-- javascript -->

<!-- 这样设置静态资源不过滤更方便 -->
<mvc:default-servlet-handler />

</beans>

4、创建一个 jsp 用于发送请求

1
2
3
<a href="${pageContext.request.contextPath}/hello">SpringMVC 入门案例</a>
<br/>
<a href="hello">SpringMVC 入门案例</a>

5、HelloController控制器类

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
package cn.itcast.controller;
import org.springframework.stereotype.Controller;
import org.springframework.web.bind.annotation.RequestMapping;

/**
* 控制器
* @author rt
*/
@Controller
public class HelloController {

/**
* 接收请求
* @return
*/
@RequestMapping(path="/hello")
public String sayHello() {
System.out.println("Hello SpringMVC!!");
return "success";
}
}

6、在WEB-INF目录下创建pages文件夹,编写success.jsp的成功页面

1
2
3
<body>
<h3>入门成功!!</h3>
</body>

入门案例的执行过程分析

  1. 当启动Tomcat服务器的时候,因为配置了load-on-startup标签,所以会创建DispatcherServlet对象,就会加载springmvc.xml配置文件
  2. 开启了注解扫描,那么HelloController对象就会被创建
  3. 从index.jsp发送请求,请求会先到达DispatcherServlet核心控制器,根据配置@RequestMapping注解找到执行的具体方法
  4. 根据执行方法的返回值,再根据配置的视图解析器,去指定的目录下查找指定名称的JSP文件
  5. Tomcat服务器渲染页面,做出响应

SpringMVC 执行过程

图中各组件的作用

DispatcherServlet:前端控制器

用户请求到达前端控制器,它就相当于 mvc 模式中的 c,dispatcherServlet 是整个流程控制的中心,由
它调用其它组件处理用户的请求,dispatcherServlet 的存在降低了组件之间的耦合性。

HandlerMapping:处理器映射器

HandlerMapping 负责根据用户请求找到 Handler 即处理器,SpringMVC 提供了不同的映射器实现不同的
映射方式,例如:配置文件方式,实现接口方式,注解方式等。

Handler:处理器

它就是我们开发中要编写的具体业务控制器。由 DispatcherServlet 把用户请求转发到 Handler。由
Handler 对具体的用户请求进行处理。

HandlAdapter:处理器适配器

通过 HandlerAdapter 对处理器进行执行,这是适配器模式的应用,通过扩展适配器可以对更多类型的处理
器进行执行。

View Resolver:视图解析器

View Resolver 负责将处理结果生成 View 视图,View Resolver 首先根据逻辑视图名解析成物理视图名
即具体的页面地址,再生成 View 视图对象,最后对 View 进行渲染将处理结果通过页面展示给用户。

View:视图

SpringMVC 框架提供了很多的 View 视图类型的支持,包括:jstlView、freemarkerView、pdfView
等。我们最常用的视图就是 jsp。
一般情况下需要通过页面标签或页面模版技术将模型数据通过页面展示给用户,需要由程序员根据业务需求开
发具体的页面。

RequestMapping 注解

作用:用于建立请求 URL 和处理请求方法之间的对应关系。

出现位置:

  • 类上:

    请求 URL 的第一级访问目录。此处不写的话,就相当于应用的根目录。写的话需要以/开头。
    它出现的目的是为了使我们的 URL 可以按照模块化管理:

    • 例如:
      • 账户模块:
        • /account/add
        • /account/update
        • /account/delete
      • 订单模块:
        • /order/add
        • /order/update
        • /order/delete

account和order部分就是把 RequsetMappding 写在类上,使我们的 URL 更加精细。

  • 方法上:请求 URL 的第二级访问目录。

属性:

  • value:用于指定请求的 URL。它和 path 属性的作用是一样的。
  • method:用于指定请求的方式。
  • params:用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的 key 和 value 必须和配置的一模一样。
  • 例如:
    • params = {"accountName"},表示请求参数必须有 accountName
    • params = {"moeny!100"},表示请求参数中 money 不能是 100。
    • headers:用于指定限制请求消息头的条件。
  • headers:用于指定限制请求消息头的条件(发送的请求中必须包含的请求头,例如抓包后看到的:Accept)。
  • 注意:以上四个属性只要出现 2 个或以上时,他们的关系是的关系。

使用示例

出现位置的示例

  • 控制器代码:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    /**
    * RequestMapping 注解出现的位置
    */
    @Controller("accountController")
    @RequestMapping("/account")
    public class AccountController {

    @RequestMapping("/findAccount")
    public String findAccount() {
    System.out.println("查询了账户。。。。");
    return "success";
    }
    }
  • jsp 中的代码:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    <%@ page language="java" contentType="text/html; charset=UTF-8"
    pageEncoding="UTF-8"%>
    <!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN"
    "http://www.w3.org/TR/html4/loose.dtd">
    <html>
    <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
    <title>requestmapping 的使用</title>
    </head>
    <body>
    <!-- 第一种访问方式 -->
    <a href="${pageContext.request.contextPath}/account/findAccount">
    查询账户
    </a>
    <br/>
    <!-- 第二种访问方式 -->
    <a href="account/findAccount">查询账户</a>
    </body>
    </html>

method 属性的示例

  • 控制器代码
    1
    2
    3
    4
    5
    6
    7
    8
    9
    /**
    * 保存账户
    * @return
    */
    @RequestMapping(value="/saveAccount",method=RequestMethod.POST)
    public String saveAccount() {
    System.out.println("保存了账户");
    return "success";
    }
  • jsp 代码:
    1
    2
    3
    4
    5
    6
    <!-- 请求方式的示例 -->
    <a href="account/saveAccount">保存账户,get 请求</a>
    <br/>
    <form action="account/saveAccount" method="post">
    <input type="submit" value="保存账户,post 请求">
    </form>
  • 结果:当使用 get 请求时,提示错误信息是 405,信息是方法不支持 get 方式请求

请求参数的绑定

绑定的机制

我们都知道,表单中请求参数都是基于 key=value 的。
SpringMVC 绑定请求参数的过程是通过把表单提交请求参数,作为控制器中方法参数进行绑定的。
例如:参数是:accountId=10

1
<a href="account/findAccount?accountId=10">查询账户</a>
1
2
3
4
5
6
7
8
9
10
/**
* 查询账户
* @return
*/
@RequestMapping("/findAccount")
public String findAccount(Integer accountId) {
//accountId的值为10
System.out.println(accountId);
return "success";
}

其中方法参数对应着请求参数的key,也就是accountId,这两者必须一样

支持的数据类型

  • 基本类型参数:包括基本类型和 String 类型
  • POJO 类型参数:包括实体类,以及关联的实体类
  • 数组和集合类型参数:包括 List 结构和 Map 结构的集合(包括数组)

SpringMVC 绑定请求参数是自动实现的,但是要想使用,必须遵循使用要求。

使用要求

  • 如果是基本类型或者 String 类型:

    要求我们的参数名称必须和控制器中方法的形参名称保持一致。(严格区分大小写)
    例子如上

  • 如果是 POJO 类型,或者它的关联对象:

    要求表单中参数名称和 POJO 类的属性名称保持一致。并且控制器方法的参数类型是 POJO 类型。
    例子:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    26
    js文件

    <!-- pojo 类型演示 -->
    <form action="account/saveAccount" method="post">
    账户名称:<input type="text" name="name" ><br/>
    账户金额:<input type="text" name="money" ><br/>
    账户省份:<input type="text" name="address.provinceName" ><br/>
    账户城市:<input type="text" name="address.cityName" ><br/>
    <input type="submit" value="保存">
    </form>



    控制器代码

    /**
    * 保存账户
    * @param account
    * @return
    */
    @RequestMapping("/saveAccount")
    public String saveAccount(Account account) {
    System.out.println("保存了账户。。。。"+account);
    return "success";
    }

  • 如果是集合类型,有两种方式:
    • 第一种:

      要求集合类型的请求参数必须在 POJO 中。在表单中请求参数名称要和 POJO 中集合属性名称相同。
      给 List 集合中的元素赋值,使用下标。
      给 Map 集合中的元素赋值,使用键值对。
      例子:

      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      40
      41
      42
      43
      44
      45
      46
      47
      48
      49
      50
      51
      52
      53
      54
      55
      56
      57
      实体类代码:
      /**
      * 用户实体类
      */
      public class User implements Serializable {
      private String username;
      private String password;
      private Integer age;
      private List<Account> accounts;
      private Map<String,Account> accountMap;
      //getters and setters
      @Override
      public String toString() {
      return "User [username=" + username + ", password=" + password + ", age="
      + age + ",\n accounts=" + accounts
      + ",\n accountMap=" + accountMap + "]";
      + }
      }





      jsp 代码:
      <!-- POJO 类包含集合类型演示 -->
      <form action="account/updateAccount" method="post">
      用户名称:<input type="text" name="username" ><br/>
      用户密码:<input type="password" name="password" ><br/>
      用户年龄:<input type="text" name="age" ><br/>
      账户 1 名称:<input type="text" name="accounts[0].name" ><br/>
      账户 1 金额:<input type="text" name="accounts[0].money" ><br/>
      账户 2 名称:<input type="text" name="accounts[1].name" ><br/>
      账户 2 金额:<input type="text" name="accounts[1].money" ><br/>
      账户 3 名称:<input type="text" name="accountMap['one'].name" ><br/>
      账户 3 金额:<input type="text" name="accountMap['one'].money" ><br/>
      账户 4 名称:<input type="text" name="accountMap['two'].name" ><br/>
      账户 4 金额:<input type="text" name="accountMap['two'].money" ><br/>
      <input type="submit" value="保存">
      </form>







      控制器代码:
      /**
      * 更新账户
      * @return
      */
      @RequestMapping("/updateAccount")
      public String updateAccount(User user) {
      System.out.println("更新了账户。。。。"+user);
      return "success";
      }

    • 第二种:

      接收的请求参数是 json 格式数据。需要借助一个注解实现。

  • 注意:它还可以实现一些数据类型自动转换。内置转换器全都在:org.springframework.core.convert.support 包下
  • 如遇特殊类型转换要求,需要我们自己编写自定义类型转换器

请求参数乱码问题(中文乱码)

post 请求方式

在 web.xml 中配置一个过滤器

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
<!-- 配置 springMVC 编码过滤器 -->
<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>

在 springmvc 的配置文件中可以配置,静态资源不过滤

1
2
3
4
<!-- location 表示路径,mapping 表示文件,**表示该目录下的文件以及子目录的文件 -->
<mvc:resources location="/css/" mapping="/css/**"/>
<mvc:resources location="/images/" mapping="/images/**"/>
<mvc:resources location="/scripts/" mapping="/javascript/**"/>

get 请求方式

tomacat 对 GET 和 POST 请求处理方式是不同的,GET 请求的编码问题,要改 tomcat 的 server.xml配置文件,如下:

1
2
<Connector connectionTimeout="20000" port="8080"
protocol="HTTP/1.1" redirectPort="8443"/>

改为:

1
2
3
<Connector connectionTimeout="20000" port="8080"
protocol="HTTP/1.1" redirectPort="8443"
useBodyEncodingForURI="true"/>

如果遇到 ajax 请求仍然乱码,请把:useBodyEncodingForURI="true"改为 URIEncoding="UTF-8"即可

自定义类型转换器

当我们再控制器方法上传入的参数定义为Date,并且传入一个日期时,如果传入例如:2000/1/1 时SpringMVC框架可以自动转换成功,但如果传入2000-1-1 时SpringMVC框架就会类型转换出错,因为SpringMVC没有内置一个这样的转换机制,这样我们就需要自定义转换器了。

  • 第一步:

    定义一个类,实现 Converter 接口,该接口有两个泛型。public interface Converter<S, T> //S:表示接受的类型,T:表示目标类型
    例子:

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    13
    14
    15
    16
    17
    18
    19
    20
    21
    22
    23
    24
    25
    /**
    * 自定义类型转换器
    * @author 黑马程序员
    * @Company http://www.ithiema.com
    * @Version 1.0
    */
    public class StringToDateConverter implements Converter<String, Date> {
    /**
    * 用于把 String 类型转成日期类型
    */
    @Override
    public Date convert(String source) {
    DateFormat format = null;
    try {
    if(StringUtils.isEmpty(source)) {
    throw new NullPointerException("请输入要转换的日期");
    }
    format = new SimpleDateFormat("yyyy-MM-dd");
    Date date = format.parse(source);
    return date;
    } catch (Exception e) {
    throw new RuntimeException("输入日期有误");
    }
    }
    }
  • 第二步:在 spring 配置文件中配置类型转换器

    spring 配置类型转换器的机制是,将自定义的转换器注册到类型转换服务中去

    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    <!-- 配置类型转换器工厂 -->
    <bean id="converterService" class="org.springframework.context.support.ConversionServiceFactoryBean">
    <!-- 给工厂注入一个新的类型转换器 -->
    <property name="converters">
    <array>
    <!-- 配置自定义类型转换器 -->
    <bean class="com.itheima.web.converter.StringToDateConverter"></bean>
    </array>
    </property>
    </bean>

  • 第三步:在 annotation-driven 标签中引用配置的类型转换服务
    1
    2
    <!-- 引用自定义类型转换器 -->
    <mvc:annotation-driven conversion-service="converterService"></mvc:annotation-driven>

使用 ServletAPI 对象作为方法参数

SpringMVC 还支持使用原始 ServletAPI 对象作为控制器方法的参数。支持原始 ServletAPI 对象有:

  • HttpServletRequest
  • HttpServletResponse
  • HttpSession
  • java.security.Principal
  • Locale
  • InputStream
  • OutputStream
  • Reader
  • Writer

我们可以把上述对象,直接写在控制的方法参数中使用。

  • jsp 代码:
    1
    2
    <!-- 原始 ServletAPI 作为控制器参数 -->
    <a href="account/testServletAPI">测试访问 ServletAPI</a
  • 控制器中的代码:
    1
    2
    3
    4
    5
    6
    7
    8
    9
    10
    11
    12
    /**
    * 测试访问 testServletAPI
    * * @return
    */
    @RequestMapping("/testServletAPI")
    public String testServletAPI(HttpServletRequest request, HttpServletResponse response, HttpSession session) {
    System.out.println(request);
    System.out.println(response);
    System.out.println(session);
    return "success";
    }

常用注解

RequestParam

  • 作用:把请求中指定名称的参数给控制器中的形参赋值。
  • 属性:
    • value:请求参数中的名称。
    • required:请求参数中是否必须提供此参数。默认值:true。表示必须提供,如果不提供将报错。
  • 使用示例
    • jsp 中的代码:
      1
      2
      <!-- requestParams 注解的使用 -->
      <a href="springmvc/useRequestParam?name=test">requestParam 注解</a>
    • 控制器中的代码:
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      /**
      * requestParams 注解的使用
      * @param username
      * @return
      */
      @RequestMapping("/useRequestParam")
      public String useRequestParam(@RequestParam("name")String username, @RequestParam(value="age",required=false)Integer age){
      System.out.println(username+","+age);
      return "success";
      }

RequestBody

  • 作用:用于获取请求体内容。直接使用得到是 key=value&key=value…结构的数据。get 请求方式不适用。
  • 属性:
    • required:是否必须有请求体。默认值是:true。当取值为 true 时,get 请求方式会报错。如果取值为 false,get 请求得到是 null。
  • 使用示例:
    • post 请求 jsp 代码:
      1
      2
      3
      4
      5
      6
      7
      <!-- request body 注解 -->
      <form action="springmvc/useRequestBody" method="post">
      用户名称:<input type="text" name="username" ><br/>
      用户密码:<input type="password" name="password" ><br/>
      用户年龄:<input type="text" name="age" ><br/>
      <input type="submit" value="保存">
      </form>
    • get 请求 jsp 代码:
      1
      <a href="springmvc/useRequestBody?body=test">requestBody 注解 get 请求</a>
    • 控制器代码:
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      /**
      * RequestBody 注解
      * @param user
      * @return
      */
      @RequestMapping("/useRequestBody")
      public String useRequestBody(@RequestBody(required=false) String body){
      System.out.println(body);
      return "success";
      }

PathVaribale

  • 作用:

    用于绑定 url 中的占位符。例如:请求 url 中 /delete/{id},这个{id}就是 url 占位符。
    url 支持占位符是 spring3.0 之后加入的。是 springmvc 支持 rest 风格 URL 的一个重要标志。

  • 属性:
    • value:用于指定 url 中占位符名称。
    • required:是否必须提供占位符。
  • 使用示例:
    • jsp 代码:
      1
      2
      <!-- PathVariable 注解 -->
      <a href="springmvc/usePathVariable/100">pathVariable 注解</a>
    • 控制器代码:
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      /**
      * PathVariable 注解
      * @param user
      * @return
      */
      @RequestMapping("/usePathVariable/{id}")
      public String usePathVariable(@PathVariable("id") Integer id){
      System.out.println(id);
      return "success";
      }

REST 风格 URL

  • 什么是 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):
    把资源具体呈现出来的形式,叫做它的表现层 (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
    • /account HTTP POST: 新增 account

RequestHeader

  • 作用:用于获取请求消息头。
  • 属性:
    • value:提供消息头名称
    • required:是否必须有此消息头
  • 注:在实际开发中一般不怎么用。
  • 使用示例:
    • jsp 中代码:
      1
      2
      <!-- RequestHeader 注解 -->
      <a href="springmvc/useRequestHeader">获取请求消息头</a>
    • 控制器中代码:
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      /**
      * RequestHeader 注解
      * @param user
      * @return
      */
      @RequestMapping("/useRequestHeader")
      public String useRequestHeader(@RequestHeader(value="Accept-Language",
      required=false)String requestHeader){
      System.out.println(requestHeader);
      return "success";
      }

CookieValue

  • 作用:用于把指定 cookie 名称的值传入控制器方法参数。
  • 属性:
    • value:指定 cookie 的名称。
    • required:是否必须有此 cookie。
  • 使用示例:
    • jsp 中的代码:
      1
      2
      <!-- CookieValue 注解 -->
      <a href="springmvc/useCookieValue">绑定 cookie 的值</a>
    • 控制器中的代码:
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      /**
      * Cookie 注解注解
      * @param user
      * @return
      */
      @RequestMapping("/useCookieValue")
      public String useCookieValue(@CookieValue(value="JSESSIONID",required=false)
      String cookieValue){
      System.out.println(cookieValue);
      return "success";
      }

ModelAttribute

  • 作用:

    该注解是 SpringMVC4.3 版本以后新加入的。它可以用于修饰方法和参数。
    出现在方法上,表示当前方法会在控制器的方法执行之前,先执行。它可以修饰没有返回值的方法,也可
    以修饰有具体返回值的方法。
    出现在参数上,获取指定的数据给参数赋值。

  • 属性:
    • value:用于获取数据的 key。key 可以是 POJO 的属性名称,也可以是 map 结构的 key。
  • 应用场景:

    当表单提交数据不是完整的实体类数据时,保证没有提交数据的字段使用数据库对象原来的数据。

  • 例如:

    我们在编辑一个用户时,用户有一个创建信息字段,该字段的值是不允许被修改的。在提交表单数
    据时肯定没有此字段的内容,一旦更新会把该字段内容置为 null,此时就可以使用此注解解决问题。

  • 基于 POJO 属性的基本使用
    • jps 代码:
      1
      2
      <!-- ModelAttribute 注解的基本使用 -->
      <a href="springmvc/testModelAttribute?username=test">测试 modelattribute</a>
    • 控制器代码:
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      /**
      * 被 ModelAttribute 修饰的方法
      * @param user
      */
      @ModelAttribute
      public void showModel(User user) {
      System.out.println("执行了 showModel 方法"+user.getUsername());
      }


      /**
      * 接收请求的方法
      * @param user
      * @return
      */
      @RequestMapping("/testModelAttribute")
      public String testModelAttribute(User user) {
      System.out.println("执行了控制器的方法"+user.getUsername());
      return "success";
      }
    • 注意:showModel方法的返回值传入了testModelAttribute方法的参数中,因此可以用于从数据库中补齐数据
  • 基于 Map 的应用场景:ModelAttribute 修饰方法不带返回值
    • 需求:修改用户信息,要求用户的密码不能修改
    • jsp 中的代码:
      1
      2
      3
      4
      5
      6
      <!-- 修改用户信息 -->
      <form action="springmvc/updateUser" method="post">
      用户名称:<input type="text" name="username" ><br/>
      用户年龄:<input type="text" name="age" ><br/>
      <input type="submit" value="保存">
      </form>
    • 控制器中的代码:
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      /**
      * 查询数据库中用户信息
      * @param user
      */
      @ModelAttribute
      public void showModel(String username,Map<String,User> map) {
      //模拟去数据库查询
      User user = findUserByName(username);
      System.out.println("执行了 showModel 方法"+user);
      map.put("abc",user);
      }


      /**
      * 模拟修改用户方法
      * @param user
      * @return
      */
      @RequestMapping("/updateUser")
      public String testModelAttribute(@ModelAttribute("abc")User user) {
      System.out.println("控制器中处理请求的方法:修改用户:"+user);
      return "success";
      }


      /**
      * 模拟去数据库查询
      * @param username
      * @return
      */
      private User findUserByName(String username) {
      User user = new User();
      user.setUsername(username);
      user.setAge(19);
      user.setPassword("123456");
      return user;
      }

SessionAttribute

  • 作用:用于多次执行控制器方法间的参数共享。
  • 属性:
    • value:用于指定存入的属性名称
    • type:用于指定存入的数据类型。
  • 使用示例
    • jsp 中的代码:
      1
      2
      3
      4
      5
      6
      <!-- SessionAttribute 注解的使用 -->
      <a href="springmvc/testPut">存入 SessionAttribute</a>
      <hr/>
      <a href="springmvc/testGet">取出 SessionAttribute</a>
      <hr/>
      <a href="springmvc/testClean">清除 SessionAttribute</a>
    • 控制器中的代码:
      1
      2
      3
      4
      5
      6
      7
      8
      9
      10
      11
      12
      13
      14
      15
      16
      17
      18
      19
      20
      21
      22
      23
      24
      25
      26
      27
      28
      29
      30
      31
      32
      33
      34
      35
      36
      37
      38
      39
      /**
      * SessionAttribute 注解的使用
      */
      @Controller("sessionAttributeController")
      @RequestMapping("/springmvc")
      @SessionAttributes(value ={"username","password"},types={Integer.class})
      public class SessionAttributeController {
      /**
      * 把数据存入 SessionAttribute
      * @param model
      * @return
      * Model 是 spring 提供的一个接口,该接口有一个实现类 ExtendedModelMap
      * 该类继承了 ModelMap,而 ModelMap 就是 LinkedHashMap 子类
      * 它其实就是一个map集合,底层会把集合数据保存到请求对象Request中
      * @SessionAttributes注解则会把数据同时存到session中
      */
      @RequestMapping("/testPut")
      public String testPut(Model model){
      model.addAttribute("username", "泰斯特");
      model.addAttribute("password","123456");
      model.addAttribute("age", 31);
      //跳转之前将数据保存到 username、password 和 age 中,因为注解@SessionAttribute 中有
      这几个参数
      return "success";
      }

      @RequestMapping("/testGet")
      public String testGet(ModelMap model){

      System.out.println(model.get("username")+";"+model.get("password")+";"+model.get("age"));
      return "success";
      }

      @RequestMapping("/testClean")
      public String complete(SessionStatus sessionStatus){
      sessionStatus.setComplete();
      return "success";
      }
      }