有时候参数的传递还需要更多的参数，比如一个获取用户信息的请求中既有用户ID等基本参数，还要求对查询结果进行分页，针对这种场景，一般都会将分页参数封装成一个对象，然后将它和基本参数一起传给控制器，为了控制器方便接受，我们可以将这些所有的请求参数封装成一个json对象进行传递。现在我进行一个以下场景的实例：通过页面输入参数id和名称，然后从param表中获取id大于参数id，名称中包含参数名称字样的结果，并将结果分页，只获取20条数据。我已经在数据库中插入了相关数据，并且只有ID不一致，其他的都一样，如下图所示：
下面创建代码
1、创建前端页面
<%@ page language="java" contentType="text/html; charset=UTF-8"
pageEncoding="UTF-8"%>
<!DOCTYPE html PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
<html>
<head>
<meta http-equiv="Content-Type" content="text/html; charset=UTF-8">
<%
String root = request.getContextPath();
String basePath = request.getScheme() + "://" + request.getServerName() + ":" + request.getServerPort()
+ root + "/";
%>
<script type="text/javascript"
src="<%=basePath%>jslib/jquery-1.8.3.min.js"></script>
<script type="text/javascript" src="<%=basePath%>jslib/jquery.form.js"></script>
<script type="text/javascript" src="<%=basePath%>js/param.js"></script>
<link href="<%=basePath%>css/param.css" type="text/css" rel="stylesheet">
<title>Insert title here</title>
</head>
<body>
<div class="param">
<!--使用JSON传递参数 -->
<div class="public json">
<p style="text-align: center;">JSON方式传递参数</p>
<form id="jsonForm">
<table id="jsonTable">
<tr>
<td>id：</td>
<td><input type="text" name="id" value=""></td>
</tr>
<tr>
<td>名称：</td>
<td><input type="text" name="name" value=""></td>
</tr>
<tr>
<td></td>
<td style="text-align: right;"><input type="button"
value="提交" id="setJsonParam"></td>
</tr>
</table>
</form>
</div> </body>
</html>
页面效果如下：
2、给提交按钮绑定事件
点击提交的时候，向后台发起请求，请求的参数是一个json;
$(function() {
/* json方式传递数据 */
/* 注意⚠️：json参数必须和类PageParam的属性一一对应 */
$("#setJsonParam").click(function() {
var data = {
paramId : $("#jsonForm input[name=id]").val(),
paramName : $("#jsonForm input[name=name]").val(),
page : {
start : 0,
limit : 20
}
}
$.ajax({
url : "./jsonParam",
type : "POST",
/* 此处需要定义传递参数的类型为json */
contentType : "application/json",
/* 将json转化为字符串 */
data : JSON.stringify(data),
success : function(data) {
var size = data.paramList.length;
var html = "<tr><td>总数：</td><td>" + size + "</td></tr>";
$("#jsonTable").append(html);
}
});
});
});
注意上面代码中加粗标红的部分：
- 变量data是个json数据，它有三个属性分别是paramId、paramName、page，而page又有两个属性start和limit，代表起始页和该页的数量；
- ajax请求的时候，数据类型需要定义为json格式；
- 传递参数时需要将json转化为字符串
根据上面的介绍，下一步需要创建json类。
3、创建json参数类
需要两步：
1⃣️创建分页类
package com.mvc.pojo; /*
* 分页类
*/
public class Page {
public int start;
public int limit; public int getStart() {
return start;
} public void setStart(int start) {
this.start = start;
} public int getLimit() {
return limit;
} public void setLimit(int limit) {
this.limit = limit;
}
}
2⃣️封装所有参数类
该类中包含参数paramId、paramName和page
package com.mvc.pojo; /*
* 分页参数类
*/
public class PageParam { private int paramId;
private String paramName; private Page page; public Page getPage() {
return page;
} public void setPage(Page page) {
this.page = page;
} public int getParamId() {
return paramId;
} public void setParamId(int paramId) {
this.paramId = paramId;
} public String getParamName() {
return paramName;
} public void setParamName(String paramName) {
this.paramName = paramName;
} }
通过上面两步就封装好了请求参数，下面需要创建控制器进行获取。
4、创建控制器
@Controller
@RequestMapping("/param")
public class ParamController { @Autowired
@Qualifier("paramService")
ParamService paramService = null;
/**
* 通过json获取参数
*
* @param id
* @param name
* @return
*/
@RequestMapping(value = "jsonParam")
public ModelAndView getParamByJson(@RequestBody PageParam pageParam) {
ModelAndView mv = new ModelAndView();
List<Param> paramList = paramService.getParam(pageParam);
mv.addObject(paramList);
mv.setView(new MappingJackson2JsonView());
return mv;
}
｝
上面代码中红色加粗部分：
- 注解RequestBody用来接受json参数
- paramService.getParam(pageParam);封装了一个从数据库中查询的方式，相当于服务端分页，具体的代码不贴了，看一下关键SQL吧：
<select id="getParamByPaging" parameterType="com.mvc.pojo.PageParam"
resultMap="BaseResultMap">
SELECT * FROM param
WHERE param_id >
#{paramId,jdbcType=INTEGER}
AND param_name like
concat('%',#{paramName,jdbcType=VARCHAR},'%')
LIMIT
#{page.limit,jdbcType=INTEGER}
OFFSET
#{page.start,jdbcType=INTEGER}
</select>
上面代码中红色加粗的部分：
- 参数类型，就是刚才封装的哪个分页参数类；
- 基本参数就是类中的参数名；
- 针对分页参数，获取其属性值的时候，不需要get方式，直接通过*.*的方式，前一个星号表示传递过来的封装类中的对象属性，后一个参数是这个对象属性中的属性值，比如分页类Page中的页数start和页大小limit
至此，所有代码已经完成，下面进行测试。
5、测试
在页面输入如下参数
点击提交之后的结果如下：
这里直接打印的是总的查询结果，为了验证是否正确在数据库中执行SQL看一下,执行之前先看一下传递的参数值是多少：
从控制台可以看出各个参数，SQL语句及执行结果如下：
可以看到和页面显示的是一致的，所以说控制器获取参数成功。
六、总结
使用JSON传递参数时需要注意以下几点：
- 传递的json数据需要和对应参数的pojo保持一致。其实这种类型跟pojo方式很像，只不过pojo方式中参数对应的pojo没有引用类型的属性罢了。
- 在请求的时候要告知请求的参数类型为JSON;
- 传递参数时需要将JSON数据转化成字符串；
- 在mapper中获取参数值时，基本类型引用的参数名就是pojo中的参数，而引用类型中的参数只需要通过pojo中的引用变量名.属性名的方式，而不是对应的get方法；