SpringMVC系列之二------SpringMVC 注解式开发

最新推荐文章于 2024-05-14 15:42:36 发布

zpeien

最新推荐文章于 2024-05-14 15:42:36 发布

阅读量741

点赞数 1

分类专栏： Java 文章标签： spring java springmvc 注解 ssm

本文链接：https://blog.csdn.net/qq_44920726/article/details/116673628

版权

Java 专栏收录该内容

17 篇文章 0 订阅

订阅专栏

SpringMVC系列之二------SpringMVC 注解式开发

一、@RequestMapping 定义请求规则

3、校正请求参数名@RequestParam

SpringMVC系列之二------SpringMVC 注解式开发

一、@RequestMapping 定义请求规则

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 基础上进行修改。

修改一：修改处理器类 MyController。

修改二：添加视图页面
在/WEB-INF/jsp 目录下添加 some.jsp 与 other.jsp 页面，删除原 welcome.jsp 页面。

2、对请求提交方式的定义

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

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

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

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

修改一：修改处理器类 MyController

修改二：修改 index 页面

2、处理器方法的参数

处理器方法可以包含以下四类参数，这些参数会在系统调用时由系统自动赋值，即程序
员可在方法内直接使用。

➢ HttpServletRequest
➢ HttpServletResponse
➢ HttpSession
➢ 请求中所携带的请求参数

1）、逐个参数接收

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

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

修改一：修改 index 页面

修改二：修改处理器类 MyController

修改三：添加 show 页面
在/WEB-INF/jsp 下添加 show.jsp 页面。

2）、请求参数中文乱码问题

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

解决方案

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

源码分析

字符集设置核心方法：

3、校正请求参数名@RequestParam

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

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

修改一：修改 index 页面
将表单中的参数名称修改的与原来不一样。

修改二：修改处理器类 MyController

required 属性：

4、对象参数接收

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

修改一：定义类 Student

修改二：修改处理器类 MyController

修改三：修改 show 页面

三、处理器方法的返回值

使用@Controller 注解的处理器的处理器方法，其返回值常用的有四种类型：

第一种：ModelAndView
第二种：String
第三种：无返回值 void
第四种：返回自定义类型对象

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

1、返回 ModelAndView

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

2/返回 String

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

项目：returnString-viewName。在 receiveParameters-object 基础上修改。
直接修改处理器类 MyController

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

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>

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

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

修改三：定义 index 页面
index 页面由两部分内容构成：一个是<button/>，用于提交 AJAX 请求；一个是<script/>，用于处理 AJAX 请求。

点击按钮发起请求

修改四：定义对象 Student

修改五：修改处理器类 MyController
处理器对于 AJAX 请求中所提交的参数，可以使用逐个接收的方式，也可以以对象的方式整体接收。只要保证 AJAX 请求参数与接收的对象类型属性同名。
以逐个方式接收参数：

修改六：删除视图页面
由于是服务端直接向浏览器发回数据，所以也就无需视图页面了，所以需要删除WEB-INF 中的 jsp 目录及其中的 show 页面。

4、返回对象 Object

处理器方法也可以返回 Object 对象。这个 Object 可以是 Integer，String，自定义对象，Map，List 等。但返回的对象不是作为逻辑视图出现的，而是作为直接在页面显示的数据出现的。
返回对象，需要使用@ResponseBody 注解，将转换后的 JSON 数据放入到响应体中。

1）环境搭建

maven pom.xml
由于返回 Object 数据，一般都是将数据转化为了 JSON 对象后传递给浏览器页面的。而这个由 Object 转换为 JSON，是由 Jackson 工具完成的。所以需要导入 Jackson 的相关 Jar 包。

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

2）声明注解驱动

将 Object 数据转化为 JSON 数据，需要由消息转换器 HttpMessageConverter 完成。而转换器的开启，需要由<mvc:annotation-driven/>来完成。
SpringMVC 使用消息转换器实现请求数据和对象，处理器方法返回对象和响应输出之间的自动转换
当 Spring 容器进行初始化过程中，在<mvc:annotation-driven/>处创建注解驱动时，默认创建了七个 HttpMessageConverter 对象。也就是说，我们注册<mvc:annotation-driven/>，就是为了让容器为我们创建 HttpMessageConverter 对象。

HttpMessageConverter 接口 : HttpMessageConverter<T>是 Spring3.0 新添加的一个接口，负责将请求信息转换为一个对象（类型为 T），将对象（类型为 T）输出为响应信息
HttpMessageConverter<T>接口定义的方法：
boolean canRead(Class<?> clazz,MediaType mediaType): 指定转换器可以读取的对象类型，即转换器是否可将请求信息转换为 clazz 类型的对象，同时指定支持 MIME 类型(text/html,applaiction/json 等)
boolean canWrite(Class<?> clazz,MediaType mediaType):指定转换器是否可将 clazz 类型的对象写到响应流中，响应流支持的媒体类型在 MediaType 中定义。LIst<MediaType> getSupportMediaTypes()：该转换器支持的媒体类型。
T read(Class<? extends T> clazz,HttpInputMessage inputMessage)：将请求信息流转换为 T 类型的对象。
void write(T t,MediaType contnetType,HttpOutputMessgae outputMessage):将 T 类型的对象写到响应流中，同时指定相应的媒体类型为 contentType
加入注解驱动<mvc:annotation-driven/>后适配器类的 messageConverters 属性值

3）返回自定义类型对象

返回自定义类型对象时，不能以对象的形式直接返回给客户端浏览器，而是将对象转换为 JSON 格式的数据发送给浏览器的。
由于转换器底层使用了 Jackson 转换方式将对象转换为 JSON 数据，所以需要导入 Jackson的相关 Jar 包。

项目：returnObject-custom。在 returnVoid-ajax 基础上进行修改。

修改一：定义数据类

修改二：修改处理器 MyController

修改三：修改 index 页面

4）返回 List 集合

项目：returnObject-list。在 returnObject-custom 基础上进行修改。

修改一：修改处理器 MyController

修改二：修改 index 页面

5）返回字符串对象

若要返回非中文字符串，将前面返回数值型数据的返回值直接修改为字符串即可。但若返回的字符串中带有中文字符，则接收方页面将会出现乱码。此时需要使用
@RequestMapping 的 produces 属性指定字符集。produces，产品，结果，即该属性用于设置输出结果类型。

项目：returnObject-String。
直接修改处理器。

修改页面：

四、解读<url-pattern/>

1、配置详解

1）*.do

在没有特殊要求的情况下，SpringMVC 的中央调度器 DispatcherServlet 的<url-pattern/>常使用后辍匹配方式，如写为*.do 或者 *.action, *.mvc 等。

2）/

可以写为/，因为 DispatcherServlet 会将向静态资源的获取请求，例如.css、.js、.jpg、.png等资源的获取请求，当作是一个普通的 Controller 请求。中央调度器会调用处理器映射器为其查找相应的处理器。当然也是找不到的，所以在这种情况下，所有的静态资源获取请求也均会报 404 错误。

项目：url-pattern。在项目 primary-annotation 基础上进行修改。
需求：在 index.jsp 页面中存在一个访问图片的链接。该项目用于演示将<url-pattern/>写为*.do可以访问到该图片，而写为/，则无法访问。

在项目中添加图片

在项目的 WebRoot 下添加一个目录 images，并在其中添加一张图片资源。

修改 index 页面

修改<url-pattern/>的值

保持<url-pattern/>的值为 *.do，扩展名方式，图片会正常显示。
将<url-pattern/>的值修改为 / ，则图片将无法显示。

2）静态资源访问

<url-pattern/>的值并不是说写为/后，静态资源就无法访问了。经过一些配置后，该问题也是可以解决的。

使用<mvc:default-servlet-handler/>

声明了 <mvc:default-servlet-handler /> 后， springmvc框架会在容器中创建DefaultServletHttpRequestHandler 处理器对象。它会像一个检查员，对进入 DispatcherServlet的 URL 进行筛查，如果发现是静态资源的请求，就将该请求转由 Web 应用服务器默认的Servlet 处理。一般的服务器都有默认的 Servlet。
在 Tomcat 中，有一个专门用于处理静态资源访问的 Servlet 名叫 DefaultServlet。其<servlet-name/>为 default。可以处理各种静态资源访问请求。该 Servlet 注册在 Tomcat 服务
器的 web.xml 中。在 Tomcat 安装目录/conf/web.xml。

项目：url-pattern-2。在项目 url-pattern 基础上修改。
只需要在 springmvc.xml 中添加<mvc:default-servlet-handler/>标签即可。

<mvc:default-servlet-handler/>表示使用 DefaultServletHttpRequestHandler 处理器对象。而该处理器调用了 Tomcat 的 DefaultServlet 来处理静态资源的访问请求。
当然了，要想使用<mvc: …/>标签，需要引入 mvc 约束

该约束可从 Spring 帮助文档中搜索关键字 spring-mvc.xsd 即可获取：
docs/spring-framework-reference/htmlsingle/index.html

使用<mvc:resources/>（掌握）

项目：url-pattern-3。在项目 url-pattern 基础上修改。

在 Spring3.0 版本后，Spring 定义了专门用于处理静态资源访问请求的处理器ResourceHttpRequestHandler。并且添加了<mvc:resources/>标签，专门用于解决静态资源无法访问问题。需要在 springmvc 配置文件中添加如下形式的配置：

location 表示静态资源所在目录。当然，目录不要使用/WEB-INF/及其子目录。
mapping 表示对该资源的请求（以 /images/ 开始的请求，如 /image/beauty.jpg ,/images/car.png 等）。注意，后面是两个星号**。

声明注解驱动

解决动态资源和静态资源冲突的问题，在 springmvc 配置文件加入：

SpringMVC系列

GitHub代码

zpeien

关注

1
点赞
踩
0

收藏

觉得还不错? 一键收藏
打赏
0
评论
SpringMVC系列之二------SpringMVC 注解式开发

SpringMVC系列之二------SpringMVC 注解式开发一、@RequestMapping 定义请求规则1、指定模块名称通过@RequestMapping 注解可以定义处理器对于请求的映射规则。该注解可以注解在方法上，也可以注解在类上，但意义是不同的。value 属性值常以“/”开始。 @RequestMapping 的 value 属性用于定义所匹配请求的 URI。但对于注解在方法上与类上，其 value 属性所指定的 URI，意义是不同的。一个@Controller 所注
复制链接

扫一扫