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':'xxx@qq.com','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 端口号 # 开启某个端口