概要
上传下载主要分为2大类:根据是否指定Servlet分类,即:是否以“withServlet”结尾。 其中以“withServlet”结尾的API,适用于自主开发服务端代码的团队(推荐);后者指定url,适用于无法自主研发服务端代码、或者Servlet已经封版,不适合修改的团队。
1.uploadWithServlet
功能
文件上传,将文件(单个文件/批量文件)上传到指定Servlet上(推荐使用)。
定义
Mobile.uploadWithServlet(filePath, dataAction, param, callback, err);
参数
参数名 | 参数类型 | 参数描述 | 参数备注 |
---|---|---|---|
filePath | string/array | 上传文件路径 | 必传 |
dataAction | string | 服务端Servlet配置(server-data.xml) | 必传 |
params | map | 参数(若服务端不需要,传null) | 必传 |
callback | function | 执行成功后回调函数 | 选传 |
err | function | 执行失败后的回调函数 | 选传 |
范例
var picPath = "picture/my.png"; //文件保存名称
//var picPath = ["picture/my.png", "picture/your.jpeg"]; //文件保存名称
var uploadFile = $("#uploadFilePath").html(); //单文件 -> 字符串
//var uploadFile = ["/kevin/imgs/cat.jpg","/kevin/imgs/dog.jpg"];//多文件 -> 数组
var params = Wade.DataMap();
params.put("FILE_DIR", "USER_NAME"); //参数,用户名
params.put("FILE_PATH", picPath); //参数,文件保存名称
//params.put("FILE_PATH", picPath.toString()); //批量文件上传时,此处需要使用toString
WadeMobile.uploadWithServlet(uploadFile, "UploadDownloadBean.upload", params, function(result){
var data = new Wade.DataMap(result);
$("#remoteFilePath").html(data.get("FILE_PATH"));
});
备注
此接口的回调函数中,返回结果由服务端决定。
2.downloadWithServlet
功能
文件下载,将文件(单个)下载到指定路径(推荐使用);
定义
Mobile.downloadWithServlet(savePath,dataAction,param,callback,err);
参数
参数名 | 参数类型 | 参数描述 | 参数备注 |
---|---|---|---|
savePath | string | 下载文件路径(以“/”开头为绝对路径[只适用android] | 必传 |
dataAction | string | 服务端Servlet配置(server-data.xml) | 必传 |
params | map | 参数(若服务端不需要,传null) | 必传 |
callback | function | 执行成功后回调函数 | 选传 |
err | function | 执行失败后的回调函数 | 选传 |
范例
var picPath = "picture/cat.png";
var params = new Wade.DataMap();
params.put("USER_NAME", "John");
WadeMobile.downloadWithServlet(picPath, "UploadDownloadBean.download", params, function(savePath){
alert("下载成功,路径:" + savePath);
}, function(error){
alert("下载错误:"+error);
});
备注
此接口的回调函数中,包含下载文件在客户端存储的绝对路径。
3. uploadFile
功能
文件上传,将文件(单个文件/批量文件)上传到指定Servlet上。
定义
Mobile.uploadFile(filePath,servletUrl,callback,err);
参数
参数名 | 参数类型 | 参数描述 | 参数备注 |
---|---|---|---|
filePath | string | 上传文件路径 | 必传 |
servletUrl | string | 服务端Servlet地址(web.xml) | 必传 |
callback | function | 执行成功后回调函数 | 选传 |
err | function | 执行失败后的回调函数 | 选传 |
范例
var filePath = "C://picture/cat.png";
var servletUrl = "http://114.215.100.48:8080/display/mobiledata?action=UploadDownloadBean.upload";
WadeMobile.uploadFile(filePath, servletUrl, function(returnInfo){
alert("上传成功:" + returnInfo);
}, function(error){
alert("上传错误:"+error);
});
备注
此接口的回调函数中,返回结果由服务端决定。
此接口如果需要传参,请自行添加到请求串中。
4.downloadFile
功能
文件下载,将文件(单个)下载到指定路径;
定义
WadeMobile.downloadFile(servletUrl,savePath,callback,err);
参数
参数名 | 参数类型 | 参数描述 | 参数备注 |
---|---|---|---|
servletUrl | string | 服务端Servlet地址(web.xml) | 必传 |
savePath | string | 下载文件路径(以“/”开头为绝对路径[只适用android] | 必传 |
callback | function | 执行成功后回调函数 | 选传 |
err | function | 执行失败后的回调函数 | 选传 |
范例
IpuMobile.downloadFile(url,null,function(result){
if(result!="0") {
alert("下载失败");
}
});
备注
此接口的回调函数中,包含下载文件在客户端存储的绝对路径。
此接口如果需要传参,请自行添加到请求串中。