一.参数传递
1.普通参数类型
Spring MVC会自动将请求中的查询参数(如?name=John&age=25)映射到方法的参数上,要求参数名称和请求中的参数名称相同。
这里,name和age是请求中的参数,Spring会根据参数名自动将其值传递给对应的方法参数。
2.不同名称的参数传递
当请求参数名称和方法的参数名称不一致时,可以使用@RequestParam注解来手动指定请求参数和方法参数之间的映射关系。
例如,如果请求中的参数是name=John,但方法中的参数名是userName,通过@RequestParam("name")可以将name参数映射到userName。
3.POJO参数传递
Spring MVC支持将请求中的多个参数自动映射到一个POJO(Plain Old Java Object)对象中。当请求中包含多个参数,且参数名称与POJO类中的属性名称一致时,Spring会自动将这些值映射到对应的POJO字段。
例如,如果请求中有name=John&age=25,Spring会自动将这些值注入到User对象中,其中name和age对应User类的属性。
4.嵌套POJO参数传递
如果POJO类中的某个属性本身是一个POJO对象,Spring MVC会递归地将请求中的数据映射到嵌套的POJO对象。
例如,在请求中name=John&age=25&address.province=Beijing&address.city=Beijing,Spring会将address.province和address.city映射到User对象中的Address对象的province和city属性。
5.数组参数传递
Spring MVC支持将多个同名的请求参数(如likes=apple&likes=banana&likes=orange)自动映射到一个数组中。
如果请求中有多个likes参数,Spring会将它们转化为一个数组传递给控制器方法。
6.集合参数传递
Spring MVC支持将多个同名请求参数映射到一个集合(如List)。这类似于数组传递,但更灵活,因为集合可以动态扩展。
当请求中有多个likes参数时,Spring将其映射到一个List<String>对象中。
7.JSON格式的参数传递
通过@RequestBody注解,Spring MVC可以将请求中的JSON数据(如["apple", "banana"])自动转化为Java对象(如List<String>)。
@RequestBody注解使得Spring MVC能够处理JSON格式的请求体,并将其转换为方法参数所需的Java对象。为了实现JSON格式的自动转换,需要在配置类中开启@EnableWebMvc。
8.日期参数传递
Spring MVC支持将请求中的日期字符串转换为Date类型的方法参数。使用@DateTimeFormat注解可以指定日期格式。
在请求中传递date=2026-01-01,Spring会将其自动转换为Date对象。如果使用@DateTimeFormat指定格式,可以处理不同格式的日期字符串。
9.其他细节补充
(1)乱码处理
背景:在处理POST请求时,特别是表单提交或JSON数据提交,可能会出现中文字符乱码问题。这通常是因为请求的编码格式与服务器处理请求时的编码格式不一致导致的。
解决方法:Spring提供了CharacterEncodingFilter,用于解决这个问题。它确保了请求和响应在处理过程中都使用正确的字符编码。
filter.setEncoding("UTF-8"):指定字符编码为UTF-8。
filter.setForceEncoding(true):强制设置请求的编码为UTF-8,不管客户端传送的是什么编码。
(2)@EnableWebMvc:开启JSON自动转换
@EnableWebMvc是Spring MVC的注解,它用于启用Spring MVC的默认配置。这个注解不仅启用了Spring MVC的基础功能,还包括JSON数据类型的自动转换。使得Spring能够自动处理@RequestBody和@ResponseBody注解的请求,将请求的JSON数据自动映射到Java对象,或将Java对象转化为JSON响应。
(3)底层转化器:自动类型转换
Spring MVC中的@RequestBody、@DateTimeFormat等注解背后使用了Spring的数据绑定和类型转换机制。
数据绑定:Spring MVC会根据请求参数的名称自动将请求中的值绑定到控制器方法的参数上。如果控制器方法的参数是一个POJO对象,Spring会通过反射和字段名称自动进行匹配,映射请求参数到对象的属性。
类型转换:Spring为常见的类型(如日期、字符串、数字等)提供了默认的转换器。对于复杂的类型(如自定义的Date格式),你可以通过@DateTimeFormat来指定格式,Spring会使用相应的转换器进行类型转换。
二.响应
1.响应页面/跳转页面
当用户访问/toJumpPage路径时,控制器会返回一个页面跳转的指令。Spring会根据配置的视图解析器(如InternalResourceViewResolver)解析这个视图名,并查找WEB-INF目录下的page.jsp页面。如果访问/toJumpPage,浏览器会跳转到page.jsp页面
2.响应文本数据
当用户访问/toText路径时,控制器返回一个纯文本字符串作为响应。
@ResponseBody注解:此注解指示Spring MVC将方法的返回值直接写入HTTP响应体中,而不是解析为视图。返回字符串:返回的"response text"将作为纯文本响应返回给客户端,浏览器将显示该文本。
3.响应POJO对象(返回JSON格式)
当用户访问/toJsonPOJO路径时,控制器返回一个User对象,该对象会被转换成JSON格式返回给客户端。
@ResponseBody注解:指示Spring MVC将返回的User对象转换为JSON格式并直接写入HTTP响应体中。JSON格式:Spring会自动使用Jackson(或其他JSON处理库)将User对象转换为JSON格式。
4.响应POJO集合对象(返回JSON数组)
当用户访问/toJsonList路径时,控制器返回一个包含多个User对象的集合(List<User>)。这个集合会被转换为JSON数组格式返回给客户端。
返回List<User>:控制器方法返回一个List集合,包含多个User对,@ResponseBody注解:同样地,@ResponseBody注解确保Spring MVC将返回的List<User>集合转换为JSON格式并写入响应体。
5.其他细节
在Spring MVC中,HttpMessageConverter是一个非常重要的接口,它负责将HTTP请求和响应的消息体(即请求体和响应体)转换为Java对象,或者将Java对象转换为HTTP消息体。这使得Spring MVC能够处理不同格式的数据,如JSON、XML、纯文本等。
(1)什么是HttpMessageConverter
HttpMessageConverter是Spring MVC用于将HTTP请求和响应的数据与Java对象进行转换的机制。它有两种主要功能:
将请求体(Request Body)转换为Java对象(例如,将JSON字符串转换为Java对象)。
将Java对象转换为响应体(Response Body)(例如,将Java对象转换为JSON格式的响应)。
(2)常见的HttpMessageConverter实现
Spring MVC提供了很多内置的HttpMessageConverter实现,支持常见的数据格式。以下是一些常见的实现:
MappingJackson2HttpMessageConverter:用于处理JSON格式的转换,基于Jackson库。Jaxb2RootElementHttpMessageConverter:用于处理XML格式的转换,基于JAXB。StringHttpMessageConverter:用于处理字符串的转换。FormHttpMessageConverter:用于处理表单数据的转换。ByteArrayHttpMessageConverter:用于处理字节数组数据的转换。