使用APICloud编写优雅的HTML5代码《二》：ajax、文件上传

摘要: 对于ajax这个API而言，它实际上是有非常多的参数可供开发者选择的，以此满足各种特殊的需求，包括：url、method、cache、timeout、dataType、charset、headers、report、returnAll、data等等，用户可以根据实际情况，结合使用这些参数，来完成非常多的需求，如通常的访问WebService接口获取数据（GET）、提交表单（POST）、上传文件、下载文件等。一个简单的API却包含了非常强大的功能。

下面简单介绍各种类型请求的代码：

1、GET请求代码示例：

api.ajax({
url:'http://m.weather.com.cn/data/101010100.html'    //天气预报网站的WebService接口
},function(ret,err){
if (ret) {
api.alert({msg:JSON.stringify(ret)});
} else {
api.alert({msg:JSON.stringify(err)});
};
});

2、POST请求示例：

POST请求-Form表单提交：

api.ajax({
url: 'http://www.xxx.com/path/form',
method: 'post',
dataType: 'text',     //该参数若不传，则默认为json
data: {
values:{name: 'devlp', password: '123456'}       //键值对
}
},function(ret,err){
if (ret) {
api.alert({msg:JSON.stringify(ret)});
} else {
api.alert({msg:JSON.stringify(err)});
};
});

POST请求-单个/多个文件，文件组上传：

api.ajax({
url: 'http://www.xxx.com/path/upLoad',
method: 'post',
data: {
files:{myfile: 'filepath'}
// filepath来自ios或者Android的文件系统中的任意文件。可设置多个文件，甚至是文件数组，如files:{myfile: 'filepath', myfile1: 'filepath1'}或者files:{'myfile[]': ['filepath', 'filepath1']}等
}
},function(ret,err){
if (ret) {
api.alert({msg:JSON.stringify(ret)});
} else {
api.alert({msg:JSON.stringify(err)});
};
});

POST请求-提交二进制流：

api.ajax({
url: 'http://www.xxx.com/path/body',
method: 'post',
data: {
body:'textbits'
}
},function(ret,err){
if (ret) {
api.alert({msg:JSON.stringify(ret)});
} else {
api.alert({msg:JSON.stringify(err)});
};
});

POST请求-提交文件流：

api.ajax({
url: 'http://www.xxx.com/path/body',
method: 'post',
data: {
stream:'filepath'
// filepath来自ios或者Android的文件系统中的任意文件
}
},function(ret,err){
if (ret) {
api.alert({msg:JSON.stringify(ret)});
} else {
api.alert({msg:JSON.stringify(err)});
};
});

POST请求-Multipart-Data，文件和文本字段一起提交：

api.ajax({
url: 'http://www.xxx.com/path/multipart',
method: 'post',
data: {
values:{name: 'devlp', password: '123456'},
files:{file: 'fs://test.png'}
}
},function(ret,err){
if (ret) {
api.alert({msg:JSON.stringify(ret)});
} else {
api.alert({msg:JSON.stringify(err)});
};
});

POST请求-显示上传进度：

api.ajax({
url: 'http://www.xxx.com/path/multipart',
method: 'post',
report: true,
data: {
values:{name: 'devlp', password: '123456'},
files:{file: 'fs://test.png'}
}
},function(ret,err){
if(ret){
if(0 == ret.status){
//loading('进度：' + ret.progress);
}else{
api.alert({msg:'上传成功：\n' + JSON.stringify(ret)});
}
}else{
api.alert({msg:JSON.stringify(err)});
}
});

除此以外，put、delete、head等方式请求使用方式大同小异，在此不做详细叙述。