Flask-RESTful是一个用于快速创建RESTful API接口的Flask扩展。使用Flask-RESTful可以很快速方便地创建一个RESTful风格的接口应用程序。
1、安装
2、全部代码
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
|
from flask import Flask from flask_restful import reqparse, abort, Api, Resource app = Flask(__name__) api = Api(app) TODOS = { 'todo1' : { 'task' : 'build' }, 'todo2' : { 'task' : 'bui2' }, 'todo3' : { 'task' : 'bui3' } } parser = reqparse.RequestParser() parser.add_argument( 'task' ) class Todo(Resource): def get( self , todo_id): return TODOS[todo_id] def delete( self , todo_id): del TODOS[todo_id] return '', 204 def put( self , todo_id): args = parser.parse_args() task = { 'task' : args[ 'task' ]} TODOS[todo_id] = task return task, 201 class TodoList(Resource): def get( self ): return TODOS api.add_resource(TodoList, '/todos' ) api.add_resource(Todo, '/todos/<todo_id>' ) if __name__ = = '__main__' : app.run(debug = True ) |
3、代码说明
1). 初始化
在当前程序初始化一个flask-restful的api实例:
1
|
api = Api(app) |
2). 定义资源类
资源类是restful接口的具体实现,需要继承Resource类。在类中可以定义get、post等符合restful规范的接口。
1
2
3
4
5
6
7
8
9
10
11
12
13
|
class Todo(Resource): def get( self , todo_id): return TODOS[todo_id] def delete( self , todo_id): del TODOS[todo_id] return '', 204 def put( self , todo_id): args = parser.parse_args() task = { 'task' : args[ 'task' ]} TODOS[todo_id] = task return task, 201 |
3). 参数解析
虽然 Flask 提供了简单的方法访问请求数据, 但是对于表单数据处理还是比较麻烦. Flask-RESTful 提供了 reqparse 一种类似 argparse 参数解析机制以简化参数处理.
parser = reqparse.RequestParser(): reqparse使用RequestParser() 可以从 flask.Request.values,以及 flask.Request.json 解析值。这里创建了一个解析对象parser。
parser.add_argument('task'):向parser对象中添加你要关注的命令行参数和选项,每一个add_argument方法对应一个你要关注的参数或选项。
parser.parse_args():调用parse_args()方法进行解析,解析成功之后即可使用。
4). add_argument扩展
对于必传的参数,可以设置required=True
1
2
|
parser.add_argument( 'name' , type = str , required = True , help = "Name cannot be blank!" ) |
传多个值,使用 action='append'
1
|
parser.add_argument( 'name' , type = str , action = 'append' ) |
使用:
1
|
curl http: / / api.example.com - d "Name=bob" - d "Name=sue" - d "Name=joe" |
获取的参数为:
1
2
|
args = parser.parse_args() args[ 'name' ] # ['bob', 'sue', 'joe'] |
以上就是本文的全部内容,希望对大家的学习有所帮助,也希望大家多多支持服务器之家。
原文链接:https://segmentfault.com/a/1190000017250771