一、Spring MVC 数据绑定
数据绑定:在后台业务方法中,直接获取前端 HTTP 请求中的参数。
HTTP 请求传输的参数都是 String 类型的,Handler 业务方法中的参数是开发者指定的数据类型,int、Integer、Object等,因此需要进行数据类型转换。
Spring MVC 的 HandlerAdapter 组件会在执行 Handler 业务方法之前,完成参数的绑定,开发者直接使用即可。
1、基本数据类型
@RequestMapping("/baseType")
@ResponseBody
public String baseType(int id){
return "id:"+ id;
}
客户端 HTTP 请求中必须包含 id 参数,否则抛出 500 异常,因为 id 不能为 null。
同时 id 的值必须为数值且必须为整数,否则将抛出 400 异常。
@ResponseBody:
作用:将方法的返回值,以特定的格式写入到 response 的 body 区域,进而将数据返回给客户端。当方法上面没有写 ResponseBody, 底层会将方法的返回值封装为 ModelAndView 对象。如果返回值是字符串,那么直接将字符串写到客户端;如果是一个对象,会将对象转化为json串,然后写到客户端。
2、包装类
@RequestMapping("/packageType")
@ResponseBody
public String packageType(Integer id){
return "id:" + id;
}
如果 HTTP 请求中没有包含 id 参数,不会报错,id 的值就是null,会直接返回 id:null 给客户端。
但如果 id = a 或者 id = 1.5,同样会抛出 400 异常,因为数据类型无法匹配。
可以给参数列表添加 @RequestParam 注解,可以对参数进行相关设置。
@RequestMapping("/packageType")
@ResponseBody
public String packageType(@RequestParam(value="id", required = true, defaultValue = "0") Integer id){
return "id:" + id;
}
@RequestParam 注解:
- value=“id”:将 HTTP 请求中名为 id 的参数与 Handler 业务方法中的形参进行映射。
- required = true:表示 id 参数必填,false 表示非必填
- defaultValue= “0”:表示当 HTTP 请求中没有 id 参数时,形参的默认值为 0。
3、数组
@RequestMapping("/arrayType")
@ResponseBody
public String arrayType(String[] names){
StringBuffer stringBuffer = new StringBuffer();
for (String str: names) {
stringBuffer.append(str).append(" ");
}
return "names:" + stringBuffer.toString();
}
测试:
访问路径:http://localhost:8080/hello/arrayType?names=tom&names=andy&names=zhangsan
输出结果:
4、LIst
Spring MVC 不支持 List 类型的直接转换,需要包装成 Object。
List 的自定义包装类:
package com.southwind.pojo;
import lombok.Data;
import java.util.List;
@Data
public class UserList {
private List<User> users;
}
业务方法:
@RequestMapping("/listType")
@ResponseBody
public String listType(UserList users){
StringBuffer stringBuffer = new StringBuffer();
for (User user: users.getUsers()) {
stringBuffer.append(user);
}
return "用户:"+stringBuffer.toString();
}
JSP:
<%@ page contentType="text/html; charset=UTF-8" language="java" %>
<html>
<body>
<form action="/hello/listType" method="post">
用户1 ID:<input name="users[0].id" type="text"><br>
用户1姓名:<input name="users[0].name" type="text"><br>
用户2 ID:<input name="users[1].id" type="text"><br>
用户2姓名:<input name="users[1].name" type="text"><br>
用户3 ID:<input name="users[2].id" type="text"><br>
用户3姓名:<input name="users[2].name" type="text"><br>
<input type="submit" value="提交">
</form>
</body>
</html>
需要注意的是 User 类一定要有无参构造函数,否则会抛出异常。
5、JSON
JSP:
<%@ page contentType="text/html;charset=UTF-8" language="java" %>
<html>
<head>
<title>Title</title>
<script type="text/javascript" src="js/jquery.js"></script>
<script type="text/javascript">
$(function(){
var user = {
"id":1,
"name":"张三"
} ;
$.ajax({
url: "/hello/jsonType",
data: JSON.stringify(user),
type: "POST",
contentType: "application/json;charset=UTF-8",
dataType: "JSON",
success: function(data){
alert(data.id);
alert(data.name);
}
});
});
</script>
</head>
<body>
</body>
</html>
注意:
- JSON 数据必须用 JSON.stringify() 方法转换成字符串
- contentType:“application/json;charset=UTF-8”,不能省略
- 引入 jQuery 时,系统可能报错,原因是过滤器将 js 文件过滤掉了,解决方法,在 web.xml 文件中添加:
<servlet-mapping>
<servlet-name>default</servlet-name>
<url-pattern>*.js</url-pattern>
</servlet-mapping>`
带通配符时不可以加/
业务方法:
@PostMapping("/jsonType")
@ResponseBody
public String jsonType(@RequestBody User user){
System.out.println(user);
user.setId(2);
return user.toString();
}
@RequestBody 注解:
读取 HTTP 请求参数,通过 Spring MVC提供的 HttpMessageConverter 接口将读取的参数转为 JSON、XML 格式的数据,绑定到业务方法的形参
@ResponseBody 注解:
将业务方法返回的对象,通过 HttpMessageConverter 接口转为指定格式的数据,JSON、XML 等,响应给客户端。
需要使用过组件结合 @RequestBody 注解将 JSON 转为 Java Bean,这里使用 FastJson,其优势是如果属性为空就不会将其转为 JSON。
如何使用 FastJson
1、pom.xml 中添加 FastJson 相关依赖
<dependency>
<groupId>com.alibaba</groupId>
<artifactId>fastjson</artifactId>
<version>1.2.79</version>
</dependency>
2、springmvc.xml 中配置 FastJson。
<mvc:annotation-driven>
<mvc:message-converters>
<bean class="org.springframework.http.converter.StringHttpMessageConverter">
<property name="supportedMediaTypes" value="text/html;charset=UTF-8"></property>
</bean>
<!--fastjson-->
<bean class="com.alibaba.fastjson.support.spring.FastJsonHttpMessageConverter"></bean>
</mvc:message-converters>
</mvc:annotation-driven>