12.Flask-Restful
定义Restful的视图
安装:pip install flask-restful
如果使用Flask-restful,那么定义视图函数的时候,就要继承flask_restful.Resourse类,然后再根据当前请求的method来定义相应的方法。比如期望客户端是使用get方法发送过来的请求,那么就定义一个get方法。
from flask import Flask from flask_restful import Api,Resource app = Flask(__name__) api = Api(app) #用Api来绑定app class LoginView(Resource): def post(self): return {'username':'derek'} api.add_resource(LoginView,'/login/',endpoint="login") @app.route('/') def index(): return 'Hello World!' if __name__ == '__main__': app.run(debug=True)
说明:
- 从flask_restful中导入一个Api,来创建一个api对象。
- 写一个视图函数,让它继承自Resource,然后定义相应的方法。
- endpoint是用来给url_for反转url的时候指定的。如果不写endpoint,那么将会视图函数的名字的小写来作为endpoint.
- add——resource的第二个参数是访问这个视图函数的url,这个url跟之前的route一样,可以传递参数,并且还有一点不同的是,这个方法可以传递多个url来指定这个视图函数。
- 如果想返回json数据,那么就是用flask_restful,如果是渲染模板,还是采用之前的方式。
参数认证
Flask-Restful插件提供了类似WTForms来验证提交的数据是否合法的包,叫做reqparse。
from flask import Flask from flask_restful import Api,Resource,reqparse,inputs app = Flask(__name__) api = Api(app) class LoginView(Resource): def post(self): parser = reqparse.RequestParser() parser.add_argument('username',type=str,help='用户名验证错误',default='xxx',trim=True) parser.add_argument('password',type=str,help='密码验证错误',required=True) parser.add_argument('gender',type=str,choices=['male','famale']) parser.add_argument('home_page',type=inputs.url,help=('个人中心链接错误')) parser.add_argument('birthday',type=inputs.date) args = parser.parse_args() print(args) return {'username':'derek'} api.add_resource(LoginView,'/login/',endpoint="login") @app.route('/') def index(): return 'Hello World!' if __name__ == '__main__': app.run(debug=True)
参数说明:
- default:默认值,如果这个参数没有值,那么将使用这个参数指定的值。
- required:是否必须。默认为False,如果设置为True,那么这个参数就必须提交上来。
- type:这个参数的数据类型,如果指定,那么将使用指定的数据类型来强制转换提交上来的值。
- choices:选项。提交上来的值只有满足这个选项中的值才符合,否则验证不通过。
- help:错误信息。如果验证失败后,将会使用这个参数指定的值作为错误信息。
- trim:是否去掉前后空格。
其中的type,可以使用python自带的一些数据类型,也可以使用flask_restful.inputs下的一些特定的数据类型来强制转换。比如一些常用的:
- url:会判断这个参数的值是否是一个url,如果不是,就会抛出异常。
- regex:正则表达式。
- date:将这个字符串转换为datetime.date数据类型,如果转换不成功,则会抛出一个异常。
标准化返回参数
输出字段
对于一个视图函数,你可以指定好一些字段用于返回。以后可以使用orm模型或者自定义的模型的时候,它会自动的获取模型的相应的字段,生成json数据,然后再返回给客户端。这其中需要导入flask_restful.marshal_with装饰器。并且需要些一个字典,来指示需要返回的字段,以及该字段的数据类型。
简单实例:
from flask_restful import Resource,fields,marshal_with class ProfileView(Resource): resource_fields = { 'username':fields.String, 'age':fields.Integer 'school':fields.String } @marshal_with(resource_fields) def get(self,user_id): user = User.query.get(user_id) return user
在get方法中,返回user的时候,flask_restful会自动的读取user模型上的username以及age属性。组成一个json格式的字符串返回给客户端。
重命名属性
很多时候你面向公众的字段名称是不同于内部的属性名,使用attribute可以配置这种映射。比如现在想要返回user.sckool的值,但是在返回给外面的时候,想以education返回回去,那么可以这样写:
resource_fields = { 'username':fields.String, 'age':fields.String 'education':fields.String(attribute='school') #重命名属性 }
默认值
在返回一些字段的时候,有时候可能没有值,那么这时候可以指定fields的时候给定一个默认值。
resource_fields = { 'username':fields.String, 'age':fields.Integer(default=18), # 默认值 'education':fields.String(attribute='school') }
复杂结构
有时候想要在返回的数据格式中,形参比较复杂的结构。那么可以使用一些特殊的字段来实现。比如要在一个字段中防止一个列表,那么可以使用fields.list;比如在一个字段下面又是一个字典,那么可以使用fields.Nested.
简单实例:
resource_fields = { 'username':fields.String, 'age':fields.Integer(default=18), # 默认值 'education':fields.String(attribute='school'), #重命名属性 'tags':fields.List(fields.String), 'more':fields.Nested({ 'signature':fields.String }) }
posted on 2018-06-01 10:49 zhang_derek 阅读(2214) 评论(0) 编辑 收藏 举报