【愚公系列】2023年06月 Java教学课程 136-Spring MVC框架的Request请求详解

一、请求

Spring MVC框架的Request请求是指用户向服务器发送的请求，包括请求的URL、请求参数、请求头等信息。在Spring MVC框架中，可以使用@RequestParam注解来获取请求参数，使用@RequestHeader注解来获取请求头信息。

1.普通类型参数传参

参数名与处理器方法形参名保持一致

访问URL： http://localhost/requestParam1?name=itheima&age=14

@RequestMapping("/requestParam1")
public String requestParam1(String name ,String age){
System.out.println("name="+name+",age="+age);
return "page.jsp";
}

@RequestParam 的使用

• 类型： 形参注解

• 位置：处理器类中的方法形参前方

• 作用：绑定请求参数与对应处理方法形参间的关系

访问URL： http://localhost/requestParam2?userName=Jock

@RequestMapping("/requestParam2")
public String requestParam2(@RequestParam(
name = "userName",
required = true,
defaultValue = "itheima") String name){

System.out.println("name="+name);
return "page.jsp";
}

2.POJO类型参数传参

当POJO中使用简单类型属性时， 参数名称与POJO类属性名保持一致

访问URL： http://localhost/requestParam3?name=Jock&age=39

Controller

@RequestMapping("/requestParam3")
public String requestParam3(User user){
System.out.println("name="+user.getName());
return "page.jsp";
}

POJO类

public class User {
private String name;
private Integer age;

public String getName() {
return name;
}

public void setName(String name) {
this.name = name;
}

public Integer getAge() {
return age;
}

public void setAge(Integer age) {
this.age = age;
}

}

参数冲突

• 当POJO类型属性与其他形参出现同名问题时，将被同时赋值

• 建议使用@RequestParam注解进行区分

• 访问URL： http://localhost/requestParam4?name=Jock&age=39

@RequestMapping("/requestParam4")
public String requestParam4(User user,String age){
System.out.println("user.age="+user.getAge()+",age="+age);
return "page.jsp";
}

复杂POJO类型参数

• 当POJO中出现对象属性时，参数名称与对象层次结构名称保持一致

访问URL： http://localhost/requestParam5?address.city=beijing

public class User {
private String name;
private Integer age;

private Address address;

public Address getAddress() {
return address;
}

public void setAddress(Address address) {
this.address = address;
}

public String getName() {
return name;
}

public void setName(String name) {
this.name = name;
}

public Integer getAge() {
return age;
}

public void setAge(Integer age) {
this.age = age;
}

}

@RequestMapping("/requestParam5")
public String requestParam5(User user){
System.out.println("user.address="+user.getAddress().getProvince());
return "page.jsp";
}

当POJO中出现List，保存对象数据，参数名称与对象层次结构名称保持一致，使用数组格式描述集合中对象的位置

访问URL：http://localhost/requestParam6?nick=Jock1&nick=Jockme&nick=zahc
访问URL： [http://localhost/requestParam7?addresses [0].city=beijing&addresses[1].province=hebei](http://localhost/requestParam7?addresses%5B0%5D.city=beijing&addresses%5B1%5D.province=hebei )

public class User {
private String name;
private Integer age;
private List<Address> addresses;
}

public class Address {
private String province;
private String city;
private String address;
}

@RequestMapping("/requestParam6")
public String requestParam6(User user){
System.out.println(user);
return "page.jsp";
}
@RequestMapping("/requestParam7")
public String requestParam7(User user){
System.out.println("user.addresses="+user.getAddress());
return "page.jsp";
}

当POJO中出现Map，保存对象数据，参数名称与对象层次结构名称保持一致，使用映射格式描述集合中对象的位置

访问URL： [http://localhost/requestParam8?addressMap ['job'].city=beijing&addressMap['home'].province=henan](http://localhost/requestParam8?addressMap%5B%27job%27%5D.city=beijing&addressMap%5B%27home%27%5D.province=henan )

public class User {
private String name;
private Integer age;
private Map<String,Address> addressMap;
}
public class Address {
private String province;
private String city;
private String address;
}

@RequestMapping("/requestParam8")
public String requestParam8(User user){
System.out.println("user.addressMap="+user.getAddressMap());
return "page.jsp";
}

3.数组与集合类型参数传参

数组类型参数

请求参数名与处理器方法形参名保持一致，且请求参数数量＞ 1个

访问URL： http://localhost/requestParam9?nick=Jockme&nick=zahc

@RequestMapping("/requestParam9")
public String requestParam9(String[] nick){
System.out.println(nick[0]+","+nick[1]);
return "page.jsp";
}

集合类型参数
保存简单类型数据，请求参数名与处理器方法形参名保持一致，且请求参数数量＞ 1个
访问URL：http://localhost/requestParam10?nick=Jockme&nick=zahc

@RequestMapping("/requestParam10")
public String requestParam10(@RequestParam("nick") List<String> nick){
System.out.println(nick);
return "page.jsp";
}

注意： SpringMVC默认将List作为对象处理，赋值前先创建对象，然后将nick作为对象的属性进行处理。由于List是接口，无法创建对象，报无法找到构造方法异常；修复类型为可创建对象的ArrayList类型后，对象可以创建，但没有nick属性，因此数据为空。此时需要告知SpringMVC的处理器nick是一组数据，而不是一个单一数据。通过@RequestParam注解，将数量大于1个names参数打包成参数数组后， SpringMVC才能识别该数据格式，并判定形参类型是否为数组或集合，并按数组或集合对象的形式操作数据。

小节

• 请求POJO类型参数获取

• POJO的简单属性

• POJO的对象属性

• POJO的集合属性（存储简单数据）

• POJO的集合属性（存储对象数据）

• 名称冲突问题

4.类型转换器

SpringMVC对接收的数据进行自动类型转换，该工作通过Converter接口实现

• 标量转换器

StringToBooleanConverter String→Boolean
ObjectToStringConverter Object→String
StringToNumberConverterFactory String→Number（ Integer、 Long等）
NumberToNumberConverterFactory Number子类型之间(Integer、 Long、 Double等)
StringToCharacterConverter String→java.lang.Character
NumberToCharacterConverter Number子类型(Integer、 Long、 Double等)→java.lang.Character
CharacterToNumberFactory java.lang.Character→Number子类型(Integer、 Long、 Double等)
StringToEnumConverterFactory String→enum类型
EnumToStringConverter enum类型→String
StringToLocaleConverter String→java.util.Local
PropertiesToStringConverter java.util.Properties→String
StringToPropertiesConverter String→java.util.Properties

• 集合、数组相关转换器

ArrayToCollectionConverter 数组→集合（ List、 Set）
CollectionToArrayConverter 集合（ List、 Set） →数组
ArrayToArrayConverter 数组间
CollectionToCollectionConverter 集合间（ List、 Set）
MapToMapConverter Map间
ArrayToStringConverter 数组→String类型
StringToArrayConverter String→数组， trim后使用“,”split
ArrayToObjectConverter 数组→Object
ObjectToArrayConverter Object→单元素数组
CollectionToStringConverter 集合（ List、 Set） →String
StringToCollectionConverter String→集合（ List、 Set）， trim后使用“,”split
CollectionToObjectConverter 集合→Object
ObjectToCollectionConverter Object→单元素集合

• 默认转换器

ObjectToObjectConverter Object间
IdToEntityConverter Id→Entity
FallbackObjectToStringConverter Object→String

• SpringMVC对接收的数据进行自动类型转换，该工作通过Converter接口实现

5.日期类型格式转换

• 声明自定义的转换格式并覆盖系统转换格式

<!--5.启用自定义Converter-->
<mvc:annotation-driven conversion-service="conversionService"/>
<!--1.设定格式类型Converter，注册为Bean，受SpringMVC管理-->
<bean id="conversionService"
class="org.springframework.format.support.FormattingConversionServiceFactoryBean">
<!--2.自定义Converter格式类型设定，该设定使用的是同类型覆盖的思想-->
<property name="formatters">
<!--3.使用set保障相同类型的转换器仅保留一个，避免冲突-->
<set>
<!--4.设置具体的格式类型-->
<bean class="org.springframework.format.datetime.DateFormatter">
<!--5.类型规则-->
<property name="pattern" value="yyyy-MM-dd"/>
</bean>
</set>
</property>
</bean>

• 日期类型格式转换（简化版）

• 名称： @DateTimeFormat

• 类型： 形参注解、成员变量注解

• 位置：形参前面 或 成员变量上方

• 作用：为当前参数或变量指定类型转换规则

范例：

public String requestParam12(@DateTimeFormat(pattern = "yyyy-MM-dd") Date date){
System.out.println("date="+date);
return "page.jsp";
}

@DateTimeFormat(pattern = "yyyy-MM-dd")
private Date birthday;

• 注意：依赖注解驱动支持

<mvc:annotation-driven />

6.自定义类型转换器

• 自定义类型转换器，实现Converter接口，并制定转换前与转换后的类型

<!--1.将自定义Converter注册为Bean，受SpringMVC管理-->
<bean id="myDateConverter" class="com.itheima.converter.MyDateConverter"/>
<!--2.设定自定义Converter服务bean-->
<bean id="conversionService"
class="org.springframework.context.support.ConversionServiceFactoryBean">
<!--3.注入所有的自定义Converter，该设定使用的是同类型覆盖的思想-->
<property name="converters">
<!--4.set保障同类型转换器仅保留一个，去重规则以Converter<S,T>的泛型为准-->
<set>
<!--5.具体的类型转换器-->
<ref bean="myDateConverter"/>
</set>
</property>
</bean>

//自定义类型转换器，实现Converter接口，接口中指定的泛型即为最终作用的条件
//本例中的泛型填写的是String，Date，最终出现字符串转日期时，该类型转换器生效
public class MyDateConverter implements Converter<String, Date> {
//重写接口的抽象方法，参数由泛型决定
public Date convert(String source) {
DateFormat df = new SimpleDateFormat("yyyy-MM-dd");
Date date = null;
//类型转换器无法预计使用过程中出现的异常，因此必须在类型转换器内部捕获，不允许抛出，框架无法预计此类异常如何处理
try {
date = df.parse(source);
} catch (ParseException e) {
e.printStackTrace();
}
return date;
}
}

• 通过注册自定义转换器，将该功能加入到SpringMVC的转换服务ConverterService中

<!--开启注解驱动，加载自定义格式化转换器对应的类型转换服务-->
<mvc:annotation-driven conversion-service="conversionService"/>

7.请求映射 @RequestMapping

7.1 方法注解

• 名称： @RequestMapping

• 类型： 方法注解

• 位置：处理器类中的方法定义上方

• 作用：绑定请求地址与对应处理方法间的关系

范例：
访问路径： /requestURL1

@Controller
@RequestMapping("/user")
public class UserController {
@RequestMapping("/requestURL2")
public String requestURL2() {
return "page.jsp";
}
}

7.2 类注解

名称： @RequestMapping

• 类型： 类注解

• 位置：处理器类定义上方

• 作用：为当前处理器中所有方法设定公共的访问路径前缀

范例：
访问路径： /user/requestURL1

@Controller
@RequestMapping("/user")
public class UserController {
@RequestMapping("/requestURL2")
public String requestURL2() {
return "page.jsp";
}
}

• 常用属性

@RequestMapping(
value="/requestURL3", //设定请求路径，与path属性、 value属性相同
method = RequestMethod.GET, //设定请求方式
params = "name", //设定请求参数条件
headers = "content-type=text/*", //设定请求消息头条件
consumes = "text/*", //用于指定可以接收的请求正文类型（MIME类型）
produces = "text/*" //用于指定可以生成的响应正文类型（MIME类型）
)
public String requestURL3() {
return "/page.jsp";
}