Baidu云盘【文件API】接口学习 『一』

来源:互联网 时间:1970-01-01

这几天很有兴致的学习了百度云盘文件API接口的使用;初步是想做一个在线android应用,应用中的文档是存放在百度云盘的。

主要是分一下几个步骤:

1.注册百度账号

2.登录百度开发者中心

3.创建移动应用,获取对应的(API Key   Secret Key)

4.开通pcs API权限

5.获取ACCESS_token(认证编码)

6.开发应用

 

注意:

开通移动应用,获取key

获取token的时候我使用的安卓获取的方式

通过我写对应api的例子我发现,其实就两种情况:一种是get方式提交数据,另外一种是post方式提交数据

1.get方式提交数据,我们用获取云盘的信息为例:

获取云盘信息前我们要知道,我们要准备好什么数据:

请求参数:

url: 标明我们要访问的网址路径   值固定问“https://pcs.baidu.com/rest/2.0/pcs/quota”

method:标明我们是请求云盘信息   值固定为“info”

acceess_token:准入标识  值是我们自己申请的

接收返回参数:

        quota:云盘总容量

used:云盘使用容量

request_id:该请求的表示,没啥用

        返回的一个json串如下格式:{"quota":123794882560, "used":83573494688,"request_id":2853739529}

 

我在做的时候你使用Gson工具将json串转换到对应的entity类中了 代码如下:

 

[html] view plaincopy

  1. /**  
  2.  * @param URLConnection conn通过get方式获取StringBuffer  
  3.  * @return  
  4.  */  
  5. private StringBuffer getJsonString(URLConnection conn) {  
  6.     InputStreamReader isr = null;  
  7.     BufferedReader br = null;  
  8.     StringBuffer sb = null;  
  9.     try {  
  10.         isr = new InputStreamReader(conn.getInputStream(),"gb2312");  
  11.         br = new BufferedReader(isr);  
  12.         String line = null;  
  13.         sb = new StringBuffer();  
  14.         while ((line = br.readLine()) != null) {  
  15.             sb.append(line);  
  16.             sb.append("\r\n");  
  17.         }  
  18.     } catch (UnsupportedEncodingException e) {  
  19.         e.printStackTrace();  
  20.     } catch (IOException e) {  
  21.         e.printStackTrace();  
  22.     }finally{  
  23.         try {  
  24.             if(isr!=null)  
  25.                 isr.close();  
  26.         } catch (IOException e) {  
  27.             System.out.println("流关闭是异常");  
  28.             e.printStackTrace();  
  29.         }  
  30.     }  
  31.   
  32.     return sb;  
  33. }  
  34.   
  35. /**  
  36.  * @return  
  37.  * @throws Exception  
  38.  *             获取云空间的信息  
  39.  */  
  40. public CloudInfo getCloudInfo() throws Exception {  
  41.     URL u = new URL(https://pcs.baidu.com/rest/2.0/pcs/quota"?method=info&access_token=你申请的token的值";  
  42.     URLConnection conn = u.openConnection();// 打开网页链接  
  43.     // 获取用户云盘信息  
  44.     String cloudJson = this.getJsonString(conn).toString();  
  45.   
  46.     // 解析成对象 下面有这个实体对象的类  
  47.     Gson gson = new Gson();  
  48.     CloudInfo cloudInfo = gson.fromJson(cloudJson, CloudInfo.class);  
  49.     System.out.println("云盘信息:"+cloudInfo);  
  50.     return cloudInfo;  
  51. }  

[html] view plaincopy

  1. package com.entity;  
  2.   
  3. import java.lang.reflect.Type;  
  4.   
  5. /**  
  6.  * @author ydcun 获取云空间的信息 例如:  
  7.  *              {"quota":123794882560, 空间配额,单位为字节  
  8.  *               "used":83573494688, 已使用空间大小 单位为字节。  
  9.  *               "request_id":2853739529}  
  10.  */  
  11. public class CloudInfo{  
  12.     private Double quota;  
  13.     private Double used;  
  14.     private Double request_id;  
  15.     /**  
  16.      * @return the quota  空间配额,单位为字节  
  17.      */  
  18.     public Double getQuota() {  
  19.         return quota;  
  20.     }  
  21.     /**  
  22.      * @param quota the quota to set  空间配额,单位为字节  
  23.      */  
  24.     public void setQuota(Double quota) {  
  25.         this.quota = quota;  
  26.     }  
  27.     /**  
  28.      * @return the used 已使用空间大小 单位为字节  
  29.      */  
  30.     public Double getused() {  
  31.         return used;  
  32.     }  
  33.     /**  
  34.      * @param used the used to set 已使用空间大小 单位为字节  
  35.      */  
  36.     public void setused(Double used) {  
  37.         this.used = used;  
  38.     }  
  39.     /**  
  40.      * @return the request_id   
  41.      */  
  42.     public Double getRequest_id() {  
  43.         return request_id;  
  44.     }  
  45.     /**  
  46.      * @param request_id the request_id to set  
  47.      */  
  48.     public void setRequest_id(Double request_id) {  
  49.         this.request_id = request_id;  
  50.     }  
  51.     @Override  
  52.     public String toString() {  
  53.           
  54.         return new StringBuffer().append("空间容量:").append(this.getQuota()/1024/1024).append("M;  已用:").append(this.getused()/1024/1024).append("M; ").toString();  
  55.     }  
  56. }  

 

2.通过post方式提交  我用上传单个文件为例子:

同样我们也先了解下上传文件要参数设置:

 

请求参数:

url: 标明我们要访问的网址路径   值固定问“https://pcs.baidu.com/rest/2.0/pcs/file”

method:标明我们是请求云盘信息   值固定为“upload”

acceess_token:准入标识  值是我们自己申请的

path:是我们要上传到云盘的那个路径下     如/apps/myBaiduCloud/        myBaiduCloud是我们的应用名称(当你获取koten后就会自动生成以你应用名称为名的文件夹)

file:这个就是我们要上传的文件了(要求用post方式上传)

ondup:可选参数,标识当有重名的文件的时候处理方式具体见api

接收返回参数:

       返回的也是json串,

path:为我们上传的文件保存的全路径

size:文件的大小有多少字节

ctime/mtime:文件的创建修改时间

其他参数介绍点小标题去api中查看

{

   "path" : "/apps/album/README.md"

   "size" : 372121,

   "ctime" : 1234567890,

   "mtime" : 1234567890,

   "md5" : "cb123afcc12453543ef",

   "fs_id" : 12345,

    "request_id":4043312669

}

我在做的时候也是将其封装到实体类中了,这里和上面一样不详述,我们重点看下提交文件是怎么提交的代码如下:

 

 

[java] view plaincopy




  1. /** 
  2.      * @param path 云盘存放路径 
  3.      * @param name 要上传的文件 
  4.      * @return 
  5.      * @throws Exception  
  6.      */  
  7.     public FileBase uploadFile(String path,File file) throws Exception{  
  8.         //模拟文件  
  9.         String fileName="README.md";  
  10.         file = new File(fileName);  
  11.         path="%2fapps%2fmybaidu%2f";    //  我用的是url编码过源码为:->  "/apps/mybaidu/  
  12. /"  
  13.           
  14.           
  15.         //将需要url传值的参数和url组装起来  
  16.         String u ="https://pcs.baidu.com/rest/2.0/pcs/file?path="+path+file.getName()+"&method=upload&access_token=你自己申请的token值";  
  17.   
  18.           
  19.           
  20.         PostMethod filePost = new PostMethod(u);  
  21.         //post提交的参数  
  22.         Part[] parts = {new FilePart(fileName,file)};  
  23.         //设置多媒体参数,作用类似form表单中的enctype="multipart/form-data"   
  24.         filePost.setRequestEntity(new MultipartRequestEntity(parts, filePost.getParams()));  
  25.         HttpClient clients = new HttpClient();  
  26.         //响应代码  
  27.         int status = clients.executeMethod(filePost);  
  28.         System.out.println("成功上传"+path+fileName);  
  29.           
  30.         BufferedReader buReader = new BufferedReader(new InputStreamReader(filePost.getResponseBodyAsStream(),"utf-8"));  
  31.         StringBuffer sb = new StringBuffer();  
  32.         String line;  
  33.         while((line=buReader.readLine())!=null){  
  34.             sb.append(line);  
  35.         }  
  36.         buReader.close();  
  37.           
  38.         // 解析成对象  
  39.         Gson gson = new Gson();  
  40.         FileBase cloudInfo = gson.fromJson(sb.toString(), FileBase.class);  
  41.           
  42.         return cloudInfo;  
  43.     }  



上面代码成功后我们就会在/apps/mybaidu/目录下找到README.md文件

 

上面代码执行还要倒入对应的jar包:下载

commons-codec-1.3.jar

commons-httpclient-3.0.jar

commons-logging.jar

gson-2.2.1.jar

jsoup-1.6.3.jar

 

其他的api怎么用百度给了一个很好的演示平台:

 

好了剩下的就大家自己去模式吧!

 

 

用什么问题联系我我们一起探讨----ydcun

 

 

 


相关阅读:
Top