使用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等方式请求使用方式大同小异，在此不做详细叙述。