七牛云API使用

七牛云官网http://www.qiniu.com/pricing
javaSDK使用eg:
import com.qiniu.util.Auth;
import java.io.IOException;
import com.qiniu.common.QiniuException;
import com.qiniu.http.Response;
import com.qiniu.storage.UploadManager;

public class UploadDemo {
  //设置好账号的ACCESS_KEY和SECRET_KEY
  String ACCESS_KEY = "Access_Key";
  String SECRET_KEY = "Secret_Key";
  //要上传的空间
  String bucketname = "Bucket_Name";
  //上传到七牛后保存的文件名
  String key = "my-java.png";
  //上传文件的路径
  String FilePath = "/.../...";

  //密钥配置
  Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);
  //创建上传对象
  UploadManager uploadManager = new UploadManager();

  //简单上传,使用默认策略,只需要设置上传的空间名就可以了
  public String getUpToken(){
      return auth.uploadToken(bucketname);
  }

  public void upload() throws IOException{
    try {
      //调用put方法上传
      Response res = uploadManager.put(FilePath, key, getUpToken());
      //打印返回的信息
      System.out.println(res.bodyString());
      } catch (QiniuException e) {
          Response r = e.response;
          // 请求失败时打印的异常的信息
          System.out.println(r.toString());
          try {
              //响应的文本信息
            System.out.println(r.bodyString());
          } catch (QiniuException e1) {
              //ignore
          }
      }      
  }

  public static void main(String args[]) throws IOException{ 
    new UploadDemo().upload();
  }

}


覆盖上传

import java.io.IOException;

import com.qiniu.common.QiniuException;
import com.qiniu.http.Response;
import com.qiniu.storage.UploadManager;
import com.qiniu.util.Auth;
import com.qiniu.util.StringMap;

public class UploadDemo {
  //设置好账号的ACCESS_KEY和SECRET_KEY
  String ACCESS_KEY = "Access_Key";
  String SECRET_KEY = "Secret_Key";
  //要上传的空间
  String bucketname = "Bucket_Name";
  //上传到七牛后保存的文件名
  String key = "my-java.png";
  //上传文件的路径
  String filePath = "/.../...";

  //密钥配置
  Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);
  //创建上传对象
  UploadManager uploadManager = new UploadManager();

  // 覆盖上传
  public String getUpToken(){
    //<bucket>:<key>,表示只允许用户上传指定key的文件。在这种格式下文件默认允许“修改”,已存在同名资源则会被本次覆盖。
    //如果希望只能上传指定key的文件,并且不允许修改,那么可以将下面的 insertOnly 属性值设为 1。
    //第三个参数是token的过期时间
      return auth.uploadToken(bucketname, key, 3600, new StringMap().put("insertOnly", 1 ));
  }

  public void upload() throws IOException{
    try {
      //调用put方法上传,这里指定的key和上传策略中的key要一致
      Response res = uploadManager.put(filePath, key, getUpToken());
      //打印返回的信息
      System.out.println(res.bodyString());
      } catch (QiniuException e) {
          Response r = e.response;
          // 请求失败时打印的异常的信息
          System.out.println(r.toString());
          try {
              //响应的文本信息
            System.out.println(r.bodyString());
          } catch (QiniuException e1) {
              //ignore
          }
      }      
  }

  public static void main(String args[]) throws IOException{ 
    new UploadDemo().upload();
  }

}


断点上传

import java.io.IOException;

import com.qiniu.common.QiniuException;
import com.qiniu.http.Response;
import com.qiniu.storage.Recorder;
import com.qiniu.storage.UploadManager;
import com.qiniu.storage.persistent.FileRecorder;
import com.qiniu.util.Auth;

public class UploadDemo {
  //设置好账号的ACCESS_KEY和SECRET_KEY
  String ACCESS_KEY = "Access_Key";
  String SECRET_KEY = "Secret_Key";
  //要上传的空间
  String bucketname = "Bucket_Name";
  //上传到七牛后保存的文件名
  String key = "my-java.png";
  //上传文件的路径
  String filePath = "/.../...";

  //密钥配置
  Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);
  //创建上传对象
  UploadManager uploadManager = new UploadManager();

  // 覆盖上传
  public String getUpToken(){
    return auth.uploadToken(bucketname);
  }

  public void upload() throws IOException{
    //设置断点记录文件保存在指定文件夹或的File对象
    String recordPath = "/.../...";
    //实例化recorder对象
     Recorder recorder = new FileRecorder(recordPath);
     //实例化上传对象,并且传入一个recorder对象
     UploadManager uploadManager = new UploadManager(recorder);

    try {
      //调用put方法上传
      Response res = uploadManager.put("path/file", "key", getUpToken());
      //打印返回的信息
      System.out.println(res.bodyString());
      } catch (QiniuException e) {
          Response r = e.response;
          // 请求失败时打印的异常的信息
          System.out.println(r.toString());
          try {
              //响应的文本信息
            System.out.println(r.bodyString());
          } catch (QiniuException e1) {
              //ignore
          }
      }      
  }

  public static void main(String args[]) throws IOException{ 
    new UploadDemo().upload();
  }

}

上传&回调

import com.qiniu.util.Auth;
import com.qiniu.util.StringMap;

import java.io.IOException;

import com.qiniu.common.QiniuException;
import com.qiniu.http.Response;
import com.qiniu.storage.UploadManager;

public class UploadDemo {
  //设置好账号的ACCESS_KEY和SECRET_KEY
  String ACCESS_KEY = "Access_Key";
  String SECRET_KEY = "Secret_Key";
  //要上传的空间
  String bucketname = "Bucket_Name";
  //上传到七牛后保存的文件名
  String key = "my-java.png";
  //上传文件的路径
  String FilePath = "/.../...";

  //密钥配置
  Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);
  //创建上传对象
  UploadManager uploadManager = new UploadManager();

  //设置callbackUrl以及callbackBody,七牛将文件名和文件大小回调给业务服务器
  public String getUpToken(){
      return auth.uploadToken(bucketname,null,3600,new StringMap()
          .put("callbackUrl","http://your.domain.com/callback")
          .put("callbackBody", "filename=$(fname)&filesize=$(fsize)"));
  }

  public void upload() throws IOException{
    try {
      //调用put方法上传
      Response res = uploadManager.put(FilePath, null, getUpToken());
      //打印返回的信息
      System.out.println(res.bodyString());
      } catch (QiniuException e) {
          Response r = e.response;
          // 请求失败时打印的异常的信息
          System.out.println(r.toString());
          try {
              //响应的文本信息
            System.out.println(r.bodyString());
          } catch (QiniuException e1) {
              //ignore
          }
      }      
  }

  public static void main(String args[]) throws IOException{ 
    new UploadDemo().upload();
  }

}

上传&预转持续化

以视频转码为例:

import com.qiniu.util.Auth;
import com.qiniu.util.StringMap;
import com.qiniu.util.UrlSafeBase64;

import java.io.IOException;

import com.qiniu.common.QiniuException;
import com.qiniu.http.Response;
import com.qiniu.storage.UploadManager;

public class UploadDemo {
  //设置好账号的ACCESS_KEY和SECRET_KEY
  String ACCESS_KEY = "Access_Key";
  String SECRET_KEY = "Secret_Key";
  //要上传的空间
  String bucketname = "Bucket_Name";
  //上传到七牛后保存的文件名
  String key = "my-java.png";
  //上传文件的路径
  String FilePath = "/.../...";

  //设置转码操作参数
  String fops = "avthumb/mp4/s/640x360/vb/1.25m";
  //设置转码的队列
  String pipeline = "yourpipelinename";

  //可以对转码后的文件进行使用saveas参数自定义命名,当然也可以不指定文件会默认命名并保存在当前空间。
  String urlbase64 = UrlSafeBase64.encodeToString("目标Bucket_Name:自定义文件key");
  String pfops = fops + "|saveas/"+ urlbase64;

  //密钥配置
  Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);
  //创建上传对象
  UploadManager uploadManager = new UploadManager();

  //上传策略中设置persistentOps字段和persistentPipeline字段
  public String getUpToken(){
      return auth.uploadToken(bucketname,null,3600,new StringMap()
          .putNotEmpty("persistentOps", pfops)
          .putNotEmpty("persistentPipeline", pipeline), true);
  }

  public void upload() throws IOException{
    try {
      //调用put方法上传
      Response res = uploadManager.put(FilePath, null, getUpToken());
      //打印返回的信息
      System.out.println(res.bodyString());
      } catch (QiniuException e) {
          Response r = e.response;
          // 请求失败时打印的异常的信息
          System.out.println(r.toString());
          try {
              //响应的文本信息
            System.out.println(r.bodyString());
          } catch (QiniuException e1) {
              //ignore
          }
      }      
  }

  public static void main(String args[]) throws IOException{ 
    new UploadDemo().upload();
  }

}
队列pipeline 请参阅创建私有队列;转码操作 具体参数请参阅音视频转码;saveas 请参阅处理结果另存。

Tips:上面的 Demo 只是针对视频转码功能,如果您需要使用比如音视频切片、视频截图、视频拼接等功能只需要修改上面 fops 后面的参数即可,如:$fops = vframe/jpg/offset/1/w/480/h/360/rotate/90 就表示视频截图了。

可以看到上传成功后的行为主要是由上传凭证中的 上传策略 来指定。其中 上传策略 可以指定的行为不止这些,具体请参阅 上传策略。


文件下载

生成下载链接:

import com.qiniu.util.Auth;
public class DownloadDemo {
   //设置好账号的ACCESS_KEY和SECRET_KEY
   String ACCESS_KEY = "Access_Key";
   String SECRET_KEY = "Secret_Key";
   //密钥配置
   Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);
   //构造私有空间的需要生成的下载的链接
   String URL = "http://bucketdomain/key";

   public void download(){
     //调用privateDownloadUrl方法生成下载链接,第二个参数可以设置Token的过期时间
     String downloadRUL = auth.privateDownloadUrl(URL,3600);
     System.out.println(downloadRUL);
   }
   public static void main(String args[]){
     new DownloadDemo().download();
   }
}

空间资源管理


获取文件信息

import com.qiniu.common.QiniuException;
import com.qiniu.http.Response;
import com.qiniu.storage.BucketManager;
import com.qiniu.storage.model.FileInfo;
import com.qiniu.util.Auth;

public class BucketManagerDemo {

  public static void main(String args[]){
    //设置需要操作的账号的AK和SK
    String ACCESS_KEY = "Access_Key";
    String SECRET_KEY = "Secret_Key";
    Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);
    //实例化一个BucketManager对象
    BucketManager bucketManager = new BucketManager(auth);
    //要测试的空间和key,并且这个key在你空间中存在
    String bucket = "Bucket_Name";
    String key = "Bucket_key";
    try {
      //调用stat()方法获取文件的信息
      FileInfo info = bucketManager.stat(bucket, key);
      System.out.println(info.hash);
      System.out.println(info.key);
    } catch (QiniuException e) {
      //捕获异常信息
      Response r = e.response;
      System.out.println(r.toString());
    }
  }
}

移动单个文件

import com.qiniu.common.QiniuException;
import com.qiniu.http.Response;
import com.qiniu.storage.BucketManager;
import com.qiniu.storage.model.FileInfo;
import com.qiniu.util.Auth;

public class BucketManagerDemo {

  public static void main(String args[]){
    //设置需要操作的账号的AK和SK
    String ACCESS_KEY = "Access_Key";
    String SECRET_KEY = "Secret_Key";
    Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);
    //实例化一个BucketManager对象
    BucketManager bucketManager = new BucketManager(auth);
    //要测试的空间和key,并且这个key在你空间中存在
    String bucket = "Bucket_Name";
    String key = "Bucket_key";
    //将文件从文件key移动到文件key2, 可以在不同bucket移动,同空间移动相当于重命名
    String key2 = "yourjavakey";
    try {
      //调用move方法移动文件
      bucketManager.move(bucket, key, bucket, key2);
    } catch (QiniuException e) {
      //捕获异常信息
      Response r = e.response;
      System.out.println(r.toString());
    }
  }
}

复制单个文件

import com.qiniu.common.QiniuException;
import com.qiniu.http.Response;
import com.qiniu.storage.BucketManager;
import com.qiniu.storage.model.FileInfo;
import com.qiniu.util.Auth;

public class BucketManagerDemo {

  public static void main(String args[]){
    //设置需要操作的账号的AK和SK
    String ACCESS_KEY = "Access_Key";
    String SECRET_KEY = "Secret_Key";
    Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);
    //实例化一个BucketManager对象
    BucketManager bucketManager = new BucketManager(auth);
    //要测试的空间和key,并且这个key在你空间中存在
    String bucket = "Bucket_Name";
    String key = "Bucket_key";
    //将文件从文件key 复制到文件key2。 可以在不同bucket复制
    String key2 = "yourjavakey";
    try {
      //调用copy方法移动文件
      bucketManager.copy(bucket, key, bucket, key2);
    } catch (QiniuException e) {
      //捕获异常信息
      Response r = e.response;
      System.out.println(r.toString());
    }
  }
}

删除单个文件

import com.qiniu.common.QiniuException;
import com.qiniu.http.Response;
import com.qiniu.storage.BucketManager;
import com.qiniu.storage.model.FileInfo;
import com.qiniu.util.Auth;

public class BucketManagerDemo {

  public static void main(String args[]){
    //设置需要操作的账号的AK和SK
    String ACCESS_KEY = "Access_Key";
    String SECRET_KEY = "Secret_Key";
    Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);
    //实例化一个BucketManager对象
    BucketManager bucketManager = new BucketManager(auth);
    //要测试的空间和key,并且这个key在你空间中存在
    String bucket = "Bucket_Name";
    String key = "Bucket_key";
    try {
      //调用delete方法移动文件
      bucketManager.delete(bucket, key);
    } catch (QiniuException e) {
      //捕获异常信息
      Response r = e.response;
      System.out.println(r.toString());
    }
  }
}

触发持久化操作

以视频转码为例:

import com.qiniu.common.QiniuException;
import com.qiniu.http.Response;
import com.qiniu.processing.OperationManager;
import com.qiniu.util.Auth;
import com.qiniu.util.StringMap;
import com.qiniu.util.UrlSafeBase64;

public class OperateDemo {

public static void main(String[] args) throws QiniuException {
  //设置账号的AK,SK
  String ACCESS_KEY = "Access_Key";
  String SECRET_KEY = "Secret_Key";
  Auth auth = Auth.create(ACCESS_KEY, SECRET_KEY);
  //新建一个OperationManager对象
  OperationManager operater = new OperationManager(auth);
  //设置要转码的空间和key,并且这个key在你空间中存在
  String bucket = "Bucket_Name";
  String key = "Bucket_key";
  //设置转码操作参数
  String fops = "avthumb/mp4/s/640x360/vb/1.25m";
  //设置转码的队列
  String pipeline = "yourpipelinename";
  //可以对转码后的文件进行使用saveas参数自定义命名,当然也可以不指定文件会默认命名并保存在当前空间。
  String urlbase64 = UrlSafeBase64.encodeToString("目标Bucket_Name:自定义文件key");
  String pfops = fops + "|saveas/"+urlbase64;
  //设置pipeline参数
  StringMap params = new StringMap().putWhen("force", 1, true).putNotEmpty("pipeline", pipeline);
  try {
    String persistid = operater.pfop(bucket, key, pfops, params);
    //打印返回的persistid
    System.out.println(persistid);
  } catch (QiniuException e) {
    //捕获异常信息
      Response r = e.response;
      // 请求失败时简单状态信息
      System.out.println(r.toString());
      try {
         // 响应的文本信息
        System.out.println(r.bodyString());
      } catch (QiniuException e1) {
          //ignore
      }
  }
}
}
Tips:上面的Demo只是针对视频转码功能,如果您需要使用比如音视频切片、视频截图、视频拼接等功能只需要修改上面 fops 后面的参数即可,如:$fops = vframe/jpg/offset/1/w/480/h/360/rotate/90 就表示视频截图了。

通过上面的代码我们就可以触发将存储在空间中的视频从 mp4 格式转换成 m3u8 格式,并设置分辨率和视频码率。 但这个只是将转码这个耗时的操作提交到队列中,要想知道转码操作现在的状态, 需要根据返回的 persitentId 进行查询。如果您不方便持续轮询每个异步处理的进度和状态,七牛可以异步处理完成后通知您们的业务服务器。


猜你喜欢

转载自zhaoxiaoboblogs.iteye.com/blog/2300803