（一）初见SpringMVC、RESTful编程风格、参数绑定、常用注解（图文教学，超级简单）

项目完成代码：SpringmvcTest-Github

---

1. 简介

1.1 MVC模型

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

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

View（视图）：

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

Controller（控制器）：

是应用程序中处理用户交互的部分。作用一般就是处理程序逻辑的。

1.2 SpringMVC

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

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

1.4 RESTful编程风格

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

2. SpringMVC入门

1. 使用Maven的WebApp骨架搭建工程springmvctest1
   
2. 修改pom.xml的坐标

<properties>
    <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
    <maven.compiler.source>1.8</maven.compiler.source>
    <maven.compiler.target>1.8</maven.compiler.target>
    <!-- 版本锁定 -->
    <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>
    <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>

3. 向WEB-INF下web.xml配置文件中配置核心的控制器（配置DispatcherServlet）

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

4. 在resources文件夹（需要自己创建）中创建springmvc.xml配置文件（该文件其实就是spring的配置文件）
   
   成功后图片
   

<?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.lois"/>

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

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

5. 创建com.lois.controller.HelloController表现层类

@Controller
public class HelloController {

    @RequestMapping("/hello") //访问该方法的路径
    public String Hello(){
        System.out.println("Hello SpringMVC!");
        return "success"; //跳转页面的名字,给视图解析器解析
    }
}

6. 修改wabapp/index.jsp文件内容

<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
    <title>Title</title>
</head>
<body>
    <h3>入门案例</h3>

    <a href="/hello">跳转成功页面</a>
</body>
</html>

7. 创建webapp/WEB-INF/pages/success.jsp文件

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

8. 配置Tomcat，启动服务器
   
   

2.1 入门案例分析

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

2.2 @RequestMapping

作用：

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

源码：
ctrl+鼠标左键点击@RequestMapping可以查看源码

@Target({ElementType.METHOD, ElementType.TYPE}) 表示 该注解可以作用于方法和类上，作用在类上表示一级目录，作用在方法上表示二级目录。
例如，当我们修改HelloController类时

@Controller
@RequestMapping("/springmvc")
public class HelloController {

    @RequestMapping("/hello") //访问该方法的路径
    public String Hello(){
        System.out.println("Hello SpringMVC!");
        return "success"; //跳转页面的名字,给视图解析器解析
    }
}

我们再想要访问到该方法时，链接应该写成

<a href="/springmvc/hello">跳转成功页面</a>

属性：

• value：用于指定请求的 URL。它和 path 属性的作用是一样的。

• method：用于指定请求的方式。get/post/put/delete…

• params：用于指定限制请求参数的条件。它支持简单的表达式。要求请求参数的 key 和 value 必须和配置的一模一样。

    例如：
    params = {"accountName"}，表示请求参数必须有 accountName
    params = {"moeny!100"}，表示请求参数中 money 不能是 100。
  

• headers：用于指定限制请求消息头的条件。

注意:以上四个属性只要出现 2 个或以上时，他们的关系是与的关系。

3. 请求参数的绑定

3.1 简单示例

SpringMVC 绑定请求参数的过程是通过把表单提交请求参数，作为控制器中方法参数进行绑定的。
例如：
我们使用get方式提交数据

<a href="/springmvc/hello?money=1000">跳转成功页面</a>

我们只需要在链接调用的方法上写上参数名为money的参数即可

@Controller
@RequestMapping("/springmvc")
public class HelloController {

    @RequestMapping("/hello") //访问该方法的路径
    public String Hello(int money){
        System.out.println("Hello SpringMVC! money=" + money);
        return "success"; //跳转页面的名字,给视图解析器解析
    }
}

运行控制台打印

3.2 支持的数据类型

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

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

3.3 使用要求

• 基本类型或者 String 类型：

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

• POJO 类型，或者它的关联对象：

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

• 集合类型,有两种方式：
  第一种：
  要求集合类型的请求参数必须在 POJO 中。在表单中请求参数名称要和 POJO 中集合属性名称相同。
  给 List 集合中的元素赋值，使用下标。
  给 Map 集合中的元素赋值，使用键值对。
  第二种：
  接收的请求参数是 json 格式数据。需要借助一个注解实现。

注意：我们知道浏览器传来的数据都是字符串，是没有类型的数据。SpringMVC会根据我们在方法中写的数据类型进行转换。

3.4 使用示例

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

这种方式我们已经在 3.1 中已经讲过了，很简单，这里就不重复了。

3.4.2 POJO 类型作为参数

1. 创建一个实体类com.lois.domian.User，生成set、get、tostring方法

public class User implements Serializable {
    private Integer id;
    private String username;
    private String password;
}

2. 向com.lois.controller.HelloController类中添加方法

@RequestMapping(value = "/user",method = RequestMethod.POST) //使用Post方法提交
public String Hello(User user){
    System.out.println(user);
    return "success";
}

3. 向index.jsp中添加链接

<form action="/springmvc/user" method="post">
    用户名：<input name="username" type="text"><br>
    密码：<input name="password" type="text"><br>
    <input type="submit" value="提交">
</form>

4. 运行服务器，填写表单，提交
   
   控制台输出
   

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

1. 编写实体类com.lois.domian.Account，生成set/get/toString方法

public class Account implements Serializable {
    private String accountName;
    private Double money;
}

2. 修改com.lois.domian.User实体类，重新生产set/get/toString方法

public class User implements Serializable {
    private Integer id;
    private String username;
    private String password;

    private List<Account> list;
    private Map<String,Account> map;
}

3. 向index.jsp中添加表单，表单提交的链接还是调用3.4.2的方法

<form action="/springmvc/user" method="post">
    用户名：<input name="username" type="text"><br>
    密码：<input name="password" type="text"><br>
    List账户：<input name="list[0].accountName" type="text"><br>
    List金额：<input name="list[0].money" type="text"><br>
    Map帐号：<input name="map['one'].accountName" type="text"><br>
    Map金额：<input name="map['one'].money" type="text"><br>1
    <input type="submit" value="提交">
</form>

4. 运行服务器，填写表单，提交
   
   控制台输出
   

3.4.4 请求参数乱码的问题

上面我们使用表单提交的信息，都是英文的，如果你尝试提交中文信息，就会发现控制台打印出来的信息是乱码。
我们需要在web.xml中配置一个过滤器

<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>
<!-- 过滤所有请求 但是静态资源我们不需要拦截，如图片、css、js等，我们需要在spring的配置文件中写明-->
<filter-mapping>
  <filter-name>CharacterEncodingFilter</filter-name>
  <url-pattern>/*</url-pattern>
</filter-mapping>

修改spring配置文件，设置不过滤静态资源

<!-- location 表示路径，mapping 表示文件，**表示该目录下的文件以及子目录的文件 -->
 <mvc:resources location="/css/" mapping="/css/**"/>
 <mvc:resources location="/images/" mapping="/images/**"/>
 <mvc:resources location="/js/" mapping="/js/**"/>

成果：

3.4.5 自定义类型转换器

使用场景：当你需要一个date类型的数据时，jsp只传来spring类型
使用步骤：

1. 自定义类型转换器

public class StringToDateConverter implements Converter<String, Date> {
	/**
	* 用于把 String 类型转成日期类型
	* Converter<S, T> //S:表示接受的类型，T：表示目标类型
	*/
	@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("输入日期有误");
		}
	}
}

2. 在 spring 配置文件中配置类型转换器。
   spring 配置类型转换器的机制是，将自定义的转换器注册到类型转换服务中去。

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

3. 在 annotation-driven 标签中引用配置的类型转换服务

<!-- 引用自定义类型转换器 -->
<mvc:annotation-driven conversion-service="converterService"/>

4. 常用注解

4.1 @RequestParam

作用：
把请求中指定名称的参数给控制器中的形参赋值。（一般使用在浏览器传来的参数名和方法上的形参名不一致情况下）
属性：

• value：请求参数中的名称。
• required：请求参数中是否必须提供此参数。默认值：true。表示必须提供，如果不提供将报错。

示例：

1. 向com.lois.controller.HelloController类中添加方法

    @RequestMapping("/testRequestParam")
    public String testRequestParam(@RequestParam("username") String name){
        System.out.println(name);
        return "success";
    }

2. 在index.jsp中添加链接，注意我们传递的参数名称

<a href="/springmvc/testRequestParam?username=lois">测试RequestParam</a>

3. 运行服务器测试
   点击链接，控制台输出
   

4.2 @RequestBody（@ResponseBody作用一样）

作用：
用于获取请求体内容。直接使用得到是 key=value&key=value…结构的数据（json）。
get 请求方式不适用。
属性：

• required：是否必须有请求体。默认值是:true。当取值为 true 时,get 请求方式会报错。如果取值为 false，get 请求得到是 null。

示例：

1. 向com.lois.controller.HelloController类中添加方法

@RequestMapping(value = "/testRequestBody",method = RequestMethod.POST)
public String testRequestBody(@RequestBody String body){
    System.out.println(body);
    return "success";
}

2. 在index.jsp中添加表单

<form action="/springmvc/testRequestBody" method="post">
    用户名：<input name="username" type="text"><br>
    密码：<input name="password" type="text"><br>
    <input type="submit" value="提交">
</form>

3. 运行服务器测试
   
   

4.3 @PathVaribale

作用：
用于绑定 url 中的占位符。例如：请求 url 中 /delete/{id}，这个{id}就是 url 占位符。
url 支持占位符是 spring3.0 之后加入的。是 springmvc 支持 rest 风格 URL 的一个重要标志。（前面我们已经介绍过RESTful风格）
属性：

• value：用于指定 url 中占位符名称。
• required：是否必须提供占位符。

示例：

1. 向com.lois.controller.HelloController类中添加方法，注意，此时@PathVariable可以不写value的值，这是因为它注解参数名与占位符相同，如果不同就必须要写value的值，即：@PathVariable(“uid”)

@RequestMapping(value = "/testPathVariable/{uid}")
public String testPathVariable(@PathVariable String uid){
    System.out.println(uid);
    return "success";
}

2. 在index.jsp中添加链接，注意链接指向的地址不是get请求uid=1000，而是/1000

<a href="/springmvc/testPathVariable/1000">测试PathVariable</a>

3. 运行服务器测试
   

4.4 @RequestHeader （不常用）

作用：
用于获取请求消息头。
属性：

• value：提供消息头名称
• required：是否必须有此消息头

示例：

1. 向com.lois.controller.HelloController类中添加方法

@RequestMapping(value = "/testRequestHeader")
public String testRequestHeader(@RequestHeader("Accept") String header){
    System.out.println(header);
    return "success";
}

2. 在index.jsp中添加链接

<a href="/springmvc/testRequestHeader">测试RequestHeader</a>

3. 运行服务器测试
   

4.5 @CookieValue

作用：
用于把指定 cookie 名称的值传入控制器方法参数。
属性：

• value：指定 cookie 的名称。
• required：是否必须有此 cookie。

示例：

1. 向com.lois.controller.HelloController类中添加方法

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

2. 在index.jsp中添加链接

<a href="/springmvc/testCookieValue">测试CookieValue</a>

3. 运行服务器测试
   

4.6 @ModelAttribute

作用：
该注解是 SpringMVC4.3 版本以后新加入的。它可以用于修饰方法和参数。

• 出现在方法上，表示当前方法会在控制器的方法执行之前（其他所有方法），先执行。它可以修饰没有返回值的方法，也可以修饰有具体返回值的方法。
• 出现在参数上，获取指定的数据给参数赋值。

属性：

• value：用于获取数据的 key。key 可以是 POJO 的属性名称，也可以是 map 结构的 key。

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

示例：
方式一（ModelAttribute 修饰方法带返回值）：

1. 向com.lois.controller.HelloController类中添加方法

@ModelAttribute
public User setUserId(User user){
    user.setId(1);
    System.out.println("执行了setUserId");
    return user;
}
@RequestMapping(value = "/testModelAttribute",method = RequestMethod.POST)
public String testModelAttribute(User user){
    System.out.println("修改后的User为"+user);
    return "success";
}

2. 在index.jsp中添加链接

<form action="/springmvc/testModelAttribute" method="post">
    用户名：<input name="username" type="text"><br>
    密码：<input name="password" type="text"><br>
    <input type="submit" value="提交">
</form>

3. 运行服务器测试
   

方式二：（ModelAttribute 修饰方法不带返回值）

1. 注释方式一的代码
2. 向com.lois.controller.HelloController类中添加方法

@ModelAttribute
public void setUserId(User user, Map<String,User> map){
    user.setId(1);
    System.out.println("执行了setUserId");
    map.put("abc",user);
}
@RequestMapping(value = "/testModelAttribute",method = RequestMethod.POST)
public String testModelAttribute(@ModelAttribute("abc") User user){
    System.out.println("修改后的User为"+user);
    return "success";
}

3. index.jsp 中的代码还是使用方式一的代码
4. 运行服务器测试，结果跟方式一 一样

4.7 @SessionAttribute

作用：
用于多次执行控制器方法间的参数共享。（注解需要加在类上，可以存储多个数据）
属性：

• value：用于指定存入的属性名称
• type：用于指定存入的数据类型。

示例：

1. 向com.lois.controller.HelloController类中添加方法

@Controller
@RequestMapping("/springmvc")
@SessionAttributes(value = "user",types = User.class)
public class HelloController {

    //----------SessionAttributes start------------
    @RequestMapping("/testSessionAttributesPut")
    public String testSessionAttributesPut(Model model){
        User user = new User();
        user.setId(1);
        user.setUsername("lois");
        user.setPassword("123456");
        model.addAttribute("user",user);
        System.out.println("数据存储成功");
        return "success";
    }
    @RequestMapping("/testSessionAttributesGet")
    public String testSessionAttributesGet(ModelMap model){
        System.out.println(model.get("user"));
        return "success";
    }
    @RequestMapping("/testSessionAttributesDel")
    public String testSessionAttributesDel(SessionStatus status){
        System.out.println("清除存储的数据");
        status.setComplete();
        return "success";
    }

2. 在index.jsp中添加链接

    <a href="/springmvc/testSessionAttributesPut">测试SessionAttributes存储数据</a>
    <br>
    <a href="/springmvc/testSessionAttributesGet">测试SessionAttributes获得数据</a>
    <br>
    <a href="/springmvc/testSessionAttributesDel">测试SessionAttributes清除数据</a>

3. 运行服务器测试
   

---

下一章：（二）SpringMVC响应数据和结果视图、文件上次、拦截器

---

相关文章：

（一）初见SpringMVC、RESTful编程风格、参数绑定、常用注解

（二）SpringMVC响应数据和结果视图、文件上次、拦截器

---

作者编写不易，转载请注明我的博客，如果觉得写的不错的话，请随手点个赞，谢谢！！！
作者编写不易，转载请注明我的博客，如果觉得写的不错的话，请随手点个赞，谢谢！！！
作者编写不易，转载请注明我的博客，如果觉得写的不错的话，请随手点个赞，谢谢！！！