flask开发restful api系列(4)--七牛图片服务

  上一章我们讲到如何利用alembic来更新数据库,这章,我们讲如何通过七牛服务来存储图片。

  像我们大多数公司一样,公司资金比较少,如果自己开发图片服务器,代价太大;如果我们用自己的网站服务器来保存图片,很可能会把带宽阻塞住。因此,一款优秀的第三方图片服务变得非常重要。七牛就是这么一款,上传代码简单,可以在线编辑,简单的变换url,可以得到图片的不同效果。关键是,它是在一定限额内是免费的,只要通过认证,基本都够用了。我们公司现在包括app,网站所有图片都放在七牛,一直用的很好,一分钱也没有花。

  好了,闲话少说,自己先申请一个七牛账号,登录进去,可以自己先玩一下,直接上传一个图片。

  flask开发restful api系列(4)--七牛图片服务

  这就是我七牛账号里面的图片,我们点击内容上传,

flask开发restful api系列(4)--七牛图片服务

速度不是一般的快呀,做技术出生的CEO果然就是不同,点击"关闭",然后打开外链,看看效果吧。http://7xk6rc.com1.z0.glb.clouddn.com/2016-05-04%2015-06-21%E5%B1%8F%E5%B9%95%E6%88%AA%E5%9B%BE.png 这是我刚才上传的,你可以打开看看,是不是很简单?就是这么简单,然后我们用编程的方式上传,仅此而已。

好了,下面上python上传代码,首先,按照文档,先安装一下qiniu模块。

pip install qiniu

安装好以后,先随便写一个python上传代码,看看我们实际过程中需要提供什么。

# coding:utf-8
from qiniu import Auth, put_file, etag, urlsafe_base64_encode access_key = 'access_key'
secret_key = 'secret_key' q = Auth(access_key=access_key, secret_key=secret_key) bucket_name = 'dameinv' key = 'my-test-picture.png' token = q.upload_token(bucket_name, key, 3600) print token localfile = './my-test.png' ret, info = put_file(token, key, localfile) print ret
print info

看看打印结果

hP7WNicFRHPu2Bd24MaLj5VvmElXYJbRCoZfrVs6:Fi7LRD1ufxI6GaoRRUeX9ncRk0g=:eyJzY29wZSI6ImRhbWVpbnY6bXktdGVzdC1waWN0dXJlLnBuZyIsImRlYWRsaW5lIjoxNDYyMzUwMTk3fQ==
{u'hash': u'FvSC6ud6RL3jLmARbabBuzQttbNO', u'key': u'my-test-picture.png'}
exception:None, status_code:, _ResponseInfo__response:<Response []>, text_body:{"hash":"FvSC6ud6RL3jLmARbabBuzQttbNO","key":"my-test-picture.png"}, req_id:pSEAAMKvVqF7TEsU, x_log:s.ph;s.put.tw;s.put.tr;s.put.tw;s.put.tr;s.ph;s.put.tw;s.put.tr;s.ph;PFDS;PFDS:;PFDS:;rs18_6.sel/not found;rdb.g/no such key;DBD/;v4.get:/Document not found;rs19_6.ups;qtbl.ups:;mc.s;RS:;rs.put:;rs-upload.putFile:;UP: Process finished with exit code

好了,看看实际在七牛的效果。

http://7xk6rc.com1.z0.glb.clouddn.com/my-test-picture.png

打开看看吧,这就是实际效果。

下面我们就来逐个分析一下代码,

首先,access_key和secret_key就是你的'个人面板'===>'密钥管理'里面的2个key,直接复制过来就可以了,这个key很重要,千万不能泄露哦。

其次,q = Auth(access_key=access_key, secret_key=secret_key)新建一个qiniu上传对象;bucket_name就是你的空间名,我的空间名是“dameimv”,可以建多个空间,看看我所有空间名;flask开发restful api系列(4)--七牛图片服务我用的最上面的那个;key,其实这个命名有点问题的,其实应该叫路径,至于为什么七牛文档中叫它key,就不得而知了;然后我们利用bucket_name和key,返回一个token,这个token以后就是我们主要返回给客户端的,第三个参数,就是它过期时间,我这边就随便设置1个小时过期。

最后,就是上传,其实以后,这是客户端的事,我们服务器端只要提供token和key就可以了,客户端上传成功以后,直接告诉我们路径即可。其实就是一个put_file而已。

看看返回结果,我个人就是看info的status_code,如果是200就代表上传成功。

是不是非常简单!好了,在此基础上,我们写接口吧。首先,我通常的做法是,服务器端提供token和key的接口,客户端拿到以后,自己上传图片,上传成功了,再把整个url给我,这样,服务器不会浪费任何带宽资源,而且也不会中途出错,导致其他问题。即使客户端出错,它可以自己重新上传,或者根本不上传,服务器端不需要存储任何数据,也不会出现其他意外。

import uuid
from qiniu import Auth, put_file, etag, urlsafe_base64_encode
access_key = 'access_key'
secret_key = 'secret_key'
q = Auth(access_key=access_key, secret_key=secret_key)
bucket_name = 'dameinv' @app.route('/get-qiniu-token')
def get_qiniu_token():
key = uuid.uuid4()
token = q.upload_token(bucket_name, key, 3600)
return jsonify({'code': 1, 'key': key, 'token': token}) @app.route('/set-head-picture', methods=['POST'])
@login_check
def set_head_picture():
head_picture = request.get_json().get('head_picture')
user = g.current_user
user.head_picture = head_picture
try:
db_session.commit()
except Exception as e:
print e
db_session.rollback()
return jsonify({'code': 0, 'message': '未能成功上传'})
redis_store.hset('user:%s' % user.phone_number, 'head_picture', head_picture)
return jsonify({'code': 1, 'message': '成功上传'})

我们在原来的view.py中添加如上代码,第一个get_qiniu_token是获取七牛的token和key,这边的key为了保持唯一,使用uuid,其实有2种方案,第一,你可以用这uuid,第二,你可以使用http://base_url/phone_number/time_stamp 这样的方式,其实我更倾向于第二种,这样,你就可以看到在这个用户下,有多少它上传的东西,便于直接统计。

整个上传代码就这样,照例,我们在client.py文件下,模拟一下客户端操作,看看有没有问题。

# coding:utf-8
import requests
import json
from qiniu import put_file class APITest(object):
def __init__(self, base_url):
self.base_url = base_url
self.headers = {}
self.token = None
self.qiniu_token = None
self.qiniu_key = None
self.qiniu_base_url = 'http://7xk6rc.com1.z0.glb.clouddn.com/' def login(self, phone_number, password, path='/login'):
payload = {'phone_number': phone_number, 'password': password}
self.headers = {'content-type': 'application/json'}
response = requests.post(url=self.base_url + path, data=json.dumps(payload), headers=self.headers)
response_data = json.loads(response.content)
self.token = response_data.get('token')
return response_data def user(self, path='/user'):
self.headers = {'token': self.token}
response = requests.get(url=self.base_url + path, headers=self.headers)
response_data = json.loads(response.content)
return response_data def logout(self, path='/logout'):
self.headers = {'token': self.token}
response = requests.get(url=self.base_url + path, headers=self.headers)
response_data = json.loads(response.content)
return response_data def get_qiniu_token(self, path='/get-qiniu-token'):
response = requests.get(url=self.base_url + path)
response_data = json.loads(response.content)
self.qiniu_token = response_data.get('token')
self.qiniu_key = response_data.get('key')
if self.qiniu_token and self.qiniu_key:
print '成功获取qiniu_token和qiniu_key,分别为%s和%s' % (self.qiniu_token.encode('utf-8'), self.qiniu_key.encode('utf-8'))
localfile = '/home/yudahai/PycharmProjects/blog01/app/my-test.png'
ret, info = put_file(self.qiniu_token, self.qiniu_key, localfile)
print info.status_code
if info.status_code == 200:
print '上传成功'
self.head_picture = self.qiniu_base_url + self.qiniu_key
print '其url为:' + self.head_picture.encode('utf-8')
else:
print '上传失败'
return response_data def set_head_picture(self, path='/set-head-picture'):
payload = {'head_picture': self.head_picture}
self.headers = {'token': self.token, 'content-type': 'application/json'}
response = requests.post(url=self.base_url + path, data=json.dumps(payload), headers=self.headers)
response_data = json.loads(response.content)
print response_data.get('message')
return response_data if __name__ == '__main__':
api = APITest('http://127.0.0.1:5001')
api.login('', '')
api.get_qiniu_token()
api.set_head_picture()
api.logout()

运行一下,看看结果吧。

 成功获取qiniu_token和qiniu_key,分别为hP7WNicFRHPu2Bd24MaLj5VvmElXYJbRCoZfrVs6:WZLWPx0bZ04KjSU0zRYKrPitWoE=:eyJzY29wZSI6ImRhbWVpbnY6YjU2NGJlOTAtMjM2ZS00YjQzLWE1M2UtZGRjMThlNTJmYmQxIiwiZGVhZGxpbmUiOjE0NjIzNTYwOTJ9和b564be90-236e-4b43-a53e-ddc18e52fbd1

 上传成功
其url为:http://7xk6rc.com1.z0.glb.clouddn.com/b564be90-236e-4b43-a53e-ddc18e52fbd1
成功上传

已经上传成功了,看看头像结果

>>> from app.model import *
>>> user = User.query.filter_by('').first()
Traceback (most recent call last):
File "<input>", line , in <module>
TypeError: filter_by() takes exactly argument ( given)
>>> user = User.query.filter_by(phone_number='').first()
>>> user.head_picture
u'http://7xk6rc.com1.z0.glb.clouddn.com/b564be90-236e-4b43-a53e-ddc18e52fbd1'

看,已经成功了。

以后几乎所有的图片都可以这么处理,在客户端需要图片之前,让他们先访问get-qiniu-token接口,拿到token和key,客户端根据token和key来上传自己的东西。每上传一次,就访问一次get-qiniu-token接口。

好了,这就是简单的七牛上传图片介绍,详细的说明,他们都有文档,文档做的非常清晰。下一章,我们利用容联云通讯来完成注册过程,也非常简单。

上一篇:Bootstrap系列 -- 19. 焦点状态


下一篇:七牛用户搭建c# sdk的图文讲解