flask- 基础学习

一、Web框架

web网站发展至今，特别是服务器端，涉及到的知识、内容，很是普遍。这对程序员的要求会愈来愈高。若是采用成熟，稳健的框架，那么一些基础的工做，好比，安全性，数据流控制等均可以让框架来处理，那么程序开发人员能够把精力放在具体的业务逻辑上面。使用框架的优势：

稳定性和可扩展性强
能够下降开发难度，提升开发效率。
在 Python 中经常使用的 Web 框架有:

    Flask 、Django、Tornado

二、Flask简介

Flask 是一个 Python 实现的 Web 开发微框架。你正在阅读的是开发版本的文档。

中文文档（http://docs.jinkan.org/docs/flask/）

英文文档（http://flask.pocoo.org/docs/0.11/）

三、HelloWorld示例-基础

第一步   导入Flask类

from flask import Flask

第二步    Flask函数接收一个参数__name__，它会指向程序所在的包

app = Flask(name)
 

第三步   装饰器的做用是将路由映射到视图函数 demo ,并返回 helloworld

@app.route('/')
def demo(): å     return "helloworld!!"
  å

第四步   Flask应用程序实例的 run 方法 启动 WEB 服务器

if name == 'main':
    app.run()

四、相关配置参数
    四、1    初始化参数
Flask 程序实例在建立的时候，须要默认传入当前 Flask 程序所指定的包(模块)，接下来就来详细查看一下 Flask 应用程序在建立的时候一些须要咱们关注的参数：

app = Flask(name,  # Flask程序所在的包(模块)，传 name 就能够 ;其能够决定 Flask 在访问静态文件时查找的路径
            static_path='static',  # 静态文件访问路径(不推荐使用，使用 static_url_path 代替)
            static_url_path='static',  # 静态文件访问路径，能够不传，默认为：/ + static_folder
            static_folder='static',  # 静态文件存储的文件夹，能够不传，默认为 static
            template_folder='templates'  # 模板文件存储的文件夹，能够不传，默认为 templates
            )

四、2    程序加载配置
在 Flask 程序运行的时候，能够给 Flask 设置相关配置，好比：配置 Debug 模式，配置数据库链接地址等等，设置 Flask 配置有如下三种方式：

第一种   从对象中加载配置

class Config(object):     DEBUG = True  
app.config.from_object(Config)
 

第二种   从文件中加载配置

app.config.from_pyfile('config.ini')
 

第二种   从环境变量中加载配置

app.config.from_envvar('ENVCONFIG')
四、3    app.run的参数
能够指定运行的主机IP地址，端口，是否开启调试模式
app.run(host="0.0.0.0", port=5000, debug = True)

五、Flask中的路由
5.1    指定路由地址：

指定访问路径为 demo1

@app.route('/demo1')
def demo1():
    return 'demo1'
5.2    给路由传参示例：有时咱们须要将同一类 URL 映射到同一个视图函数处理，好比：使用同一个视图函数来显示不一样用户的我的信息。

路由传递参数

@app.route('/user/<user_id>')
def user_info(user_id):
    return 'hello %s' % user_id
路由传递的参数默认当作 string 处理，也能够指定参数的类型

路由传递参数

@app.route('/user/int:user_id')
def user_info(user_id):
    return 'hello %d' % user_id
这里指定int，尖括号中的内容是动态的，在此暂时能够理解为接受 int 类型的值，实际上 int 表明使用 IntegerConverter 去处理 url 传入的参数

5.3    指定请求方式：

@app.route('/demo2', methods=['GET', 'POST'])
def demo2():
    # 直接从请求中取到请求方式并返回
    return request.method

六、视图经常使用逻辑
六、1    返回JSON

在使用 Flask 写一个接口时候须要给客户端返回 JSON 数据，在 Flask 中能够直接使用 jsonify 生成一个 JSON 的响应

返回JSON

@app.route('/demo4')
def demo4():
    json_dict = {
        "user_id": 10,
        "user_name": "laowang"
    }
    return jsonify(json_dict)
注：不推荐使用 json.dumps 转成 JSON 字符串直接返回，由于返回的数据要符合 HTTP 协议规范，若是是 JSON 须要指定 content-type:application/json
      
六、2    重定向
重定向到百度网址

重定向

@app.route('/demo5')
def demo5():
    return redirect('http://www.baidu.com')
重定向也可使用url_for生成指定视图函数所对应的url

@app.route('/demo1')
def demo1():
    return 'demo1'
 

重定向

@app.route('/demo5')
def demo5():
    return redirect(url_for('demo1'))
重定向能够到带参数的视图函数, 在url_for 函数中传入参数

路由传递参数

@app.route('/user/int:user_id')
def user_info(user_id):
    return 'hello %d' % user_id
 

重定向

@app.route('/demo5')
def demo5():
    # 使用 url_for 生成指定视图函数所对应的 url
    return redirect(url_for('user_info', user_id=100))
6.3 自定义状态码

在 Flask 中，能够很方便的返回自定义状态码，以实现不符合 http 协议的状态码，例如：status code: 666

@app.route('/demo6')
def demo6():
    return '状态码为 666', 666

七、正则匹配路由
在 web 开发中，可能会出现限制用户访问规则的场景，那么这个时候就须要用到正则匹配，根据本身的规则去限定请求参数再进行访问

具体实现步骤为：

导入转换器基类：在 Flask 中，全部的路由的匹配规则都是使用转换器对象进行记录
自定义转换器：自定义类继承于转换器基类
添加转换器到默认的转换器字典中
使用自定义转换器实现自定义匹配规则

一、代码实现

from flask import Flask

第一步:导入转换器基类

from werkzeug.routing import BaseConverter
 
 

第二步:自定义转换器类

class RegexConverter(BaseConverter):
    def init(self, url_map, *args):
        super(RegexConverter, self).init(url_map)
        # 将接收到的第一个参数当作匹配规则进行保存
        self.regex = args[0]
 
 
app = Flask(name)

第三步: 将自定义转化器添加到转化器字典中去, 并指定转化器使用时的名字为:re

app.url_map.converters['re'] = RegexConverter
 
 

第四步: 使用转化器实现自定义匹配规则, 此处定义的是6位整数

@app.route('/user/<re("[0-9]{6}:user_id")>')
def user_info(user_id):
    return "user_id 为 %s" % user_id
 
 
if name == 'main':
    app.run(debug=True)

七、2    自定义转换器其余两个函数实现--to_python 和 to_url

to_python：

该函数参数中的 value 值表明匹配到的值，可输出进行查看
匹配完成以后，对匹配到的参数做最后一步处理再返回，好比：转成 int 类型的值再返回：
to_url：

在使用 url_for 去获取视图函数所对应的 url 的时候，会调用此方法对 url_for 后面传入的视图函数参数作进一步处理
具体可参见 Flask 的 app.py 中写的示例代码：ListConverter

from flask import Flask
from flask import redirect
from flask import url_for
from werkzeug.routing import BaseConverter
 
class ListConverter(BaseConverter):
    regex = "(\\d+,?)+\\d$" #匹配多个数字字符串
 
    def to_python(self, value):
        #对匹配到的参数作进一步处理再返回(访问数据的时候)
        return value.split(',')  #字符串->列表
 
    def to_url(self, value):
        #对视图函数参数作进一步处理(返回数据的时候)
        #针对url_for()中的参数作处理
        result = ','.join(str(v) for v in value) # 列表->字符串
        return result
app = Flask(name)
app.url_map.converters["list"] = ListConverter
 
@app.route('/')
def index():
    return 'index'
 
#规定访问的参数必须是列表
@app.route('/users/list:user_ids')
def demo2(user_ids):
    #print(type(user_ids)) #列表
    return "用户的id列表是 %s" % user_ids #当作字符串返回
 
@app.route('/demo3')
def demo3():
    #url_for 经过函数匹配路由，在匹配的时候能够调用to_url
    return redirect(url_for('demo2', user_ids=[1, 3, 4, 5]))
 
if name == 'main':
    app.run(debug=True)
七、3    系统自带的转化器

DEFAULT_CONVERTERS = {
    'default':          UnicodeConverter,
    'string':           UnicodeConverter,
    'any':              AnyConverter,
    'path':             PathConverter,
    'int':              IntegerConverter,
    'float':            FloatConverter,
    'uuid':             UUIDConverter,
}
系统自带的转换器具体使用方式在每种转换器的注释代码中有写，请留意每种转换器初始化的参数。

八、异常捕获
八、1    HTTP 异常主动抛出
abort 方法：抛出一个给定状态代码的 HTTPException 或者 指定响应，例如想要用一个页面未找到异常来终止请求，你能够调用 abort(404)。只能抛出 HTTP 协议的错误状态码

abort(404)

abort(500)

八、2    捕获错误

errorhandler 装饰器：注册一个错误处理程序，当程序抛出指定错误状态码的时候，就会调用该装饰器所装饰的方法，参数为HTTP的错误状态码或指定异常；

@app.errorhandler(500)
def internal_server_error(e):
    return '服务器搬家了'
捕获制定异常：

@app.errorhandler(ZeroDivisionError)
def zero_division_error(e):
    return '除数不能为0'

九、请求勾子
在客户端和服务器交互的过程当中，有些准备工做或扫尾工做须要处理，好比：

在请求开始时，创建数据库链接；
在请求开始时，根据需求进行权限校验；
在请求结束时，指定数据的交互格式；
请求钩子是经过装饰器的形式实现，Flask支持以下四种请求钩子：

before_first_request
在处理第一个请求前执行
before_request
在每次请求前执行
若是在某修饰的函数中返回了一个响应，视图函数将再也不被调用
after_request
若是没有抛出错误，在每次请求后执行
接受一个参数：视图函数做出的响应
在此函数中能够对响应值在返回以前作最后一步修改处理
须要将参数中的响应在此参数中进行返回
teardown_request：
在每次请求后执行
接受一个参数：错误信息，若是有相关错误抛出

十、装饰器路由具体实现梳理
Flask有两大核心：Werkzeug和Jinja2：

- Werkzeug实现路由、调试和Web服务器网关接口
- Jinja2实现了模板。
Werkzeug库的 routing 模块负责实现 URL 解析。不一样的 URL 对应不一样的视图函数，routing模块会对请求信息的URL进行解析，匹配到URL对应的视图函数，执行该函数以今生成一个响应信息。
routing模块内部有：

Rule类
用来构造不一样的URL模式的对象，路由URL规则
Map类
存储全部的URL规则和一些配置参数
BaseConverter的子类
负责定义匹配规则
MapAdapter类
负责协调Rule作具体的匹配的工做

十一、request
request 就是flask中表明当前请求的 request 对象，其中一个请求上下文变量(理解成全局变量，在视图函数中直接使用能够取到当前本次请求)

经常使用的属性以下：

属性    说明    类型
data    记录请求的数据，并转换为字符串    *
form    记录请求中的表单数据    MultiDict
args    记录请求中的查询参数    MultiDict
cookies    记录请求中的cookie信息    Dict
headers    记录请求中的报文头    EnvironHeaders
method    记录请求使用的HTTP方法    GET/POST
url    记录请求的URL地址    string
files    记录请求上传的文件    *

十二、状态保持
 http 是一种无状态协议，浏览器请求服务器是无状态的

无状态：指一次用户请求时，浏览器、服务器没法知道以前这个用户作过什么，每次请求都是一次新的请求。

无状态缘由：浏览器与服务器是使用 socket 套接字进行通讯的，服务器将请求结果返回给浏览器以后，会关闭当前的 socket 链接，并且服务器也会在处理页面完毕以后销毁页面对象。

可是实际状况须要保持用户浏览的状态，一般有两种方式：

在客户端存储信息使用Cookie
在服务器端存储信息使用Session

十二、1     Cookie
Cookie： 指某些网站为了辨别用户身份、进行会话跟踪而储存在用户本地的数据（一般通过加密）；Cookie是由服务器端生成，发送给客户端浏览器，浏览器会将Cookie的key/value保存，下次请求同一网站时就发送该Cookie给服务器（前提是浏览器设置为启用cookie）；Cookie的key/value能够由服务器端本身定义。

应用：
最典型的应用是断定注册用户是否已经登陆网站，用户可能会获得提示，是否在下一次进入此网站时保留用户信息以便简化登陆手续，这些都是Cookie的功用。
网站的广告推送，常常遇到访问某个网站时，会弹出小窗口，展现咱们曾经在购物网站上看过的商品信息。
购物车，用户可能会在一段时间内在同一家网站的不一样页面中选择不一样的商品，这些信息都会写入Cookie，以便在最后付款时提取信息。
提示：

Cookie是存储在浏览器中的一段纯文本信息，建议不要存储敏感信息如密码，由于电脑上的浏览器可能被其它人使用
Cookie基于域名安全，不一样域名的Cookie是不能互相访问的
如访问itcast.cn时向浏览器中写了Cookie信息，使用同一浏览器访问baidu.com时，没法访问到itcast.cn写的Cookie信息
浏览器的同源策略
当浏览器请求某网站时，会将本网站下全部Cookie信息提交给服务器，因此在request中能够读取Cookie信息

Cookie的增删改查代码：
from flask import Flask, make_response, request
 
app = Flask(name)
 
 
@app.route('/')
def index():
    # 查询cookie
    user_id = request.cookies.get('user_id')
    user_name = request.cookies.get('user_name')
    return '%s----%s' % (user_id, user_name)
 
 
@app.route('/login')
def login():
    response = make_response('success')
    # 设置cookie
    response.set_cookie('user_id', '1')
    response.set_cookie('user_name', 'laowang')
    print("login"+str(response))
    return response
 
@app.route('/logout')
def logout():
    response = make_response('success')
    # 删除cookie
    response.delete_cookie('user_id')
    response.delete_cookie('user_name')
    print("logout" + str(response))
    return response
 
if name == 'main':
    app.run(debug=True)
设置过时时间
@app.route('/cookie')
def set_cookie():
    response = make_response('hello world')
    response.set_cookie('username', 'itheima', max_age=3600)
    return response
十二、2    Session
对于敏感、重要的信息，建议要存储在服务器端，不能存储在浏览器中，如用户名、余额、等级、验证码等信息
在服务器端进行状态保持的方案就是Session
Session依赖于Cookie
增删改查代码：
from flask import Flask, session
 
app = Flask(name)

使用session 须要设置SECRET_KEY

app.config['SECRET_KEY'] = 'dnuqi12kqiejadklalw'
 
 
@app.route('/')
def index():
    # 查询session
    user_id = session.get('user_id', "")
    user_name = session.get('user_name', "")
    return '%s====%s' % (user_id, user_name)
 
 
@app.route('/login')
def login():
    # 加载校验成功  设置session
    session['user_id'] = '1'
    session['user_name'] = 'laowang'
    return 'login success!'
 
 
@app.route('/logout')
def logout():
    # 删除session
    session.pop('user_id', None)
    session.pop('user_name', None)
    return 'logout ok!'
 
 
if name == 'main':
    app.run(debug=True)

1三、上下文
Flask中有两种上下文，请求上下文（request context）和应用上下文(application context)
1三、1    请求上下文(request context)

在 flask 中，能够直接在视图函数中使用 request 这个对象进行获取相关数据，而 request 就是请求上下文的对象，保存了当前本次请求的相关数据，请求上下文对象有：request、session

request
封装了HTTP请求的内容，针对的是http请求。举例：user = request.args.get('user')，获取的是get请求的参数。
session
用来记录请求会话中的信息，针对的是用户信息。举例：session['name'] = user.id，能够记录用户信息。还能够经过session.get('name')获取用户信息。
1三、2    应用上下文(application context)

它的字面意思是 应用上下文，但它不是一直存在的，它只是request context 中的一个对 app 的代理(人)，所谓local proxy。它的做用主要是帮助 request 获取当前的应用，它是伴 request 而生，随 request 而灭的。

应用上下文对象有：current_app，g

current_app
应用程序上下文,用于存储应用程序中的变量，能够经过current_app.name打印当前app的名称，也能够在current_app中存储一些变量，例如：

应用的启动脚本是哪一个文件，启动时指定了哪些参数
加载了哪些配置文件，导入了哪些配置
连了哪一个数据库
有哪些public的工具类、常量
应用跑再哪一个机器上，IP多少，内存多大

g变量
g 做为 flask 程序全局的一个临时变量,充当者中间媒介的做用,咱们能够经过它传递一些数据，g 保存的是当前请求的全局变量，不一样的请求会有不一样的全局变量，经过不一样的thread id区别

g.name='abc'
注意：不一样的请求，会有不一样的全局变量

1三、3    二者区别： 请求上下文：保存了客户端和服务器交互的数据 应用上下文：flask 应用程序运行过程当中，保存的一些配置信息，好比程序名、数据库链接、应用信息等