SpringMVC(一)

2020-06-24

1. SpringMVC 的基本概念

1.1 三层架构和MVC

1.1.1 三层架构

开发服务器端程序，一般都基于两种形式，一种C/S(客户端/服务器)架构程序，一种B/S(浏览器/服务器)架构程序。

使用Java语言基本上都是开发B/S架构的程序，B/S架构又分成了三层架构：

表现层：WEB层，用来和客户端进行数据交互的。表现层一般会采用MVC的设计模型
业务层：处理公司具体的业务逻辑的
持久层：用来操作数据库的

1.1.2 MVC模型

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

Model：数据模型，JavaBean的类，用来进行数据封装。
View：指JSP、HTML用来展示数据给用户
Controller：用来接收用户的请求，整个流程的控制器。用来进行数据校验等。

1.2 SpringMVC 概述

1.2.1 SpringMVC 是什么

是一种基于Java实现的MVC设计模型的请求驱动类型的轻量级WEB框架。
Spring MVC属于SpringFrameWork的后续产品，已经融合在Spring Web Flow里面。Spring 框架提供了构建Web 应用程序的全功能 MVC 模块。
使用 Spring 可插入的 MVC 架构，从而在使用Spring进行WEB开发时，可以选择使用Spring的 SpringMVC框架或集成其他MVC开发框架，如Struts1(现在一般不用)，Struts2等。

1.2.2 SpringMVC 在三层架构的位置

1.2.3 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 执行效率高。

2. SpringMVC 的入门

2.1 SpringMVC 的入门案例

2.1.1 创建WEB工程，引入jar包

<groupId>com.wgy</groupId>
<artifactId>SpringMVC01_start</artifactId>
<version>1.0-SNAPSHOT</version>
<packaging>war</packaging>

<!-- 版本锁定 -->
<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>

2.1.2 配置核心的控制器

<!-- 配置 spring mvc 的核心控制器 -->
<servlet>
    <servlet-name>dispatcherServlet</servlet-name>
    <servlet-class>org.springframework.web.servlet.DispatcherServlet</servlet-class>
    <!-- 配置初始化参数，用于读取 SpringMVC 的配置文件 -->
    <init-param>
        <param-name>contextConfigLocation</param-name>
        <param-value>classpath:springmvc.xml</param-value>
    </init-param>
    <!-- 配置 servlet 的对象的创建时间点：应用加载时创建。取值只能是非 0 正整数，表示启动顺序 -->
    <load-on-startup>1</load-on-startup>
</servlet>
<servlet-mapping>
    <servlet-name>dispatcherServlet</servlet-name>
    <url-pattern>/</url-pattern>
</servlet-mapping>

2.1.3 编写springmvc.xml的配置文件

<?xml version="1.0" encoding="UTF-8"?>
<beans xmlns="http://www.springframework.org/schema/beans"
       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/context
                           http://www.springframework.org/schema/context/spring-context.xsd">

    <!-- 开启注解扫描 -->
    <context:component-scan base-package="com.wgy"/>

    <!-- 视图解析器对象 -->
    <bean id="internalResourceViewResolver" class="org.springframework.web.servlet.view.InternalResourceViewResolver">
        <property name="prefix" value="/WEB-INF/pages/"/>
        <property name="suffix" value=".jsp"/>
    </bean>
    
    <!-- 开启SpringMVC框架注解的支持 -->
    <mvc:annotation-driven/>
</beans>

2.1.4 编写index.jsp

<body>
<h3>入门案例</h3>
    <a href="${ pageContext.request.contextPath }/hello">入门案例</a>
</body>

2.1.5 编写HelloController控制器类

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

    /**
     * 入门案例
     *
     * @return
     */
    @RequestMapping(path = "/hello")
    public String sayHello() {
        System.out.println("Hello StringMVC");
        return "success";
    }
}

2.1.6 编写success.jsp

1
2
3

<body>
    <h3>入门成功！！</h3>
</body>

2.1.7 测试

启动Tomcat服务器，进行测试

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

2.2.1 案例的执行过程

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

2.2.2 SpringMVC 的请求响应流程

2.3 入门案例中涉及的组件

2.3.1 前端控制器（DispatcherServlet）

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

2.3.2 处理器映射器（HandlerMapping）

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

2.3.3 处理器（Handler）

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

2.3.4 处理器适配器（HandlAdapter）

通过 HandlerAdapter 对处理器进行执行

2.3.5 视图解析器（View Resolver）

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

2.3.6 视图（View）

SpringMVC 框架提供了很多的 View 视图类型的支持，包括：jstlView、freemarkerView、pdfView等。我们最常用的视图就是 jsp。

2.3.7 `<mvc:annotation-driven>` 说明

在 SpringMVC 的各个组件中，处理器映射器、处理器适配器、视图解析器称为 SpringMVC 的三大组件。

使用 <mvc:annotation-driven> 自动加载 RequestMappingHandlerMapping （处理映射器）和RequestMappingHandlerAdapter （处理适配器），可用在 SpringMVC.xml 配置文件中使用<mvc:annotation-driven>替代注解处理器和适配器的配置。

2.4 RequestMapping 注解

2.4.1 使用说明

RequestMapping注解的作用是建立请求URL和处理方法之间的对应关系

RequestMapping注解可以作用在方法和类上

RequestMapping的属性

path：指定请求路径的url
value：value属性和path属性是一样的
mthod：指定该方法的请求方式
params：指定限制请求参数的条件。例如：

params = {“accountName”}，表示请求参数必须有 accountName

params = {“moeny!100”}，表示请求参数中 money 不能是 100。
headers：发送的请求中必须包含的请求头

2.4.2 使用示例

2.4.2.1 出现位置的示例

控制器：

/**
 * 控制器类
 *
 * @author wgy
 */
@Controller("accountController")
@RequestMapping(path = "/account")
public class AccountController {
    
    /**
     * RequestMapping注解
     *
     * @return
     */
    @RequestMapping(value = "/findAccount")
    public String findAccount() {
        System.out.println("查询了账户。。。。");
        return "success";
    }
}

JSP:

<body>
    <!-- 第一种访问方式 -->
    <a href="${pageContext.request.contextPath}/account/findAccount">查询账户</a>
    <br/>
    
    <!-- 第二种访问方式 -->
    <a href="account/findAccount">查询账户</a>
</body>

在 jsp 中第二种写法时，不要在访问 URL 前面加/ ，否则无法找到资源。

2.4.2.2 method 属性的示例

控制器：

/**
 * 保存账户
 *
 * @return
 */
@RequestMapping(value="/saveAccount",method=RequestMethod.POST)
public String saveAccount() {
    System.out.println("保存了账户");
    return "success";
}

JSP:

<!-- 请求方式的示例 -->
<a href="account/saveAccount">保存账户，get 请求</a>
<br/>

<form action="account/saveAccount" method="post">
    <input type="submit" value=" 保存账户， post 请求 ">
</form>

当使用 get 请求时，提示错误信息是 405，信息是方法不支持 get 方式请求

2.4.2.3 params 属性的示例

控制器：

/**
 * 删除账户
 * @return
 */
@RequestMapping(value="/removeAccount",params= {"accountName","money>100"})
public String removeAccount() {
    System.out.println("删除了账户");
    return "success";
}

JSP:

<!-- 请求参数的示例 -->
<a href="account/removeAccount?accountName=aaa&money>100">删除账户，金额 100</a>
<br/>

<a href="account/removeAccount?accountName=aaa&money>150">删除账户，金额 150</a>

当我们点击第一个超链接时,可以访问成功。当我们点击第二个超链接时，无法访问。如下图：

3. 请求参数的绑定

3.1 绑定说明

3.1.1 绑定的机制

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

JSP:

1
2
3

<a href="account/findAccount?accountId=10">查询账户</a>
请求参数是：
accountId=10

控制器：

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

3.1.2 支持的数据类型

基本类型参数 ：
    包括基本类型和 String 类型
POJO 类型参数 ：
    包括实体类，以及关联的实体类
数组和集合类型参数 ：
    包括 List 结构和 Map 结构的集合（包括数组）

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

3.1.3 使用要求

如果是基本类型或者 String  类型：
    要求我们的参数名称必须和控制器中方法的形参名称保持一致。(严格区分大小写)
如果是 POJO 类型，或者它的关联对象 ：
    要求表单中参数名称和 POJO 类的属性名称保持一致。并且控制器方法的参数类型是 POJO 类型。
如果是集合类型, 有两种方式： 
    第一种：
    	要求集合类型的请求参数必须在 POJO 中。在表单中请求参数名称要和 POJO 中集合属性名称相同。
    	给 List 集合中的元素赋值，使用下标。
    	给 Map 集合中的元素赋值，使用键值对。
    第二种：
    	接收的请求参数是 json 格式数据。需要借助一个注解实现。

它可以实现一些数据类型自动转换,如遇特殊类型转换要求，需要我们自己编写自定义类型转换器。

3.1.4 使用示例

3.1.4.1 基本类型和 String 类型作为参数

JSP:

1 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.1.4.2 POJO 类型作为参数

实体类：

/**
 * 账户信息
 *
 * @author wgy
 */
public class Account implements Serializable {
    private Integer id;
    private String name;
    private Float money;
    private Address address;
	...
}

/**
 * 地址的实体类
 *
 * @author wgy
 */
public class Address implements Serializable {
    private String provinceName;
    private String cityName;
	...
}

JSP:

<!-- 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";
}

运行结果:

3.1.4.3 POJO 类中包含集合类型参数

实体类:

/**
 * 用户实体类
 *
 * @author wgy
 */
public class User implements Serializable {
    private String username;
    private String password;
    private Integer age;
    private List<Account> accounts;
    private Map<String,Account> 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";
}

运行结果:

3.1.4.4 请求参数乱码问题

post 请求方式：

在 web.xml 中配置一个过滤器
<!-- 配置 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>
</filter>
<!-- 过滤所有请求 -->
<filter-mapping>
    <filter-name>CharacterEncodingFilter</filter-name>
    <url-pattern>/*</url-pattern>
</filter-mapping>

get 请求方式：

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

<Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" edirectPort="8443"/>
改为：
<Connector connectionTimeout="20000" port="8080" protocol="HTTP/1.1" redirectPort="8443" useBodyEncodingForURI="true"/>

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

3.2 特殊情况

3.2.1 自定义类型转换器

表单提交的任何数据类型全部都是字符串类型，但是后台定义Integer类型，数据也可以封装上，说明 Spring框架内部会默认进行数据类型转换。

如果想自定义数据类型转换，可以实现Converter的接口

3.2.1.1 自定义类型转换器

/**
 * 把字符串转换日期
 *
 * @author wgy
 */
public class StringToDateConverter implements Converter<String, Date> {

    /**
     * String source    传入进来字符串
     *
     * @param source
     * @return
     */
    @Override
    public Date convert(String source) {
        // 判断
        if (source == null) {
            throw new RuntimeException("请您传入数据");
        }
        DateFormat df = new SimpleDateFormat("yyyy-MM-dd");

        try {
            // 把字符串转换日期
            return df.parse(source);
        } catch (Exception e) {
            throw new RuntimeException("数据类型转换出现错误");
        }
    }
}

3.2.1.2 注册自定义类型转换器

<!-- 配置类型转换器工厂 -->
<bean id="conversionService" class="org.springframework.context.support.ConversionServiceFactoryBean">
    <!-- 给工厂注入一个新的类型转换器 -->
    <property name="converters">
        <set>
            <!-- 配置自定义类型转换器 -->
            <bean class="com.wgy.utils.StringToDateConverter"/>
        </set>
    </property>
</bean>

<!-- 开启SpringMVC框架注解的支持 -->
<!-- 引用自定义类型转换器 -->
<mvc:annotation-driven conversion-service="conversionService"/>

3.2.2 使用 ServletAPI 对象作为方法参数

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

/**
 * 原生的API
 *
 * @return
 */
@RequestMapping("/testServlet")
public String testServlet(HttpServletRequest request, HttpServletResponse response) {
    System.out.println("执行了...");
    System.out.println(request);

    HttpSession session = request.getSession();
    System.out.println(session);

    ServletContext servletContext = session.getServletContext();
    System.out.println(servletContext);

    System.out.println(response);
    return "success";
}

4. 常用注解

4.1 RequestParam

4.1.1 使用说明

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

4.1.2 使用示例

JSP:

1 2	<!-- requestParams 注解的使用 --> <a href="springmvc/useRequestParam?name=test">requestParam 注解</a>

控制器:

/**
 * requestParam 注解的使用
 *
 * @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";
}

运行结果:

4.2 RequestBody

4.2.1 使用说明

作用：
    用于获取请求体内容。直接使用得到是 key=value&key=value...结构的数据。
    get 请求方式不适用。
属性：
    required：是否必须有请求体。默认值是:true。当取值为 true 时,get 请求方式会报错。如果取值为 false，get 请求得到是 null。

4.2.2 使用示例

JSP:

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

<a href="springmvc/useRequestBody?body=test">requestBody 注解 get 请求</a>

控制器:

/**
 * RequestBody 注解
 *
 * @param user
 * @return
 */
@RequestMapping("/useRequestBody")
public String useRequestBody(@RequestBody(required=false) String body){
    System.out.println(body);
    return "success";
}

post 请求运行结果:

get 请求运行结果:

4.3 PathVaribale

4.3.1 使用说明

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

4.3.2 使用示例

JSP:

1 2	<!-- PathVariable 注解 --> <a href="springmvc/usePathVariable/100">pathVariable 注解</a>

控制器:

/**
 * PathVariable 注解
 *
 * @param user
 * @return
 */
@RequestMapping("/usePathVariable/{id}")
public String usePathVariable(@PathVariable("id") Integer id){
    System.out.println(id);
    return "success";
}

运行结果:

4.3.3 REST 风格 URL

4.3.3.1 什么是 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 风格的网络接口。

4.3.3.2 restful 的优点

它结构清晰、符合标准、易于理解、扩展方便，所以正得到越来越多网站的采用。

请求路径一样，可以根据不同的请求方式去执行后台的不同方法

4.3.3.3 restful 的特性

资源（ Resources）：网络上的一个实体，或者说是网络上的一个具体信息。

它可以是一段文本、一张图片、一首歌曲、一种服务，总之就是一个具体的存在。可以用一个 URI （统一资源定位符）指向它，每种资源对应一个特定的 URI 。要获取这个资源，访问它的 URI 就可以，因此 URI 即为每一个资源的独一无二的识别符。
表现层（ Representation）：把资源具体呈现出来的形式，叫做它的表现层（ Representation）。

比如，文本可以用 txt 格式表现，也可以用 HTML 格式、XML 格式、JSON 格式表现，甚至可以采用二进制格式。
状态转化（ State Transfer）：每发出一个请求，就代表了客户端和服务器的一次交互过程。

HTTP 协议，是一个无状态协议，即所有的状态都保存在服务器端。因此，如果客户端想要操作服务器，必须通过某种手段，让服务器端发生 “状态转化 ”（ State Tran sfer）。而这种转化是建立在表现层之上的，所以就是 “表现层状态转化 ”。具体说，就是 HTTP 协议里面，四个表示操作方式的动词： GET、 POST、 PUT、DELETE。它们分别对应四种基本操作： GET 用来获取资源， POST 用来新建资源， PUT 用来更新资源， DELETE 用来删除资源。

4.3.3.4 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

4.4 RequestHeader

4.4.1 使用说明

作用：
    用于获取请求消息头。
属性：
    value：提供消息头名称
    required：是否必须有此消息头
注：
    在实际开发中一般不怎么用。

4.4.2 使用示例

JSP:

1 2	<!-- RequestHeader 注解 --> <a href="springmvc/useRequestHeader">获取请求消息头</a>

控制器:

/**
 * RequestHeader 注解
 *
 * @param user
 * @return
 */
@RequestMapping("/useRequestHeader")
public String useRequestHeader(@RequestHeader(value="Accept-Language",required=false)String requestHeader){
    System.out.println(requestHeader);
    return "success";
}

运行结果:

4.5 CookieValue

4.5.1 使用说明

作用：
    用于把指定 cookie 名称的值传入控制器方法参数。
属性：
    value：指定 cookie 的名称。
    required：是否必须有此 cookie。

4.5.2 使用示例

JSP:

1 2	<!-- CookieValue 注解 --> <a href="springmvc/useCookieValue">绑定 cookie 的值</a>

控制器:

/**
 * Cookie 注解注解
 *
 * @param user
 * @return
 */
@RequestMapping("/useCookieValue")
public String useCookieValue(@CookieValue(value="JSESSIONID",required=false) String cookieValue){
    System.out.println(cookieValue);
    return "success";
}

运行结果:

4.6 ModelAttribute

4.6.1 使用说明

作用：
    该注解是 SpringMVC4.3 版本以后新加入的。它可以用于修饰方法和参数。
    出现在方法上，表示当前方法会在控制器的方法执行之前，先执行。它可以修饰没有返回值的方法，也可以修饰有具体返回值的方法。
    出现在参数上，获取指定的数据给参数赋值。
属性：
    value：用于获取数据的 key。key 可以是 POJO 的属性名称，也可以是 map 结构的 key。
应用场景：
    当表单提交数据不是完整的实体类数据时，保证没有提交数据的字段使用数据库对象原来的数据。
    例如：
    我们在编辑一个用户时，用户有一个创建信息字段，该字段的值是不允许被修改的。在提交表单数据是肯定没有此字段的内容，一旦更新会把该字段内容置为 null，此时就可以使用此注解解决问题。

4.6.2 使用示例

4.6.2.1 基于 POJO 属性的基本使用

JSP:

1 2	<!-- ModelAttribute 注解的基本使用 --> <a href="springmvc/testModelAttribute?username=test">测试 modelattribute</a>

控制器:

/**
 * 被 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";
}

运行结果:

4.6.2.2 基于 Map 的应用场景1

ModelAttribute 修饰方法带返回值

修改用户信息，要求用户的密码不能修改

JSP:

<!-- 修改用户信息 -->
<form action="springmvc/updateUser" method="post">
    用户名称：<input type="text" name="username" ><br/>
    用户年龄：<input type="text" name="age" ><br/>
    <input type="submit" value=" 保存 ">
</form>

控制器:

/**
 * 查询数据库中用户信息
 *
 * @param user
 */
@ModelAttribute
public User showModel(String username) {
    //模拟去数据库查询
    User abc = findUserByName(username);
    System.out.println("执行了 showModel 方法"+abc);
    return abc;
}

/**
 * 模拟修改用户方法
 *
 * @param user
 * @return
 */
@RequestMapping("/updateUser")
public String testModelAttribute(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;
}

运行结果:

4.6.2.3 基于 Map 的应用场景2

ModelAttribute 修饰方法不带返回值

修改用户信息，要求用户的密码不能修改

JSP:

<!-- 修改用户信息 -->
<form action="springmvc/updateUser" method="post">
    用户名称：<input type="text" name="username" ><br/>
    用户年龄：<input type="text" name="age" ><br/>
    <input type="submit" value=" 保存 ">
</form>

控制器:

/**
 * 查询数据库中用户信息
 *
 * @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;
}

运行结果:

4.7 SessionAttribute

4.7.1 使用说明

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

4.7.2 使用示例

JSP:

<!-- SessionAttribute 注解的使用 -->
<a href="springmvc/testPut">存入 SessionAttribute</a>
<hr/>
<a href="springmvc/testGet">取出 SessionAttribute</a>
<hr/>
<a href="springmvc/testClean">清除 SessionAttribute</a>

控制器:

/**
 * 控制器
 *
 * @author wgy
 */
@Controller("sessionAttributeController")
@RequestMapping("/springmvc")
// 把数据存入到session域对象中
@SessionAttributes(value ={"username","password"},types={Integer.class})
public class SessionAttributeController {
    
    /**
     * 把数据存入 SessionAttribute
     *
     * @param model
     * @return
     * Model 是 spring 提供的一个接口，该接口有一个实现类 ExtendedModelMap
     * 该类继承了 ModelMap，而 ModelMap 就是 LinkedHashMap 子类
     */
    @RequestMapping("/testPut")
    public String testPut(Model model){
        System.out.println("存入了数据");
        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.print("获取了数据:");
        System.out.println(model.get("username")+";"+model.get("password")+";"+model.get("age"));
        return "success";
    }
    
    @RequestMapping("/testClean")
    public String complete(SessionStatus sessionStatus){
        System.out.print("清除了数据");
        sessionStatus.setComplete();
        return "success";
    }
}

运行结果:

-------------本文结束感谢您的阅读-------------

本文作者： Wgy
本文标题： SpringMVC(一)
本文链接： https://wgy1993.gitee.io/archives/4560ea2b.html
版权声明： 本作品采用 CC BY-NC-SA 4.0 进行许可。转载请注明出处！

1. SpringMVC 的基本概念

1.1 三层架构和MVC

1.1.1 三层架构

1.1.2 MVC模型

1.2 SpringMVC 概述

1.2.1 SpringMVC 是什么

1.2.2 SpringMVC 在三层架构的位置

1.2.3 SpringMVC 和 Struts2 的优略分析

2. SpringMVC 的入门

2.1 SpringMVC 的入门案例

2.1.1 创建WEB工程，引入jar包

2.1.2 配置核心的控制器

2.1.3 编写springmvc.xml的配置文件

2.1.4 编写index.jsp

2.1.5 编写HelloController控制器类

2.1.6 编写success.jsp

2.1.7 测试

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

2.2.1 案例的执行过程

2.2.2 SpringMVC 的请求响应流程

2.3 入门案例中涉及的组件

2.3.1 前端控制器（DispatcherServlet）

2.3.2 处理器映射器（HandlerMapping）

2.3.3 处理器（Handler）

2.3.4 处理器适配器（HandlAdapter）

2.3.5 视图解析器（View Resolver）

2.3.6 视图（View）

2.3.7 <mvc:annotation-driven> 说明

2.4 RequestMapping 注解

2.4.1 使用说明

2.4.2 使用示例

2.4.2.1 出现位置的示例

2.4.2.2 method 属性的示例

2.4.2.3 params 属性的示例

3. 请求参数的绑定

3.1 绑定说明

3.1.1 绑定的机制

3.1.2 支持的数据类型

3.1.3 使用要求

3.1.4 使用示例

3.1.4.1 基本类型和 String 类型作为参数

3.1.4.2 POJO 类型作为参数

3.1.4.3 POJO 类中包含集合类型参数

3.1.4.4 请求参数乱码问题

3.2 特殊情况

3.2.1 自定义类型转换器

3.2.1.1 自定义类型转换器

3.2.1.2 注册自定义类型转换器

3.2.2 使用 ServletAPI 对象作为方法参数

4. 常用注解

4.1 RequestParam

4.1.1 使用说明

4.1.2 使用示例

4.2 RequestBody

4.2.1 使用说明

4.2.2 使用示例

4.3 PathVaribale

4.3.1 使用说明

4.3.2 使用示例

4.3.3 REST 风格 URL

4.3.3.1 什么是 rest

4.3.3.2 restful 的优点

4.3.3.3 restful 的特性

4.3.3.4 restful 的示例

4.4 RequestHeader

4.4.1 使用说明

4.4.2 使用示例

4.5 CookieValue

4.5.1 使用说明

4.5.2 使用示例

4.6 ModelAttribute

4.6.1 使用说明

4.6.2 使用示例

4.6.2.1 基于 POJO 属性的基本使用

4.6.2.2 基于 Map 的应用场景1

4.6.2.3 基于 Map 的应用场景2

4.7 SessionAttribute

4.7.1 使用说明

4.7.2 使用示例

2.3.7 `<mvc:annotation-driven>` 说明