第二章 SpringMVC 注解式开发

2.1 @RequestMapping 定义请求规则

2.1.1 指定模块名称

​ 通过@RequestMapping 注解可以定义处理器对于请求的映射规则。该注解可以注解在方
法上，也可以注解在类上，但意义是不同的。value 属性值常以“/”开始。
@RequestMapping 的 value 属性用于定义所匹配请求的 URI。但对于注解在方法上与类
上，其 value 属性所指定的 URI，意义是不同的。
一个@Controller 所注解的类中，可以定义多个处理器方法。当然，不同的处理器方法
所匹配的 URI 是不同的。这些不同的 URI 被指定在注解于方法之上的@RequestMapping 的
value 属性中。但若这些请求具有相同的 URI 部分，则这些相同的 URI，可以被抽取到注解在
类之上的@RequestMapping 的 value 属性中。此时的这个 URI 表示模块的名称。URI 的请求
是相对于 Web 的根目录。

​ 换个角度说，要访问处理器的指定方法，必须要在方法指定 URI 之前加上处理器类前定
义的模块名称

​ 项目：requestMapping-modelName。在 primary-annotation 基础上进行修改。

​ step1：修改处理器类Mycontroller

​ step2：添加视图页面

​ 在/WEB-INF/jsp 目录下添加 some.jsp 与 other.jsp 页面，删除原 welcome.jsp 页面。

2.1.2 对请求提交方式的定义

​ 对于@RequestMapping，其有一个属性 method，用于对被注解方法所处理请求的提交
方式进行限制，即只有满足该method属性指定的提交方式的请求，才会执行该被注解方法。
​ Method 属性的取值为 RequestMethod 枚举常量。常用的为 RequestMethod.GET 与
RequestMethod.POST，分别表示提交方式的匹配规则为 GET 与 POST 提交。

​ 以上处理器方法只能处理 POST 方式提交的请求。客户端浏览器常用的请求方式，及其
提交方式有以下几种：

​ 也就是说，只要指定了处理器方法匹配的请求提交方式为 POST，则相当于指定了请求
发送的方式：要么使用表单请求，要么使用 AJAX 请求。其它请求方式被禁用。
当然，若不指定 method 属性，则无论是 GET 还是 POST 提交方式，均可匹配。即对于
请求的提交方式无要求。

​ 项目：requestMapping-method。在 requestMapping-modelName 基础上进行修改。

​ Step1：修改处理器类 MyController

​ step2： 修改index 页面

2.2 处理器方法的参数

​ 处理器方法可以包含以下四类参数，这些参数会在系统调用时由系统自动赋值，即程序
员可在方法内直接使用。
​ ➢ HttpServletRequest
​ ➢ HttpServletResponse
​ ➢ HttpSession
​ ➢ 请求中所携带的请求参数

2.2.1 逐个参数接受

​ 只要保证请求参数名，和该请求处理方法的形参名相同即可。

项目：receiveParameters-property。在 requestMapping-method 基础上修改。

step1： 修改 index 页面

step2： 修改处理器类 MyController

step3： 添加show页面

​ 在/WEB-INF/jsp 下添加 show.jsp 页面。

2.2.2 请求参数中文乱码问题

​ 对于前面所接收的请求参数，若含有中文，则会出现中文乱码问题。Spring 对于请求参
中的中文乱码问题，给出了专门的字符集过滤器：spring-web-5.2.5.RELEASE.jar 的
org.springframework.web.filter 包下的 CharacterEncodingFilter 类。

1）解决方案

​ 在 web.xml 中注册字符集过滤器，即可解决 Spring 的请求参数的中文乱码问题。不过，
最好将该过滤器注册在其它过滤器之前。因为过滤器的执行是按照其注册顺序进行的。
​ 直接在项目 receiveParameters-property 上进行修改。

2）源码分析

字符集设置核心方法：

2.2.3 校正请求参数名@RequestParam

​ 所谓校正请求参数名，是指若请求 URL 所携带的参数名称与处理方法中指定的参数名
不相同时，则需在处理方法参数前，添加一个注解**@RequestParam(“请求参数名”)**，指定请
求 URL 所携带参数的名称。该注解是对处理器方法参数进行修饰的。value 属性指定请求参
数的名称。

项目：receiveParameters-params。在 receiveParameters-property 基础上修改。

step1： 修改index页面

​ 将表单中的参数名修改得与原来不一样

step2：修改处理器MyController

required 属性：

2.2.4 对象参数接受

​ 将处理器方法的参数定义为一个对象，只要保证请求参数名与这个对象的属性同名即可。
项目：receiveParameters-object。在 receiveParameters-property 基础上修改。

step1：定义类Student

step2： 修改处理器类 MyController

step3： 修改 show 页面

2.3 处理器方法的返回值

​ 使用@Controller 注解的处理器的处理器方法，其返回值常用的有四种类型：
​ ➢ 第一种：ModelAndView
​ ➢ 第二种：String
​ ➢ 第三种：无返回值 void
​ ➢ 第四种：返回自定义类型对象

​ 根据不同的情况，使用不同的返回值。

2.3.1 返回 ModelAndView

​ 若处理器方法处理完后，需要跳转到其它资源，且又要在跳转的资源间传递数据，此时
处理器方法返回 ModelAndView 比较好。当然，若要返回 ModelAndView，则处理器方法中
需要定义 ModelAndView 对象。
​ 在使用时，若该处理器方法只是进行跳转而不传递数据，或只是传递数据而并不向任何
资源跳转（如对页面的 Ajax 异步响应），此时若返回 ModelAndView，则将总是有一部分多
余：要么 Model 多余，要么 View 多余。即此时返回 ModelAndView 将不合适。

2.3.2 返回 String

​ 处理器方法返回的字符串可以指定逻辑视图名，通过视图解析器解析可以将其转换为物理视图地址

​ 返回 内部资源逻辑视图名

​ 若要跳转的资源为内部资源，则视图解析器可以使用 InternalResourceViewResolver 内部资源视图解析器。此时处理器方法返回的字符串就是要跳转页面的文件名去掉文件扩展名后的部分。这个字符串与视图解析器中的 prefix、suffix 相结合，即可形成要访问的 URI。

项目：returnString-viewName。在 receiveParameters-object 基础上修改。

直接修改处理器类MyController

当然，也可以直接返回资源的物理视图名。不过，此时就不需要再在视图解析器中再配置前辍与后辍了。

2.3.3 返回void（了解）

对于处理器方法返回 void 的应用场景，AJAX 响应.

若处理器对请求处理后，无需跳转到其它任何资源，此时可以让处理器方法返回 void。

如，对于 AJAX 的异步请求的响应。

项目：returnVoid-ajax。在 primary-annotation 基础上进行修改。

Step1：maven 加入 jackson 依赖

​ 由于本项目中服务端向浏览器传回的是 JSON 数据，需要使用一个工具类将字符串包装
为 JSON 格式，所以需要导入 JSON 的依赖。

​

<dependency>
		<groupId>com.fasterxml.jackson.core</groupId>
		<artifactId>jackson-core</artifactId>
		<version>2.9.0</version>

</dependency>
<dependency>
		<groupId>com.fasterxml.jackson.core</groupId>
		<artifactId>jackson-databind</artifactId>
		<version>2.9.0</version>
</dependency>

Step2：引入 jQuery 库

​ 由于本项目要使用 jQuery 的 ajax()方法提交 AJAX 请求，所以项目中需要引入 jQuery 的库。在 WebRoot （Webapp）下新建一个 Folder（文件夹），命名为 js，并将 jquery-1.11.1.js 文件放入其中。

当然，该 jQuery 库文件，需要在使用 ajax()方法的 index 页面中引入。

Step3：定义 index 页面

index 页面由两部分内容构成：一个是，用于提交 AJAX 请求；一个是