SpringMVC将传递的参数封装到处理器方法的形参中,达到快速访问参数的目的。
普通类型参数传参
参数名与处理器方法形参名保持一致
访问URL: http://localhost/requestParam1?name=itzhuzhu&age=14
@RequestMapping("/requestParam1")public String requestParam1(String name,Integer age){System.out.println(name+","+age);return "page.jsp";}
@RequestParam 的使用
-
类型: 形参注解
-
位置:处理器类中的方法形参前方
-
作用:绑定请求参数与对应处理方法形参间的关系,浏览器传username可以回传给name
访问URL: http://localhost/requestParam2?userName=itzhuzhu
@RequestMapping("/requestParam2")
public String requestParam2(@RequestParam(name = "userName",required = true,// 为true必须传参,否则报错defaultValue = "itzhuzhu") String name){System.out.println("name="+name);return "page.jsp";
}
POJO类型参数传参
当POJO中使用简单类型属性时, 参数名称与POJO类属性名保持一致
访问URL: http://localhost/requestParam3?name=itzhuzhu&age=14
实体类
public class User {private String name;private Integer age;
}
Controller
@RequestMapping("/requestParam3")
public String requestParam3(User user){System.out.println(user);return "page.jsp";
}
参数冲突问题
- 当POJO类型属性与其他形参出现同名问题时,将被同时赋值
- 建议使用
@RequestParam
注解进行区分
访问URL: http://localhost/requestParam4?name=itzhuzhu&age=14
@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.province=beijing
public class User {private String name;private Integer age;private Address addresses;
}public class Address {private String province;private String city;private String address;
}
@RequestMapping("/requestParam5")
public String requestParam5(User user){System.out.println("user.address="+user.getAddress().getProvince());return "page.jsp";
}
当POJO中出现集合,保存简单数据,使用多个相同名称的参数为其进行赋值
访问URL:http://localhost:8080/requestParam6?nick=aa&nick=bb&nick=cc
@RequestMapping("/requestParam6")public String requestParam6(User user){System.out.println(user);return "page.jsp";}
当POJO中出现List,保存对象数据,参数名称与对象层次结构名称保持一致,使用数组格式描述集合中对象的位置
访问URL: http://localhost/requestParam7?addresses[0].city=gz&addresses[1].province=gd
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("/requestParam7")
public String requestParam7(User user){System.out.println("user.addresses="+user.getAddress());return "page.jsp";
}
当POJO中出现Map,保存对象数据,参数名称与对象层次结构名称保持一致,使用映射格式描述集合中对象的位置
访问URL: http://localhost/requestParam8?addressMap[’home’].province=bj&addressMap[’job’].province=tj
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";
}
数组与集合类型参数传参
数组类型参数
请求参数名与处理器方法形参名保持一致,且请求参数数量> 1个
访问URL: http://localhost/requestParam9?nick=Jockme&nick=abcd
@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=abcd
@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才能识别该数据格式,并判定形参类型是否为数组或集合,并按数组或集合对象的形式操作数据。
类型转换器
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接口实现
Date类型转换问题,转换器只能识别/
类型的分隔符,如果换成2022-01-17的话就识别不了,可以通过设置转换器date类型解决
访问URL: http://localhost/requestParam11?2022/01/17
但是
@RequestMapping("/requestParam11")
public String requestParam11(Date date){System.out.println(date);return "page.jsp";
}
日期类型格式转换
声明自定义的转换格式并覆盖系统转换格式
<!--6.启用自定义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";
}
加在POJO上:
@DateTimeFormat(pattern = "yyyy-MM-dd")
private Date birthday;
注意:需要在SpringMVC配置文件中加上注解驱动标签 <mvc:annotation-driven/>
自定义类型转换器
- 自定义类型转换器,实现Converter接口,并制定转换前与转换后的类型
<!--1.将自定义Converter注册为Bean,受SpringMVC管理-->
<bean id="myDateConverter" class="com.itzhuzhu.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"/>
请求映射 @RequestMapping
- 当设置了公共的访问前缀后,当前路径发生了变化,需要根据变化修改地址或修改访问页面的路径
- 如果不在类上配置@RequestMapping,访问的是root路劲下的页面
- 如果在类上配置了@RequestMapping,访问的是root路径下的user路径下的页面
方法注解
- 名称: @RequestMapping
- 类型: 方法注解
- 位置:处理器类中的方法定义上方
- 作用:绑定请求地址与对应处理方法间的关系
- 访问URL:http://localhost:8080/requestParam13
@Controller
@RequestMapping("/user")
public class UserController {@RequestMapping("/requestParam13")public String requestParam13() {return "page.jsp";}
}
类注解
名称: @RequestMapping
- 类型: 类注解
- 位置:处理器类定义上方
- 作用:为当前处理器中所有方法设定公共的访问路径前缀
- 访问URL:http://localhost:8080/
user/requestParam14
- 如果返回的有图片,那么图片也要放在user包下
@Controller
@RequestMapping("/user")
public class UserController {@RequestMapping("/requestParam14")public String requestParam14() {return "page.jsp";// return "/page.jsp"; 如果类上配置了RequestMapping,在返回文件前加个/也是可以访问到的}
}
常用属性
@RequestMapping(value="/requestParam15", //设定请求路径,与path属性、 value属性相同method = RequestMethod.GET, //设定请求方式params = "name", //设定请求参数条件headers = "content-type=text/*", //设定请求消息头条件consumes = "text/*", //用于指定可以接收的请求正文类型(MIME类型)produces = "text/*" //用于指定可以生成的响应正文类型(MIME类型)
)
public String requestParam15() {return "/page.jsp";
}