Flask-Restful插件
Flask-Restfu是一个专门用来写restful api的一个插件。使用他可以快速的集成restful api 功能。在app后台以及纯api的后台中,这个插件可以帮助我们节省很多时间。当然如在普通的网站中,这个插件就显示有些鸡肋了,因为在普通的网页开发中,是需要去渲染HTML代码的,而Flask-Restfu在每个请求中都是返回json格式的数据。
安装
Flask-Restful需要在Flask 0.8以上的版本,在Python2.6或者Python3.3上运行。通过pip install flask-restful既可安装。
定义Restful的视图
如果使用Flask-Restful,那么定义视图函数时,就要继承自Flask-Restful.Resource类,然后再根据当前请求的method来定义相应的方法。如期望客户端是使用get方法发生过来的请求,那么就定义一个get方法。类似于MethodView。
1 from flask import Flask,render_template,url_for
2 from flask_restful import Api,Resource
3
4 app = Flask(__name__)
5 # 用Api来绑定app
6 api = Api(app)
7
8 class IndexView(Resource):
9 def get(self):
10 return {"username":"juran"}
11
12 api.add_resource(IndexView,'/',endpoint='index')
注意事项
。endpooint 是用来给url_for反转url的时候指定的。如不写endpooint ,那么将会使用视图的名字的小写来作为endpooint 。
。add_resource的第二个参数是访问这个视图函数的url,这个url可以跟之前的route一样,可以传递参数,并且还有一点不同的是,这个方法可以传递多个url来指定这个视图函数。
参数解析
Flask-Restful插件提供了类似WTFForms来验证提交的数据是否合法的包,交reqparse。
1 parser = reqparse.RequestParser()
2 parser.add_argument('username',type=str,help='请输入用户名')
3 args = parser.parse_args()
add_argument 可以指定这个字段的名字,这个字段的数据类型等。
。default:默认值,如这个参数没有值,那么将使用这个参数指定的值
。required:是否必须。默认为False,如设置为True,那么这个参数必须提交上来。
。type:这个参数的数据类型,如指定,那么将使用指定的数据类型来强制转换提交上来的值。
。choices:选项。提交上来的值只能满足这个选项中的值才符合验证通过,否则验证不通过。
。help:错误信息。如验证失败后,将会使用这个参数指定的值作为错误信息。
。trim:是否要去掉前后的空格。
输出字段
对于一个视图函数,你可以指定好一些字段用于返回。以后可以使用ORM模型或者自定义的模型时,他会自动的获取模型中的相应的字段,生成json数据,然后再返回给客户端。这其中需要导入Flask_Restful.marshal_with装饰器。并且需要写一个字典,来指示需要返回的字段,以及该字段的数据类型。
1 class ProfileView(Resource):
2 resource_fields = {
3 'username': fields.String,
4 'age': fields.Integer,
5 'school': fields.String
6 }
7
8 @marshal_with(resource_fields)
9 def get(self,user_id):
10 user = User.query.get(user_id)
11 return user
在get方法中,返回user的时候,Flask_Restful会自动的读取user模型上额username以及age还有school属性。组装成一个json格式的字符串返回给客户端。
重命名属性
很多时候你面向公众的字段名称是不同于内部属性名。使用attribute可以配置这种映射。比如现在想要返回user.school中的值,但在返回给外面的时候,想以education返回回去,那么可以这样写
1 resource_fields = {
2 'education': fields.String(attribute='school')
3 }
默认值
在返回一些字段时,有时可能没有值,那么这是可以在指定fields的时候给定一个默认值
1 resource_fields = {
2 'age': fields.Integer(default=18)
3 }
复杂结构
有时想要在返回的数据格式中,形成比较复杂的结构。那么可以使用一些特殊的字段来实现。比如要在一个字段中放置一个列表,那么可以使用field.List,比如在一个字段下面又是一个字典,那么可以使用field.Nested。
1 class ProfileView(Resource):
2 resource_fields = {
3 'username': fields.String,
4 'age': fields.Integer,
5 'school': fields.String,
6 'tags': fields.List(fields.String),
7 'more': fields.Nested({
8 'signature': fields.String
9 })
10 }
memcached
什么是memcached
1.memcached之前是danga的一个项目,最早是为LiveJournal服务的,当初设计师为了加速LiveJournal访问速度而开发的,后来被很多大型项目采用。官网是www.danga.com或者mencached.org。
2.Memcached是一个高性能分别式的内存对象缓存系统,全世界有不少采用这个缓存项目来构建大负载的网站,来分担数据的压力。Memcached是通过在内存里维护一个统一的巨大的hash表,memcached能存储各种各样的数据,包括图像、视频、文件、以及数据库检索的结果等。简单的说就是将数据调用到内存中,然后从内存中读取,从而大大提高读取速度。
3.哪些情况下适合使用Memcached:存储验证码(图形验证码、短信验证码)、登录session等所有不是至关重要的数据。
memcached特性
1.保存内存中
2.重启服务,数据会丢失
3.LUR算法,根据最近使用的变量,将长时间没有使用的变量删除
4.memcached服务端是不安全的
5.不适合单机使用,对内存的消耗比较大
6.格式简单,不支持list数据格式
安装和启动memcached
1 windows:
2 安装:memcached.exe -d install。
3 启动:memcached.exe -d start。
4
5 linux(ubuntu):
6 安装:sudo apt install memcached
7
8 启动:
9 cd /usr/bin/memcached/
10 memcached -d start
可能出现的问题:
1 1.提示你没有权限:在打开cmd的时候,右键使用管理员身份运行。
2
3 2.提示缺少pthreadGC2.dll文件:将pthreadGC2.dll文件拷贝到windows/System32.
4
5 3.不要放在含有中文的路径下面
启动memcached:
1 -d:这个参数是让memcached在后台运行。
2 -m:指定占用多少内存。以M为单位,默认为64M。
3 -p:指定占用的端口。默认端口是11211。
4 -l:别的机器可以通过哪个ip地址连接到我这台服务器。如果是通过service memcached start的方式,那么只能通过本机连接。如果想要让别的机器连接,就必须设置-l 0.0.0.0
如果想要使用以上参数来指定一些配置信息,那么不能使用service memcached start,而应该使用/usr/bin/memcached的方式来运行。比如/usr/bin/memcached -u memcached -m 1024 -p 11222 start。
telnet操作memcached
telent ip 地址 [11211]
添加数据
1 set
2 set key flas(是否压缩) timeout value_length
3 value
4
5 set username 0 60 5
6 juran
7
8 add
9 add key flas(0) timeout value_length
10 value
11
12 add username 0 60 5
13 juran
set 和add的区别: add是只负责添加数据,不会去修改数据。如果添加的数据的key已经存在了,则添加失败,如添加的key不存在,则添加成功。而set不同,如果memcached中部存在相同的Key,则进行添加,如果存在,则替换。
获取数据
1 get key
2
3 get username
删除数据
1 delete key
2
3 delete username
4
5 flush_all:删除memcached中的所有数据。
自增自减
1 incr key nums
2 decr key nums
查看memcached的当前状态
1 stats
通过Python操作memcached
安装:python-memcached:pip install python-memcached
建立连接
1 import memcache
2 mc = memcache.Client(['127.0.0.1:11211','192.168.174.130:11211'],debug=True)
设置数据
1 mc.set('username','hello world',time=60*5)
2 mc.set_multi({'email':'[email protected]','telphone':'111111'},time=60*5)
获取数据
1 mc.get('telphone')
删除数据
1 mc.delete('email')
自增自减
1 mc.incr('read_count')
2 mc.decr('read_count')
分布式
1 mc = memcache.Client(["192.168.164.137:11211","192.168.164.137:11212"],debug=True)
2
3 mc.set_multi({"pwd":'123',"age":18},time=60)
memcached尽管是“分布式”缓存服务器,但服务器端并没有分布式功能。各个memcached不会互相通信以共享信息,这完全取决于客户端的实现。
memcached的安全性
memcached的操作不需要任何用户名和密码,只需要知道memcached服务器的ip地址和端口既可。因此memcached使用的时候尤其要注意他的安全性。这里提供二种安全的解决方案。
1.使用-1参数设置为只有本地可以连接:这种方式,就只能通过本机才能连接,别的机器都不能访问,可以达到最好的安全性。
2.使用防火墙,关闭11211端口,外面也不能访问。
1 ufw enable # 开启防火墙
2 ufw disable # 关闭防火墙
3 ufw default deny # 防火墙以禁止的方式打开,默认是关闭那些没有开启的端口
4 ufw deny 端口号 # 关闭某个端口
5 ufw allow 端口号 # 开启某个端口