第二章 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。
第一步:修改处理器类 MyController。
第二步:添加视图页面
- 在/WEB-INF/jsp 目录下添加 some.jsp 与 other.jsp 页面,删除原 welcome.jsp 页面。在WEB-INF目录之下的界面是安全的,不可以在URL地址栏直接输入界面名称进行获取。
2.1.2 对请求提交方式的定义
- 对于@RequestMapping,其有一个属性 method,用于对被注解方法所处理请求的提交 方式进行限制,即只有满足该 method 属性指定的提交方式的请求,才会执行该被注解方法。
- Method 属性的取值为 RequestMethod 枚举常量。常用的为 RequestMethod.GET 与 RequestMethod.POST,分别表示提交方式的匹配规则为 GET 与 POST 提交。
- 以上处理器方法只能处理 POST 方式提交的请求。客户端浏览器常用的请求方式,及其 提交方式有以下几种:
- 也就是说,只要指定了处理器方法匹配的请求提交方式为 POST,则相当于指定了请求 发送的方式:要么使用表单请求,要么使用 AJAX 请求。其它请求方式被禁用。
超链接的请求方式是GET,可以使用POST请求方式的只能是表单以及AJAX方式。
- 当然,若不指定 method 属性,则无论是 GET 还是 POST 提交方式,均可匹配。即对于 请求的提交方式无要求。
第一步:修改处理器类 MyController
第二步:修改 index 页面
2.2 处理器方法的参数
- 处理器方法可以包含以下四类参数,这些参数会在系统调用时由系统自动赋值,即程序员可在方法内直接使用。
- HttpServletRequest
- HttpServletResponse
- HttpSession
- 请求中所携带的请求参数
2.2.1 逐个参数接收
只要保证请求参数名与该请求处理方法的参数名相同即可。此时可以直接获取,如果不同的话,在后面存在处理方式。
第一步:修改 index 页面
第二步:修改处理器类 MyController
第三步:添加 show 页面
在/WEB-INF/jsp 下添加 show.jsp 页面。
2.2.2 请求参数中文乱码问题
只有POST请求存在中文乱码问题,GET请求不存在中文乱码问题。
- 对于前面所接收的请求参数,若含有中文,则会出现中文乱码问题。Spring 对于请求参数中的中文乱码问题,给出了专门的字符集过滤器:spring-web-5.2.5.RELEASE.jar 的 org.springframework.web.filter 包下的 CharacterEncodingFilter 类。
(1) 解决方案
- 在 web.xml 中注册字符集过滤器,即可解决 Spring 的请求参数的中文乱码问题。不过, 最好将该过滤器注册在其它过滤器之前。因为过滤器的执行是按照其注册顺序进行的。
- 这个过滤器可以我们自己创建,也可以使用框架中提供好的过滤器(CharacterEncodingFilter)
(2) 源码分析
字符集设置核心方法:
2.2.3 校正请求参数名@RequestParam
- 所谓校正请求参数名,是指若请求 URL 所携带的参数名称与处理方法中指定的参数名 不相同时,则需在处理方法参数前,添加一个注解@RequestParam(“请求参数名”),指定请 求 URL 所携带参数的名称。该注解是对处理器方法参数进行修饰的。value 属性指定请求参 数的名称。
第一步:修改 index 页面
将表单中的参数名称修改的与原来不一样。
第二步:修改处理器类 MyController
required 属性:
2.2.4 对象参数接收
- 将处理器方法的参数定义为一个对象,只要保证请求参数名与这个对象的属性同名即可。
第一步:定义实体类Student,这个类用于封装用户的请求参数值
注意:这个实体类需要存在无参构造方法以及set和get方法。
第二步:修改处理器类 MyController
第三步:修改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。
直接修改处理器类 MyController
重点:也可以直接返回资源的物理视图名。不过,此时就不需要再在视图解析器中再配 置前辍与后辍了。