flask基础之一

hello world

#从flask这个包中导入Flask这个类

#Flask这个类是项目的核心，以后的很多操作都是基于这个类的对象

#注册url，注册蓝图都是这个类的对象

from flask import Flask

#创建一个Flask对象，传递__name__这个参数进去

#__name__这个参数的作用：

# 1.规定模板和静态资源的路径

# 2.以后的一些Flask插件，比如Flask_migrate,Flask_SQLAlchemy报错的话，哪么Flask就会通过这个参数找到具体的报错位置

app = Flask(__name__)

# @app.route()是一个装饰器，将对应的“/”路径应用到hello_world()这个函数上面

# 在访问“/”的时候在页面上返回Hello World

@app.route('/')

def hello_world():

    return 'Hello World!'

# 如果作为一个主文件运行，哪么执行app.run()方法，也就是启动这个网站

if __name__ == '__main__':

    app.run()

debug模式

为什么要开启DEBUG模式？

如果开启了debug模式，name代码在调试过程中出现了异常，在浏览器页面中可以看到具体的报错信息，以及具体的错误代码位置，方便开发者调试。

如果flask开启了debug模式，name以后再python中修改任何代码，只要在pycharm中使用ctrl+s即可保存重载，不需要手动去重载程序

如何配置debug模式：

app.run()

app.run（debug=True）

app.debug

app.debug = True

配置信息方式（使用参数形式的方式）

app.config.update[DEBUG=True]

#其实也就是update了config字典

通过配置文件的形式

- 创建一个config.py的配置文件，写入

DEBUG = True

- 然后在你的app.py文件中写入

app.config.from_object(config) #即可读取配置文件中的DEBUG=True

debug PIN码

D:\MyDevSoftInstallDir\Python3\python3.exe D:/myflask/base/base.py

* Restarting with stat

* Debugger is active!

* Debugger PIN: 177-952-649

* Running on http://127.0.0.1:5000/ (Press CTRL+C to quit)

然后在页面上调试代码的时候用到。
也是为了安全考虑。

配置文件两种方式详解

第一种方式：

在项目主路径下创建config.py

DEBUG=True

然后在主项目里面去读取config.py里面的配置：

from flask import Flask

import config

app = Flask(__name__)

app.config.from_object(config)

第二种方式：直接读取文件的形式，也可以是普通的txt文件形式；这种方式不需要直接import config

在项目主路径下创建config.py

DEBUG=True

然后在主项目里面去读取config.py里面的配置：

from flask import Flask

app = Flask(__name__)

app.config.from_pyfile('config.py',silent=True) #静默模式加载配置文件（找不到配置文件不报错）,文件的后缀名不可少

url与视图函数的映射

传递参数：

传递参数的语法是/<参数类型:参数名称>/，然后在视图函数中也要定义同名的参数

参数的数据类型

string：只接受字符串，没有任何“/或者”的文本

int：只接受整数

float：只接受浮点数，整数都不行哈

path：和string类似，但是接受斜杠

uuid：只有接受符合uuid的字符赤岸，一般用作表的主键

any：可以指定多种路径

接收用户传递参数的方式：

使用path的方式（将参数嵌入到路径中）
使用查询字符串的形式（也就是通过?key=value的形式传递的，只能通过request.args.get的方式来获取）

如果页面想要做SEO优化的话，那么推荐使用path的形式，反之就是查询字符串的形式
练习

from flask import Flask,request

app = Flask(__name__)

@app.route('/')

def hello_world():

    return 'Hello World!'

@app.route('/list/')

def article_list():

    return 'article list!'

@app.route('/p1/<article_id1>')

def article_detail(article_id1):

    return "请求的文章是：%s" %article_id1

@app.route('/p2/<string:article_id2>')

def article_detail2(article_id2):

    return "请求的文章是：%s" %article_id2

@app.route('/p3/<int:article_id3>')

def article_detail3(article_id3):

    return "请求的文章是：%s" %article_id3

@app.route('/p4/<path:article_id4>')

def article_detail4(article_id4):

    return "请求的文章是：%s" %article_id4

# import uuid

# print(uuid.uuid4())

@app.route('/p5/<uuid:article_id5>') #数据的唯一性，长度较长，有损效率（一般在用户表中使用）6a9221f6-afea-424a-a324-8ceaa5bdfc98

def article_detail5(article_id5):

    return "请求的文章是：%s" %article_id5

@app.route('/p6/<any(blog,user):url_path>/<id>/')

def detail(url_path,id):

    if url_path == "blog":

        return "博客详情 %s" %id

    else:

        return "用户详情 %s" %id

#通过问号形式传递参数

@app.route('/d/')

def d():

    wd = request.args.get('wd') #获取浏览器传递参数

    return '通过查询字符串的方式传递的参数是，%s'%wd #请求http://127.0.0.1:8080/d/?wd=php

if __name__ == '__main__':

    app.run(debug=True,host='0.0.0.0',port=8080)

url_for

将视图函数反转回URL，跟app.route相反
URL的更新大于视图函数，所以在大规模项目中比较实用

* 基本使用：

url_for的第一个参数是视图函数的函数名对应的字符串（endpoint），后面的参数就是你传递给url；如果传递的参数在url中已经定义了，那么这个参数就会被当成path的值传递给url；如果这个参数没有在url中定义，那么将变成查询字符串的形式

from flask import Flask,url_for,request

app.route('/')

    return url_for('my_list',page=1,count=2) #这样的话就会在页面上构建出/post/list/1/?count=2的信息

app.route('/post/list/<page>/')

def my_list():

    return 'my list'

为什么需要url_for？

如果将来要修改URL，但没有修改URL对应的函数名，就不用到处去替换URL了。
URL会自动处理特殊字符（转义成十六进制），不需要手动去处理

from flask import Flask,url_for,request

@app.route('/')

def hello_world():

    return url_for('login',next='/current') #页面返回/login/?next=%2Fcurrent登录前的信息

    # print(url_for('my_list',page=1,count=200))

    # return 'hello world'

@app.route('/login/')

def login():

    # next = request.args.get('next') #登录前的信息，在登陆之后仍旧保持

    return 'login'

@app.route('/list/<page>')

def my_list():

    return 'my list'

@app.route('/detail/<id>/')

def detail():

    return 'detail'

if __name__ == '__main__':

    app.run(debug=True)

自定义url转换器

url的参数转换成满足自己需求的数据类型

自定义url转换器的方式：

实现一个类，继承BaseConverter

在自定义的类中重写regex，也就是这个变量的正则表达式
将自定义的类映射到app.url_map.converters上。

实现用户访问/posts/a+b
to_python的作用
这个方法的返回值会传到view函数中作为参数
to_url的作用
这个方法的返回值会调用url_for来生成符合要求的url形式

from flask import Flask,url_for

from werkzeug.routing import BaseConverter

app = Flask(__name__)

#手机号码正则

class TelephoneConveter(BaseConverter):

    regex = r'1[85734]\d{9}'

app.url_map.converters['tel'] = TelephoneConveter

#用户访问/posts/a+b/

class ListConverter(BaseConverter):

    def to_python(self, value):

        return value.split("+")

    def to_url(self, value):

        print(value)

        return '+'.join(value)

        # return "hello"

app.url_map.converters['list'] = ListConverter

@app.route('/')

def hello_world():

    print(url_for('posts',broads=['a','b']))

    return 'Hello World!'

@app.route('/user/<int:user_id>/')

def user(user_id):

    return "your user id is %d" %user_id

@app.route('/telephone/<tel:my_tel>/')

def my_tel(my_tel):

    return "your telephone number is %s"%my_tel

@app.route('/posts/<list:broads>/')

def posts(broads):

    # broads = broads.split("+")

    return "your posts is %s"%broads

if __name__ == '__main__':

    app.run(debug=True)

小细节

在局域网访问站点

app.run(host='0.0.0.0')

指定端口号

默认是5000端口，修改端口如下

app.run(host='0.0.0.0',port=8899 )

ulr唯一

在定义URL的时候，尽量在url后面加/，原因如下：
- 如果不加/的话浏览器访问这个url的时候会默认加/，这样的话就访问不到了
- 搜索引擎会将不加/的url和加/的url是两个不同的url，会将其误解。

GET和POST请求

在网络请求中有许多的请求方式，比如GET,POST,DELETE,PUT,常用的请求方式如下：

GET：也就是获取服务器上的资源，不会修改服务器上的内容。
POST：就是向服务器提交文件或者数据，一般POST会对服务器的状态产生影响。
关于参数传递：
- GET：把参数放到URL中，通过?xx=xxx的形式传递的，因为会把参数放到url中，所以视力好的话，一眼就可以看到传递的参数。
- POST：把参数放到Form Data中，避免被偷窥到的风险（也有可能通过抓包的方式被窃取），一般不安全的，不晓得提交的内容是否是带病毒的文件。

在flask中，route方法，默认只能使用GET的方式请求url。如果想要设置自己的请求方式，那就要在methods中多传递一个请求方式的参数。
实例如下：
创建url_detail的项目，项目结构如下：

├─url_detail.py

├─static

└─templates

   |_login.html

url_detail.py"

from flask import Flask,request,render_template

app = Flask(__name__)

@app.route('/',methods=['GET'])

def hello_world():

    return 'Hello World!'

@app.route('/list/',methods=['POST'])

def my_list():

    return 'list'

@app.route('/login/',methods=["POST","GET"])

def login():

    if request.method == 'GET':

       return render_template('login.html')

    else:

        return "Success"

if __name__ == '__main__':

    app.run(debug=True,host='0.0.0.0')

templates/login.html

<!DOCTYPE html>

<html lang="en">

<head>

    <meta charset="UTF-8">

    <title>Title</title>

</head>

<body>

<form action="",method="POST">

    <input type="text",name="username">

    <input type="text",name="password">

    <input type="submit",name="submmit">

</form>

</body>

</html>

URL重定向

也就是从一个页面跳转到另一个页面，也就是重新定位一个方向
分类：

永久性重定向：http的状态码是301，多用于旧的网址废弃了要转到一个新的网址，确保用户的访问。最经典的就是jingdong.com了
暂时性重定向：http的状态码是302，表示页面暂时性被跳转，比如访问一个需要权限的网址，如果当前用户没有登录，应该重定向到登录页面。这种情况的话就是用暂时性重定向。

在flask中，重定向是通过flask.redirect(location,code=302)这个函数来实现的，location指的是需要重定向到的URL，应该配合之前讲过的url_for()来是用。code代表的是什么类型的重定向，默认是302，可以修改成301实现永久重定向。

小例子：

from flask import Flask,url_for,redirect,request

app = Flask(__name__)

app.debug = True

@app.route('/login/',methods=['GET','POST'])

def login():

    return 'login page'

@app.route('/profile/',methods=['GET','POST'])

def profile():

    name = request.args.get('name')

    if not name:

        return redirect(url_for('login'))

    else:

        return name

if __name__ == '__main__':

    app.run()

这样的话就能访问profile了：

http://127.0.0.1:5000/profile/?name=sss

关于响应

视图函数的返回值会被自动转换成一个响应对象，flask的转换逻辑如下：

如果返回的是一个合法的响应对象，则直接返回
如果返回的是一个字符串，那么flask会重新创建一个werkzeug.wrappers.Response对象。Response会将该字符串作为主体，状态码为200，MIME的类型为text/html，然后返回给Response对象
如果返回的是一个元组，元组中的数据类型是response,status,headers，status会覆盖默认的200状态码，headers可以是一个字典或者列表。作为额外的消息头
如果以上的条件都不满足，flask会假设返回值是一个合法的WSGI应用程序，并通过Response.force_type(rv,request.environ)转换成一个请求对象。
自定义响应：
- 必须继承自Response类
- 实现类方法：force_type
- 必须指定app.response_class为你自定义的Response
- 如果视图函数返回的数据既不是字符串，也不是元组，也不是Response对象，那么会将返回值传给force_type，然后将force_type的返回值返回给前端。

#!/usr/bin/python

# -*- coding:utf8 -*-

from flask import Flask,Response,jsonify

import json

app = Flask(__name__)

app.debug = True

#自定义响应

class JSONResponse(Response):

    @classmethod

    def force_type(cls, response, environ=None):

        '''

        这个方法只有视图函数返回非字符串，非元组，非Response对象才会调用

        :param response:

        :param environ:

        :return:

        '''

        print response

        print type(response)

        if isinstance(response,dict):

            #jsonify除了将字典转换成为json对象，还将对象封装成了一个Response对象

            response = jsonify(response)

            #response = json.dumps(response) #这样转换的话程序启动会报错

        return super(JSONResponse,cls).force_type(response,environ) #返回父类信息

app.response_class = JSONResponse

@app.route('/')

#第一种情况

def hello_world():

    #Response('Hello World',status=200,mimetype='text/html')

    return 'Hello World!'

#第二种情况

@app.route('/list1/')

def list1():

    resp = Response('List1')

    resp.set_cookie('country','china')

    return resp

#第三种情况

@app.route('/list2')

def list2():

    return 'list2',200,{'X-Name':'abc'}

@app.route('/list3/')

def list3():

    return {"username":"abc","age":11}

if __name__ == '__main__':

    app.run(host='0.0.0.0')