ajax发送请求下载字节流形式的excel文件

背景

开发项目中导出功能,因为数据量有点大,所以导出可能需要时间有点长,所以想用ajax异步请求。

存在问题

利用传统的js和jquery提供的ajax相关获取响应的方式是无法实现excel文件下载的。

js的XMLHttpRequest对象提供了responseText和responseXML两个属性,获取的是html和xml文件格式,没有提供二进制流获取的方式。参考

jquery提供了$.ajax()方法中返回的响应结果类型包括xml,html,script,json,jsonp,text,其中也没有二进制流文件格式。参考

解决办法

    原生开发

当原生开发的时候,就要依靠操作XMLHttpRequest对象来获取响应的二进制流。经过百度我发现虽然这个对象没有提供直接获取流的属性,但是它的文档中responseType是可以返回一个Blob对象的。而Blob对象就是一个二进制数据的对象,只要我们获取到这个对象,就可以通过浏览器获取到需要的excel文件。

代码:

$('.exportBtn').bind("click", function () {
var method = 'post';//请求方法
var url = 'http://localhost.....';//请求url
var xhr = new XMLHttpRequest();//定义一个XMLHttpRequest对象
xhr.open(method, url, true);
xhr.responseType = 'blob';//设置ajax的响应类型为blob
xhr.setRequestHeader('Content-Type', 'application/json;charset=utf-8');
xhr.onload = function ()//当请求完成,响应就绪进入
{
if (this.status == 200)//当响应状态码为200时进入
{
var blob = this.response;//获取响应返回的blob对象
//这一段用来判断是否是IE浏览器,因为下面有些代码不支持IE
if (typeof window.navigator.msSaveBlob !== 'undefined') {
window.navigator.msSaveBlob(blob, "NPI_PROJECT.xlsx");
return;
}
var a = document.createElement('a');//在dom树上创建一个a标签
var url = window.URL.createObjectURL(blob);//我的理解是生成一个相对于浏览器的虚拟url,用于指向传入的blob对象,让浏览器可以通过这个url找到这个blob对象
a.href = url;//将url赋值给a标签的href属性
a.download = 'NPI_PROJECT.xlsx';//设置设置下载文件的名称
a.click();//主动触发a标签点击事件
}
};
xhr.send(JSON.stringify({
name: '',
status: ''
}));//附带参数发送请求
});

    

  jquery插件开发 -->jquery.fileDownload

  用这个插件是最简单的

  

$('.exportBtn').bind("click", function () {
var httpMethod = 'post';
var url = "http://localhost.....";
var params = {
name: '',
status: ''
};
$.fileDownload(url, {
httpMethod: httpMethod,
// 因为这个插件貌似只支持URL参数,所以要用jquery param将js对象转成URL参数
data: $.param(params),
prepareCallback: function (url) {
console.log("正在导出...");
},
//要想成功回调失败和成功方法,要在响应首部加 response.setHeader("Set-Cookie", "fileDownload=true; path=/");
successCallback: function (url) {
console.log("导出成功");
},
failCallback: function (html, url) {
console.log("导出失败");
}
})

tips:

1.如果成功失败回调函数没有生效,一定要确认响应首部是否添加成功。因为我遇到一个情况,我先写响应流,然后添加首部发现没有添加成功。 

2.fileDownload的data参数貌似只支持URL格式参数(如name=1&age=12),我尝试传json和js对象都没有成功。而且控制器不要使用@Requestbody接受参数,因为这个注解只接受请求体中的JSON格式参数。

参考

jquery.param文档

jquery.fileDownload问答

原文地址:https://www.cnblogs.com/qingshan-tang/p/12367311.html