Swiftpack.co - Package - DamonHu/vapor-HDQNTool

vapor-HDQNTool

Qiniu upload server sdk under vapor framework,vapor框架下的七牛上传服务器sdk

Qiniu is an independent third-party CDN company in China, which provides free cdn quota and quality experience. There may not be many users in other countries. If you need English instructions, you can submit an issue.

vapor是一个swift语言开发的服务器框架,该项目是在vapor框架下集成使用七牛存储功能,目前集成了上传文件和删除文件功能。

使用swift语言开发,基于七牛官网的Api接口,三行代码即可快速集成服务器端功能。

一、项目集成

可以采用SPM方式添加,也可以采用源文件方式添加

1.1、SPM方式集成

Vapor项目的Package文件中,在dependencies添加依赖

.package(url: "https://github.com/DamonHu/vapor-HDQNTool.git", from: "1.1.0")

targets中添加

.target(name: "App", dependencies: ["Vapor", "HDQNTool"]),

1.2、源文件方式添加

将本git仓库里面的Sources目录下的HDQNTool整个文件夹拖入添加到工程即可

二、快速使用

2.1、上传资源

手机客户端等通过七牛sdk上传资源时,必须要知道一个tokenkey,这个封装的uploadFile接口就是生成tokenkey的,并不是你用客户端把资源上传到这个接口,这个接口直接拿资源上传到服务器

//1、导入工具
import HDQNTool
//2、创建工具,需要把accessKey和secretKey换成你在七牛后台的accessKey和secretKey
let qnTool = HDQNTool(accessKey: "1233333", secretKey: "12333322")
//3、上传资源,把bucket换成你自己的bucket名字,fileName写想要上传的文件名
try qnTool.uploadFile(req, bucket: "bucketName", fileName: "fileName")

该接口返回的是Res_QNDataConfig类,里面包含了上传的token和file名字,然后你可以自己返回到请求中,这样客户端使用官方sdk上传资源时,就可以取到需要的tokenfileKey

2.2、删除资源

发起该请求,即可删除七牛对应bucket里面对应的资源

//1、导入工具
import HDQNTool
//2、创建工具,需要把accessKey和secretKey换成你在七牛后台的accessKey和secretKey
let qnTool = HDQNTool(accessKey: "1233333", secretKey: "12333322")
//3、上传资源,把bucket换成你自己的bucket名字,fileName写想要上传的文件名
try qnTool.deleteFile(req, bucket: "lazypigflarum", fileName: fileName)

该接口返回的是UInt类型的错误码,可以参考下面错误码对应的报错

|HTTP状态码| 含义| |----|----| |200 | 删除成功| |400 | 请求报文格式错误| |401 | 管理凭证无效| |599 | 服务端操作失败| |612 | 待删除资源不存在|

三、其他说明

目前只封装了上传和删除功能,其他操作你可以参考封装,我也会根据需求进行扩充。

Github

link
Stars: 2

Dependencies

Used By

Total: 0

Releases

1.1.0 - 2020-03-18 05:09:43

1.0.3 - 2020-03-18 03:37:41

1.0.2 - 2020-03-17 09:45:35

1.0.1 - 2020-03-17 09:20:29

1.0.0 - 2020-03-17 09:08:30