七牛Golang SDK简单使用教程

最近试用了一下七牛的存储服务, 由于最近在使用golang,所以就拿七牛的golang sdk来进行相应的操作。 为了不至于以后使用时,总是去查七牛的文档(七牛的文档有些地方需要来回查), 所以在此简单做一个基本的使用教程。

安装

go get -u qiniupkg.com/api.v7
注意安装时,应该使用如上的命令中的连接,而不是七牛官方文档当中的连接。

初始化

使用如下代码进行初始化:

import "qiniupkg.com/api.v7/kodo"

var (
  ACCESS_KEY = ""
  SECRET_KEY = ""
  DEFAULT_BUCKET_NAME = ""
)

func main() {
  kodo.SetMac(ACCESS_KEY, SECRET_KEY)
  zone := 0
  qiniuClient := kodo.New(zone, nil)
  bucket := qiniuClient.Bucket(DEFAULT_BUCKET_NAME)
  netContext := context.Background()
  }

该代码是基于最新的api.v7代码,七牛官方文档当中提及的代码并非根据最新代码而来。

上传文件

按照七牛的官方文档,上传文件的流程如下(上传文件发生在客户端而非业务服务端时):
1. 业务服务器颁发 上传凭证给客户端(终端用户)
2. 客户端凭借 上传凭证 上传文件到七牛
3. 在七牛获得完整数据后,发起一个 HTTP 请求回调到业务服务器
4. 业务服务器保存相关信息,并返回一些信息给七牛
5. 七牛原封不动地将这些信息转发给客户端(终端用户)

生成上传凭证

业务服务器生成上传凭证代码:

  key := generateFileKey() //根据自己的规则生成所需要的key,也可以不指定而由七牛服务器自动生成(即使用文件的hash值)
  //指定上传策略
  policy := &kodo.PutPolicy {
    Scope: DEFAULT_BUCKET_NAME + ":" + key,
    Expires: 3600, //如果不指定,默认的有效期为3600s
    CallbackUrl: "http://i.test.com/qiniu/callback",
    CallbackBody: "key=$(key)&loation=$(x:location)",
  }
  uploadToken := qiniuClient.MakeUptoken(policy)

上传策略暂时可以先指定如上的几部分,如果需要的话可以根据实际情况指定其他的参数。其中:CallbackBody的形式一般而言应该如上述形式,其中的key是指七牛的魔法变量,而$(x:location)这样的是用户自定义变量,这些自定义变量必须使用x:开头(由客户端在上传文件到七牛服务器时同时指定这些变量的值)。
其他的上传策略相关项可以查看七牛的官方文档。七牛上传策略

业务服务器直接上传文件

业务服务器处理回调

业务服务器处理上传文件的回调(URL在上传策略当中的CallbackUrl当中指定)。严格来讲该部分已经不再属于golang sdk的使用范畴,但是由于我们使用golang sdk是作为业务服务器的一部分来使用(而不是作为客户端),所以此处的业务服务器回调处理也一并在这儿列出。
回调处理,首先应该验证回调的request是否是合法的。具体可以见七牛的官方文档[七牛回调合法性][qnhdhfx]。此处需要注意的是,验证回调合法性的时候,是需要读取整个request body的,所以此处读取request body的时候是需要保存到变量当中的,避免验证完合法性之后再次读取request body的时候读取的内容为空。
这之后就可以正常进行业务处理了。

未完待续:由于某些原因,此文暂时未完成,等有时间补充完整。


评论
添加红包

请填写红包祝福语或标题

红包个数最小为10个

红包金额最低5元

当前余额3.43前往充值 >
需支付:10.00
成就一亿技术人!
领取后你会自动成为博主和红包主的粉丝 规则
hope_wisdom
发出的红包
实付
使用余额支付
点击重新获取
扫码支付
钱包余额 0

抵扣说明:

1.余额是钱包充值的虚拟货币,按照1:1的比例进行支付金额的抵扣。
2.余额无法直接购买下载,可以购买VIP、付费专栏及课程。

余额充值