jQuery.ajax( options )中重要参数设置
jQuery.ajax( options ) : 通过 HTTP 请求加载远程数据。通过jquery.ajax与SpringMVC的Controller交互时候,需要关注以下几个参数(一个典型的ajax请求代码如下):
$.ajax({
type: "POST",
url: "$!{_index}/buAuth/save4",
data:JSON.stringify(dataObj) ,
contentType: "application/json; charset=utf-8",
dataType: "json",
success: function (response, ifo) {}
contentType
参数类型:String
说明:(默认: “application/x-www-form-urlencoded”) 发送信息至服务器时内容编码类型。默认值适合大多数应用场合。告诉服务器从浏览器提交过来的数据格式。
例如:我们提交数据时假如使用了 JSON2.js 中方法 JSON.stringify(obj) 格式化为json字符串后,再默认提交就会报错。这个时候就需要指定提交的内容格式为:”application/json”。
参数类型:Object,String
说明:发送到服务器的数据。若data数据类型为JavaScript对象或数组,Jquery在提交之前自动调用JQuery.param()方法把要发送的数据编码成为”application/x-www-form-
urlencoded”格式的数据(即 name=value&name1=value1),此时参数为Object并且必须为
Key/Value 格式;如果为数组,jQuery 将自动为不同值对应同一个名称。如 {foo:[“bar1”, “bar2”]} 转换为
‘&foo=bar1&foo=bar2’;
若data数据类型为String类型,则直接默认该数据已经按照”application/x-www-form-urlencoded”格式编码完成,不再转换。
dataType
参数类型:String
说明:预期服务器返回的数据类型。设定HttpHeader中“Accept”域的内容,告诉服务器浏览器可以想要返回的数据格式类型,同时JQuery也会根据该类型对返回的数据进行处理。如果不指定,jQuery
将自动根据 HTTP 包 MIME 信息返回 responseXML 或 responseText,并作为回调函数参数传递,可用值:
“xml”: 返回 XML 文档,可用 jQuery 处理。
“html”: 返回纯文本 HTML 信息;包含 script 元素。
“script”: 返回纯文本 JavaScript 代码。不会自动缓存结果。
“json”: 返回 JSON 数据 。JQuery将返回的字符串格式数据自动转化为Javascript对象,便于直接使用obj.property格式访问。若没有指定该选项,即使返回的是JSON格式的字符串,JQuery也不会自动转换。
“jsonp”: JSONP 格式。使用 JSONP 形式调用函数时,如 “myurl?callback=?” jQuery 将自动替换 ? 为正确的函数名,以执行回调函数。
var params = {};
//params.XX必须与Spring Mvc controller中的参数名称一致
// 否则在controller中使用@RequestParam绑定
params.num = num;
params.id = id;
params.amount = amount;
$.ajax({
async: false,
type: "POST",
url: "price/update",//注意路径
data: params,
dataType: "json",
success: function (data) {
if (data.result == 'SUCCESS') {
alert("修改成功");
} else {
alert("修改失败,失败原因【" + data + "】");
}, error: function (data) {
alert(data.result);
controller接收数据
@RequestMapping("update")
@ResponseBody //此注解不能省略 否则ajax无法接受返回值
public Map<String, Object> update(Long num, Long id, BigDecimal amount) {
Map<String, Object> resultMap = new HashMap<String, Object>();
if (num == null || id == null || amount == null) {
resultMap.put("result", "参数不合法!");
return resultMap;
} //xxx逻辑处理
resultMap.put("result", "result");
return resultMap;
采用这种方式接受参数,其底层实现原理类似于request. getParameter()获得参数,注意:如果地址栏/price/update上面没有传递参数,当id为Long的时候值为null,那么当id为long型的时候会报错.
当采用地址栏为/price/update?id=10的访问方式时候,参数附加在Url的后面,此时Controller中有三种接收方式
1.String save (@RequestParam(value=”userid”)Integer id),这样会把地址栏参数名为userid的值赋给参数id,如果用地址栏上的参数名为id,则接收不到
2. String save (@RequestParam Integer id),这种情况下默认会把id作为参数名来进行接收赋值
3.String save (Integer id),这种情况下也会默认把id作为参数名来进行接收赋值
注:如果参数前面加上@RequestParam注解,如果地址栏上面没有加上该注解的参数,例如:id,那么会报404错误,找不到该路径。
当采用Ajax请求方式时候,需设置两两处:
(1)设置contentType的参数值为:application/x-www-form-urlencoded(该值即为默认值,也可以不设置);
(2)请求参数data必须为js对象。此时由上文Ajax参数说明可知jQuery自动调用JQuery.param()方法把要发送的数据组织成类似于application/x-www-form-urlencoded(即name=value&name1=value1),然后在Controller中SpringMVC框架自动把对应的值注入到与之对应的参数中。
(3)可以采用这种方式传递多个对象,把每个对象在前端转换为JSON字符串映射到Controller对应的方法参数上,然后在函数体里分别进行解析获得到不同的对象,从而达到传递多个对象的效果。
(4)当Controller的方法参数为实体类时,采用这种方式同样能够自动注入到参数的实体类中
1.2、controller中参数是实体bean,bean中属性都是基本数据类型
var params = {};
params.num = $("#num").val();
params.id = $("#id").val();//注意params.名称 名称与实体bean中名称一致
$.ajax({
type: "POST",
url: "price/add",
data: params,
dataType: "json",
// contentType: "application/json; charset=utf-8",//此处不能设置,否则后台无法接值
success: function (data) {
if (data.msg != "") {
alert(data.msg);
}, error: function (data) {
alert("出现异常,异常原因【" + data + "】!");
实体bean
public class DataVo {
private Long num;
private String id;
public Long getNum() {
return num;
public void setNum(Long num) {
this.num = num;
public String getId() {
return id;
public void setId(String id) {
this.id = id;
controller
@RequestMapping("add")
@ResponseBody //此处不能省略 否则ajax无法解析返回值
public Map<String, Object> add(DataVo dataVo) {
Map<String, Object> result = null;
if (dataVo.getNum() == null || StringUtils.isBlank(dataVo.geId())) {
result = new HashMap<String, Object>();
result.put("msg", "参数不合法!");
return result;
//xxx业务逻辑处理
return result;
1.3、controller中参数是实体bean,bean中属性有数组
jquery ajax 需要进行json序列化,jQuery自带json序列化插件
JSON.stringify()将json对象转换为json字符串传递。
json对象:{"id":"1", "name": "Roger"}
json字符串:'{"id":"1", "name": "Roger"}'
注意:json字符串必须在里面使用双引号,外面使用单引号
使用JSON.stringify()就可以不考虑json字符串中的 ' 和 " 问题,如果不使用这个就得注意json字符串的方式,如下:data:'{"id":"1", "name": "Roger"}' 里面需要使用双引号
需要注意在ajax参数配置如下:
datatype:"json",
contentType: "application/json; charset=utf-8",
var params = {};
params.nums = [];
params.id = $("#id").val();//parmas.参数名 注意与实体bean参数名称相同
for (var i = 0; i < prices.length; i++) {
params.nums[i] = prices[i].value;
$.ajax({
type: "POST",
url: "price/add",
data: JSON.stringify(params),//json序列化
datatype: "json", //此处不能省略
contentType: "application/json; charset=utf-8",//此处不能省略
success: function (data) {
alert(data);
}, error: function (data) {
alert(data)
实体bean
public class DataVo {
private BigDecimal[] nums;
private String id;
public Long getId() {
return id;
public void setId(Long id) {
this.id = id;
public BigDecimal[] getNums() {
return nums;
public void setNums(BigDecimal[] nums) {
this.nums = nums;
controller
@RequestMapping("add")
@ResponseBody//此处不能省略 否则ajax无法解析返回值
public Map<String, Object> add(@RequestBody DataVo dataVo) {//@RequestBody注解不能省略,否则无法接值
Map<String, Object> resultMap = new HashMap<String, Object>();
//业务逻辑处理
return resultMap;
采用@RequestBody标注的参数,SpringMVC框架底层能够自动完成JSON字符串转对应的Bean并注入到方法参数中,主要是通过使用HandlerAdapter 配置的HttpMessageConverters来解析post data body,然后绑定到相应的bean上的。此时Ajax发送的data值必须为Json字符串,如果Controller中需要映射到自定义Bean对象上上,则必须设置Ajax的contentType为application/json(或application/xml)。
2、Ajax接收SpringMVC的回传值
var standard = {"id":1, "entities":"entities", "possibleEntities":"possibleEntities"};
$.ajax({
url: "${ctx}/StdManage/testJson",
type: "POST",
dataType: "json",
contentType: "application/json",
data: JSON.stringify(standard),
success:function(data){
// 接收List
alert(data[0]);
// 接收Map
// alert(data.success);
controller
@RequestMapping("/testJson")
@ResponseBody
public List<String> testJson(@RequestBody StandardWithBLOBs standardWithBLOBs) {
System.out.println("testJson");
System.out.println(standardWithBLOBs.getId());
// Map<String, Object> map = new HashMap<>();
// map.put("success", true);
// return map;
List<String> list = new ArrayList<>();
list.add("hello");
list.add("word");
return list;