python restful_python中的Restful

哇，昨天组里进行总结的时候，小哥哥和小姐姐真是把我给秀到了，跟他们一比，我总结的太垃圾了，嘤嘤嘤。因为我平常不怎么总结，总结的话，有word还有纸质的，现在偏向于纸质，因为可以练练字。个人观点是，掌握了就不需要总结，因为已经会了，总结没什么用。如果需要总结只能说是还不够会。不过总结也有总结的好处，可以把整个过程再重新梳理一遍，如果时间比较充足的话，还是不错的方法。现在还是每天总结一下吧，要不然最后不好看。开始正题flask中的restful

一、关于Restful

Restful是目前最流行的api设计规范，用于web数据接口的设计

什么又是api?

按照我的理解，比如print()，这就是一个api。

def print(self, *args, sep=' ', end='\n', file=None): #known special case of print

"""print(value, ..., sep=' ', end='\n', file=sys.stdout, flush=False)

Prints the values to a stream, or to sys.stdout by default.

Optional keyword arguments:

file: a file-like object (stream); defaults to the current sys.stdout.

sep: string inserted between values, default a space.

end: string appended after the last value, default a newline.

flush: whether to forcibly flush the stream."""

pass

可以看到print()并不是一开始就有在终端中输出打印的功能，而是被python的创始人事先已经规范好的一个函数叫print，这个函数里面才有打印的功能

二、Restful基础

restful定义的api可以是一个接口，这个接口在定义url链接的时候，不能存在动词，一个个进行详细说明

在flask(因为我学的flask，菜的真实)中有一个视图函数(看我要说的准确一点啦)叫做@app.route，这个函数不能详细说，只需要知道是一个定义路径的就可以，比如我要写一个/index/路径，那么我们就可以是

@app.route('/index/')defindex():return "hello,world"

这样就已经完成一个index的路径了。还想要仔细了解话，这个东西是装饰器，装饰器也算一个挺复杂的函数。可以用双手搜下"flask 装饰器"，具体理解就只能看个人啦~

状态码:

200 正常

3xx 重定向

4xx 客户端错误

5xx 服务器错误

http的请求

get、post、put、head、delete、connect、options、trace这个最好要知道，因为后面会用到，想具体了解到话可以参考一本叫做《图解HTTP》的一本书

三、Restful的动词

在Restful中有五种请求方式，并且这五种请求方法不像在http里面只是一个请求的方法，这五种请求方法还需要记住，并且按照专业术语的话，它们应称之为“动词”。

get 读取

post 新建

put 更新

patch 也是更新，但只是部分更新(比如我只更新一个数据表中的一个参数，那么用patcha就会只更新这个参数，不会更新其他的东西)

delete 删除

了解了这五种请求方式之后，按照规范，在RestFul里面链接路由的时候，不能在名词里面加上动词。名词就是开发人员编写的路径名，但是路径名里面不能包含动词。

比如一个正确的url链接是/index/，这里面是没有动词的。错误的url链接是/get-index/这是一个错误的url链接，因为在get-index里面，包含动词get，在定义路径的时候，python会报错。

掌握完这些前期知识之后，我们来说下一个简单的Restful api实现

四、简单的hello world

from flask importFlask,redirect,url_forfrom flask_restful importApi,Resource,reqparse

app= Flask(__name__)#先绑定一个api，进行初始化操作

api =Api(app)classLoginView(Resource):defget(self):return {"simple":"hello world"}

api.add_resource(LoginView , '/' ,endpoint= 'login')

if __name__ == '__main__':

app.run()

前面两个from都是进行导入模板的，如果没有的话，需要进行安装。如果想用flask_restful，那么就可以在windows的命令行，或者Pycharm的虚拟终端中输入pip install flask_restful。这样就可以安装了。

这里简单说明下两个模板中的作用,from flask中的flask是Python中的一个框架，如果要想用flask框架的话，那么就必须要有这个库。flask_restful这个是restful用的。restful不是python中的内置模板，肯定是要进行导入啦。

app = Flask(__name__) 这是初始化一个flask模型

api = Api(app)这是将api和flask绑定到一块

LoginView继承了一个Resource的类，这个类我也没有仔细的了解，待我了解之后，我再进行补充。先记着，必须要继承Resource的类，才能写api

下面定义的方法比较重要

def get() 代表了是get方法传输数据，传输的数据都是json(就是一个格式化输出，比较规范的一个字典，不用过多纠结)。如果是def post()就代表了是post方法传输数据。然后根据函数的定义，一个函数要有一个返回值，因为是json的传输格式，所以就要是返回一个字典。

重要的部分是要把这个api要有一个展示的Url链接呀，那么我们就用api.add_resource()这个函数进行展现。第一个参数是定义的视图名LoginView，第二参数是url的链接是在/，比如是http;//127.0.0.1:5000那么我想访问/页面，就需要是http://127.0.0.1/,endpoint这个参数是后来Url_for反转的时候用到的。这样就能访问了，不要忘记简单但是又核心的main，如果main丢了，程序如何执行呢？嘻嘻

拓展一下

如果是一个详情页面展示呢？就是在url里面是/index/1/ ,/index/2/,/index/3，/index/..../ 这样的结构呢？难道我每次都需要是需要一个api.add_resource(xxx视图，/index/1/)，注意仔细观看除了/index/，后面的1，2，3，4.....都是有规律的。如果我们可以把这些1,2,3,4设置为变量就好了，没错，在flask中是可以进行操作的。

我贴代码先看一下

from flask importFlask,redirect,url_forfrom flask_restful importApi,Resource,reqparse

app= Flask(__name__)#先绑定一个api，进行初始化操作

api =Api(app)classLoginView(Resource):defget(self , username):return {"simple" : 'hello ,world'}

api.add_resource(LoginView ,'//' ,endpoint= 'login')#@app.route('/login1/')deflogin1():return redirect(url_for('login' ,username = '1'))if __name__ == '__main__':

app.run()

这里利用了username进行传值，通过视图函数login1来传递username的属性值，进而访问的时候以http://127.0.0.1:5000/1/就可以访问的到了。，代表了这是个可变的路由。可以参考下flask官方文档中对路由的解释 http://docs.jinkan.org/docs/flask/quickstart.html#routing

下面贴上效果图

这样的话一个稍微不是hello world的hello world，就算完成了。

Restful进阶：

post提交方法，前面我们已经说过get方法是读取，post方法是新建啦。我们用post方法演示一下，先贴代码

from flask importFlask,redirect,url_forfrom flask_restful importApi,Resource,reqparse

app= Flask(__name__)#先绑定一个api，进行初始化操作

api =Api(app)classLoginView(Resource):defpost(self):

parser=reqparse.RequestParser()#reqparse 是一个类似于WTforms验证的一个模板，用这个模板的时候，需要先进行引用，然后和WTForms的功能就差不了，就是一个验证用户输入的功能。

username = parser.add_argument('username' ,type = str , help = 'you xu yao yi ge zheng que de shuzi' ,required =True)#定义一个username,说明用户需要传入关于username的一个值()后面的都是参数.括号里面的参数可以先不考虑

password = parser.add_argument('password' , type = str , help = 'you xu yao yi ge zheng que de mima')#定义一个password,说明用户需要传入关于password的一个值()后面的都是参数.括号里面的参数可以先不考虑

args =parser.parse_args()#对用户传入的参数进行解析，不解析的话，是会报错的

print(args)return {"username" : "balala"}

api.add_resource(LoginView ,'/')if __name__ == '__main__':

app.run()

运行的结果是，浏览器默认的是get方式提交。而我们定义的是post方式提交

post方式提交(这里用到的是MantraPortable浏览器，个人感觉这款浏览器还是非常方便的。如果好像谷歌的postman的插件也是可以的，或者用burpsuit抓包进行修改，再或者在火狐里面有hackbar(这个目前付费了，emmn ，可以百度去搜下教程，都是一样的，只要能提交post数据就可以)

这是我们把username和password都进行提交了，如果我们只提交一个password呢？

咦，可以看到两个结果不一样，这是为什么呢？

username = parser.add_argument('username' ,type = str , help = 'you xu yao yi ge zheng que de shuzi' ,required =True)

password= parser.add_argument('password' , type = str , help = 'you xu yao yi ge zheng que de mima')

因为username里面有个required的参数，这个参数我的理解是username必须要有值，才能回显正确的字段。如果没有值的话，就回显help里面的内容。help就是一个提示的作用，万一用户输入的与我们想象的不一致，那我们可以进行提示下呀。不过这里有个小技巧，如果说help里面提示是中文的话，浏览器会进行转码，至于转码如何解决就只能百度去搜索了.......

补充下参数的内容:

default:默认值，如果这个字段没有设置值，那么就会使用default参数指定的值

required:是否必须。默认是false，如果设置为True，那么这个参数就必须提交上来。

type:这个参数的数据类型，如果指定，那么将使用指定的数据类型来强制转换提交上来的值

choices:选项。提交上来的值，只有满足这个选项中的值才符合验证通过，否则验证不通过。这个属性是一个列表，使用的时候要注意一下

help:错误信息，如果验证失败后就将才用这个help里面的内容

trim:是否去掉前后的空格

(待我慢慢写，写精华，不写一般般的帖子)