SpringMVC01----请求匹配、参数绑定、常用注解

最新推荐文章于 2022-11-25 09:47:46 发布

DarkADays

最新推荐文章于 2022-11-25 09:47:46 发布

阅读量615

点赞数

分类专栏： SpringMVC 文章标签： spring

本文链接：https://blog.csdn.net/LLturn/article/details/107617107

版权

SpringMVC 专栏收录该内容

3 篇文章 0 订阅

订阅专栏

1.SpringMVC基本概念

1.1关于三层架构和MVC

三层架构：
- 我们的开发架构一般都是基于两种形式，一种是 C/S架构，也就是客户端/服务器，另一种是 B/S架构，也就是浏览器服务器。在 JavaEE 开发中，几乎全都是基于 B/S 架构的开发。那么在 B/S 架构中，系统标准的三层架构包括：表现层、业务层、持久层
- 表现层：
  - 也就是我们常说的web层。它负责接收客户端请求，向客户端响应结果，通常客户端使用http协议请求web 层，web 需要接收 http 请求，完成 http 响应。它通常包括展示层和控制层：控制层负责接收请求，展示层负责结果的展示。 表现层的设计一般都使用MVC 模型。（MVC 是表现层的设计模型，和其他层没有关系）
- 业务层：
  - 也就是我们常说的 service 层。它负责业务逻辑处理，和我们开发项目的需求息息相关。
- 持久层：
  - 我们常说的dao层，负责数据的持久化，包括数据层即数据库和数据访问层。
MVC模型：
- MVC 全名是 Model View Controller，是模型(model)－视图(view)－控制器(controller)的缩写，是一种用于设计创建 Web 应用程序表现层的模式。MVC 中每个部分各司其职
- Model（模型）：
  - 数据模型，JavaBean的类，用来进行数据封装。
- View（视图）：
  - 通常指的就是我们的 jsp 或者 html。作用一般就是展示数据的。通常视图是依据模型数据创建的。
- Controller（控制器）：
  - 用来接收用户的请求，整个流程的控制器。比如Servlet。

1.2SpringMVC概述

SpringMVC 是一种基于 Java 的实现 MVC 设计模型的请求驱动类型的轻量级 Web 框架，属于 Spring FrameWork 的后续产品，已经融合在 Spring Web Flow 里面。Spring 框架提供了构建 Web 应用程序的全功能 MVC 模块。
SpringMVC通过一套注解，让一个简单的 Java 类成为处理请求的控制器，而无须实现任何接口。同时它还支持RESTful 编程风格的请求。
SpringMVC在三层架构中的位置：

2.SpringMVC入门

2.1SpringMVC的入门程序

1.创建一个WEB工程，引入开发所需要的jar包

<properties>
    <spring.version>5.0.5.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>

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

  <servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <init-param>
      <param-name>contextConfigLocation</param-name>
      <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <load-on-startup>1</load-on-startup>
  </servlet>
  <servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
  </servlet-mapping>

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

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       xmlns:mvc="http://www.springframework.org/schema/mvc"
       xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance"
       xmlns:context="http://www.springframework.org/schema/context"
       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.zut"></context:component-scan>

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

    <!-- 开启SpringMVC框架注解的支持 -->
    <mvc:annotation-driven conversion-service="conversionServiceFactoryBean"></mvc:annotation-driven>
</beans>

4.在 webapp 目录下创建 index.jsp

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>入门案例</title>
</head>
<body>
    <h3>入门案例</h3>
    <a href="hello">点击进入入门案例</a><hr/>
</body>
</html>

5.编写控制器，并且使用注解配置

@Controller
public class HelloController {

    @RequestMapping(path = "/hello")
    public String hello() {
        System.out.println("Hello SpringMVC");
        return "success";	// 被视图解析器解析后为 /WEB-INF/pages/success.jsp
    }
}

6.在webapp/WEB-INF/pages目录下创建 success.jsp，用于展示成功跳转页面

<%@ page contentType="text/html;charset=UTF-8" language="java" isELIgnored="false" %>
<html>
<head>
    <title>成功</title>
</head>
<body>
    <h3>入门成功了</h3>
</body>
</html>

7.启动tomcat服务器，进行测试。

2.2入门案例的执行过程分析

服务器启动，应用被加载。读取到web.xml中的配置创建 spring 容器并且初始化容器中的对象。
浏览器发送请求，被 DispatherServlet捕获，该 Servlet 并不处理请求，而是把请求转发出去。转发的路径是根据请求 URL，匹配@RequestMapping 中的内容。
匹配到了后，执行对应方法。该方法有一个返回值。根据方法的返回值，借助 InternalResourceViewResolver找到对应的结果视图。
渲染结果视图，响应浏览器。
整个流程图如下所示：

2.3入门案例中的组件分析

DispatcherServlet：(前端控制器)
- 用户请求到达前端控制器，dispatcherServlet 是整个流程控制的中心，由它调用其它组件处理用户的请求，dispatcherServlet 的存在降低了组件之间的耦合性。
HandlerMapping：(处理器映射器)
- HandlerMapping 负责根据用户请求找到 Handler 即处理器，SpringMVC 提供了不同的映射器实现不同的映射方式，例如：配置文件方式，实现接口方式，注解方式等。
Handler：(处理器)
- 它就是我们开发中要编写的具体业务控制器。由 DispatcherServlet 把用户请求转发到 Handler。由Handler 对具体的用户请求进行处理。
HandlAdapter：(处理器适配器)
- 通过 HandlerAdapter 对处理器进行执行，这是适配器模式的应用，通过扩展适配器可以对更多类型的处理器进行执行。
View Resolver：(视图解析器)
- View Resolver 负责将处理结果生成 View 视图，View Resolver 首先根据逻辑视图名解析成物理视图名即具体的页面地址，再生成 View 视图对象，最后对 View 进行渲染将处理结果通过页面展示给用户。
View：视图
- 展示给用户的具体页面，比如说 jsp 页面
在 SpringMVC 的各个组件中，HandlerMapping 处理器映射器、HandlerAdapter 处理器适配器、View Resolver 视图解析器称为 SpringMVC 的三大组件。
配置文件中的 <mvc:annotation-drivern>会自动帮我们加载处理器映射器和处理器适配器。

2.4RequestMapping注解

RequestMapping注解的作用是建立请求URL和处理方法之间的对应关系
RequestMapping注解可以作用在方法和类上
- 作用在类上：第一级的访问目录
- 作用在方法上：第二级的访问目录
- 细节：路径可以不编写 / 表示应用的根目录开始
- 细节：${ pageContext.request.contextPath }也可以省略不写，但是路径上不能写 /
RequestMapping的属性：
- path:指定请求路径的url
- method：用于指定请求的方式。
- params：用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的 key 和 value 必须和配置的一模一样。例如：
  - params = {"accountName"}，表示请求参数必须有 accountName
  - params = {"moeny!100"}，表示请求参数中 money 不能是 100。
- headers：用于指定限制请求消息头的条件。
- 以上四个属性只要出现 2 个或以上时，他们的关系是与的关系。

3请求参数的绑定

3.1绑定说明

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

<a href="account/findAccount?accountId=10">查询账户</a>

这里请求参数是accountId=10

/**
* 查询账户
* @return
*/
@RequestMapping("/findAccount")
public String findAccount(Integer accountId) {
System.out.println("查询了账户。。。。"+accountId);
return "success"; }

通过上面控制层的代码，我们就可以拿到请求参数的值。
要求：提交表单的name和参数的名称是相同的

支持的数据类型：
- 基本数据类型和字符串类型
- 实体类型（JavaBean）
- 集合数据类型（List、map集合等）

3.2 基本类型和字符串类型作为参数

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

<!-- 基本类型示例 --> 
<a href="account/findAccount?accountId=10&accountName=zhangsan">查询账户</a>

/**
* 查询账户
* @return
*/
@RequestMapping("/findAccount")
public String findAccount(Integer accountId,String accountName) {
	System.out.println("查询了账户。。。。"+accountId+","+accountName);
	return "success"; 
}

3.3实体类型作为参数

使用要求：
- 提交表单的name和JavaBean中的属性名称需要一致
- 如果一个JavaBean类中包含其他的引用类型，那么表单的name属性需要编写成：对象.属性例如：address.name

 <%-- 请求参数绑定javabean
            这里的name必须和要封装的javabean中属性的名称一致
     --%>
    <form action="param/saveAccount" method="post">
        姓名：<input type="text" name="username"/><br>
        密码：<input type="text" name="password"/><br>
        金额：<input type="text" name="money"/><br>
        用户姓名：<input type="text" name="user.uname"/><br>
        用户年龄：<input type="text" name="user.age"/><br>
        <input type="submit" value="提交"><br>
    </form>

    /**
     * 请求参数绑定把数据封装到JavaBean的类中
     * @param account
     * @return
     */
    @RequestMapping("/saveAccount")
    public String saveAccount(Account account){
        System.out.println(account);
        return "success";
    }

// 外部类
public class Account implements Serializable {
    private String username;
    private String password;
    private Double money;
    // 其他 JavaBean 对象引用
    private User user;
    
    // ...
}

// 内部类
public class User implements Serializable {
    private String name;
    private Integer age;

    // ...
}

3.4集合类型作为参数

使用要求：
- 如果要绑定集合类型的参数，那么要求集合类型的请求参数必须在 POJO 类中，同时请求参数名称和 POJO 类的集合属性名称保持一致。当给 List 集合中的元素赋值时，使用下标；当给 Map 集合中的元素赋值时，使用键值对，见以下示例

    <%-- 请求参数绑定集合类型--%>
    <form action="param/saveAccount" method="post">
        姓名：<input type="text" name="username"/><br>
        密码：<input type="text" name="password"/><br>
        金额：<input type="text" name="money"/><br>

        用户姓名：<input type="text" name="list[0].uname"/><br>
        用户年龄：<input type="text" name="list[0].age"/><br>

        用户姓名：<input type="text" name="map['one'].uname"/><br>
        用户年龄：<input type="text" name="map['one'].age"/><br>
        <input type="submit" value="提交">
    </form>

    /**
     * 请求参数绑定把数据封装到JavaBean的类中
     * @param account
     * @return
     */
    @RequestMapping("/saveAccount")
    public String saveAccount(Account account){
        System.out.println(account);
        return "success";
    }

public class Account implements Serializable {
    private String username;
    private String password;
    private Double money;
    // List 集合
    private List<User> list;
    // Map 集合
    private Map<String, User> map;
        
    // ...
}

3.5请求参数乱码问题

对于 GET 方式提交的请求，如果请求参数中含有中文，那么是不会乱码的，因为 Tomcat 8 已经将乱码问题解决了。
而对于 POST 方式提交的请求参数乱码问题，应在 web.xml 中配置一个 SpringMVC 提供的过滤器 CharacterEncodingFilter

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

3.6自定义类型转换器

我们都知道表单提交的任何数据类型全部都是字符串类型，但是后台定义Integer类型，数据也可以封装上，说明Spring框架内部会默认进行数据类型转换。
但有些情况，例如：请求参数提交了一个日期字符串，控制器方法使用 Date类型的变量进行接收，由于日期字符串有很多种格式，所以 SpringMVC 的内置转换器不一定能帮我们转换成 Date 类型。

<a href="param/testStringToDate?date=2020-06-07">字符串转日期</a>

@RequestMapping("/testStringToDate")
public String testStringToDate(Date date) {
    System.out.println(date);
    return "success";
}

在这里插入图片描述

这就是SpringMVC的内置转换器不能帮助我们转换，这种情况我们就需要自定义类型转换器。可以实现Converter的接口

/**
 * 把字符串转化为一个日期类型
 */
public class StringToDataConverter implements Converter<String,Date> {
    /**
     *
     * @param s     传入进来的字符串
     * @return
     */
    @Override
    public Date convert(String s) {
        SimpleDateFormat df = new SimpleDateFormat("yyyy-MM-dd");
        try {
            //把字符串转换为日期类型
            return df.parse(s);
        } catch (Exception e) {
            throw new RuntimeException("数据类型转换出现错误");
        }
    }
}

然后需要我们在SpringMVC 的配置文件中配置该类型转换器

<!-- 配置自定义的类型转换器 -->
    <bean id="conversionServiceFactoryBean" class="org.springframework.context.support.ConversionServiceFactoryBean">
        <property name="converters">
            <set>
                <bean class="com.zut.utils.StringToDataConverter"></bean>
            </set>
        </property>
    </bean>

4.常用的注解

4.1RequestParam注解

作用：把请求中指定名称的参数给控制器中的形参赋值。
属性：
- value：请求参数中的名称。
- required：请求参数中是否必须提供此参数。默认值：true。表示必须提供，如果不提供将报错。
使用实例：

<a href="anno/testRequestParam?name=哈哈">RequestParam</a>

    @RequestMapping("/testRequestParam")
    public String testRequestParam(@RequestParam(name = "name") String username){
        System.out.println("执行了。。。。");
        System.out.println("username: " + username);
        return "success";
    }

此时使用 @RequestParam("name")，那么如果请求参数中没有 name 参数，程序就会报错。

4.2RequestBody注解

作用：用于获取请求体的内容（注意：get方法不可以）
属性：
- required：是否必须有请求体，默认值是true
使用实例：

<form action="anno/testRequestBody" method="post">
        用户姓名：<input type="text" name="username"/><br>
        用户年龄：<input type="text" name="age"/><br>
        <input type="submit" value="提交">
</form>

@RequestMapping("/testRequestBody")
    public String testRequestBody(@RequestBody String body){
        System.out.println("执行了。。。。");
        System.out.println("请求体内容: " + body);
        return "success";
    }

在这里插入图片描述

所获取到的请求体内容为key=value&&key=value的形式

4.3PathVariable注解

作用：用于绑定url中的占位符的。例如：url中有/delete/{id}，{id}就是占位符。url 支持占位符是 spring3.0 之后加入的。是 springmvc 支持 rest 风格 URL 的一个重要标志。
属性：
- value：用于指定 url 中占位符名称。
- required：是否必须提供占位符。
使用实例：

<a href="anno/testPathVaribale/100">PathVaribale</a>

 @RequestMapping("/testPathVaribale/{sid}")
    public String testPathVaribale(@PathVariable("sid") String id){
        System.out.println("执行了。。。。");
        System.out.println("id= "+ id);
        return "success";
    }

在这里插入图片描述

REST 风格 URL的特性
资源（Resources）：每种资源对应一个特定的 URI
表现层（Representation）：把资源具体呈现出来的形式
状态转化（State Transfer）：每发出一个请求，就代表了客户端和服务器的一次交互过程。客户端使用 GET、POST、PUT、DELETE 4个表示操作方式的动词对服务端资源进行操作：GET 用来获取资源，POST 用来新建资源（也可以用于更新资源），PUT 用来更新资源，DELETE 用来删除资源，譬如：
/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

4.4@RequestHeader 和 @CookieValue

@RequestHeader用于获取请求消息头。属性如下：
- value：要获取的消息头名称
- required：是否必须有此消息头
@CookieValue用于获取 Cookie 的值。属性如下：
- value：要获取的 Cookie名称
- required：是否必须有此 Cookie

    <a href="anno/testRequestHeader">RequestHeader</a><br>

    <a href="anno/testCookieValue">CookieValue</a><br>

    /**
     * 获取请求头的信息
     */
    @RequestMapping("/testRequestHeader")
    public String testRequestHeader(@RequestHeader(value = "Accept") String head){
        System.out.println("获取了请求头信息...");
        System.out.println(head);
        return "success";
    }

    @RequestMapping("/testCookieValue")
    public String testCookieValue(@CookieValue(value = "JSESSIONID") String cookievalue){
        System.out.println("测试CookieValue。。。。");
        System.out.println(cookievalue);
        return "success";
    }

4.5@ModelAttribute

作用：
- 出现在方法上：表示当前方法会在控制器方法执行前线执行。
- 出现在参数上：获取指定的数据给参数赋值。
属性：
- value：用于获取数据的 key。key 可以是 POJO 的属性名称，也可以是 map 结构的 key 。
应用场景：
- 当表单提交数据不是完整的实体类数据时，保证没有提交数据的字段使用数据库对象原来的数据。
使用实例：

    <form action="anno/testModelAttribute" method="post">
        用户姓名：<input type="text" name="uname"/><br>
        用户年龄：<input type="text" name="age"/><br>
        <input type="submit" value="提交">
    </form>

    /**
     * ModelAttribute注解的使用
     * @return
     */
    @RequestMapping("/testModelAttribute")
    public String testModelAttribute(@ModelAttribute("abc") User user){
        System.out.println("testModelAttribute执行了");
        System.out.println(user);
        return "success";
    }
    @ModelAttribute
    public User show(String uname){
        User user = new User();
        user.setUname(uname);
        user.setAge(20);
        user.setDate(new Date());
        System.out.println("执行了show方法");
        System.out.println(user);
        return user;
    }

4.6SessionAttributes注解

作用：用于多次执行控制器方法间的参数共享，只能作用在类上
属性：
- value：指定存入属性的名称
- type：用于指定存入的数据类型

    <a href="anno/testSessionAttributes">SessionAttributes</a><br>
    <a href="anno/getSessionAttributes">getSessionAttributes</a><br>
    <a href="anno/delSessionAttributes">delSessionAttributes</a><br>

    @RequestMapping("/testSessionAttributes")
    public String testSessionAttributes(Model model){
        System.out.println("测试SessionAttributes。。。。");
        //底层会存储到request域对象中
        model.addAttribute("msg","垃圾");
        return "success";
    }

    /**
     * 获取值
     * @param modelMap
     * @return
     */
    @RequestMapping("/getSessionAttributes")
    public String getSessionAttributes(ModelMap modelMap){
        System.out.println("测试SessionAttributes。。。。");
        String msg = (String) modelMap.get("msg");
        System.out.println(msg);
        return "success";
    }

    /**
     * 清除
     * @param status
     * @return
     */
    @RequestMapping("/delSessionAttributes")
    public String delSessionAttributes(SessionStatus status){
        System.out.println("测试SessionAttributes。。。。");
        status.setComplete();
        return "success";
    }