快速上手python的简单web框架flask

2023-02-06 00:00:00 框架 的是 方法 路由 这是

简介

python可以做很多事情,虽然它的强项在于进行向量运算和机器学习、深度学习等方面。但是在某些时候,我们仍然需要使用python对外提供web服务。

比如我们现在有一个用python写好的模型算法,这个模型算法需要接收前端的输入,然后进行模拟运算,终得到后的输出。这个流程是一个典型的web服务,与其我们使用java或者nodejs来搭建一个web服务器,不如我们就使用python自己的web框架来实现这一目标,减少技术栈的同时,还可以实现代码逻辑的统一,何乐而不为呢?

其实python的web框架也有很多种,比如django、flask等等。

这本系列的文章中,我们会介绍flask这个轻量级的web框架。

web框架的重要组成部分

相信大家都用过不少web框架吧,从java的spring MVC,到nodejs的express和koa,有功能复杂的,也有功能简单的。

但是不管他们的功能如何,其重要基本的一个功能就是能够提供web服务,也就是说可以接收HTTP或者HTTPS的请求,然后返回对应的数据。这个功能通常包含的是核心的路由跳转功能。

有了这个核心的功能,web框架基本上就可以正常运行了。配合上现在流行的前后端分离技术,一切水到渠成。

如果不想用前后端分离,那么web框架还需要涉及到页面的呈现技术。一般来说都会使用模板引擎作为前端页面的呈现形式。

然后配合上对数据库、缓存、消息队列、静态资源、日志、调试等附加的功能,一个完整的web框架就完成了。

flask虽然是一个轻量级web框架,但是该有的功能它全都有。

它的核心是提供了对web路由的支持,同时支持Jinja的模板语言。

快速上手flask

flask是一个非常简单优雅的web框架,flask需要Python 3.7及以上版本的支持。

为了区分python的不同开发环境,我们在使用flask的时候,可以使用python自带的venv来创建不同的虚拟环境。venv跟conda的env很类似,都是用来创建虚拟环境,从而实现不同的环境进行分离的作用。

使用venv非常简单,如果你用的开发工具是pycharm,那么在创建python的flask项目的时候,会自动选择对应的虚拟环境创建工具,这里我们选择使用venv即可自动创建。

当然你也可以使用下面的命令来手动创建venv:

$ mkdir learn-flask
$ cd learn-flask
$ python3 -m venv venv

创建好venv之后,使用下面的命令来激活这个env:

. venv/bin/activate

venv安装完毕之后,我们可以使用下面的命令安装flask:

pip install Flask

安装完毕之后,你可以在python项目site-packages里面找到flask对应的依赖包:

可以看到里面出了flask之外,还有其他的一些第三方依赖包,这些都是可以在后续的flask应用中使用到的。

flask的个应用

flask的依赖包都安装好之后,我们就可以写一个简单的web应用程序了,我们把这个应用程序命名为first.py:

from flask import Flask

app = Flask(__name__)

@app.route('/')
def first():
    return "<p>这是我的个flask程序!</p>"

if __name__ == '__main__':
    app.run()

和普通的python程序不同的是,这里我们先实例化了一个Flask对象,然后用类似注解的方式定义了一个route在fist这个方法上。

程序写好了,如果你在pycharm IDE中,那么可以右键运行,可以得到下面的内容:

FLASK_APP = first.py
FLASK_ENV = development
FLASK_DEBUG = 
In folder /Users/data/git/ddean2009/learn-flask
/Users/data/git/ddean2009/learn-flask/venv/bin/python -m flask run 
 * Serving Flask app 'first.py'
 * Debug mode: off
WARNING: This is a development server. Do not use it in a production deployment. Use a production WSGI server instead.
 * Running on http://127.0.0.1:5000

可以看到IDE为我们设置了几个环境变量,分别是FLASK_APP:表示要运行的app名称。FLASK_ENV:表示现在的运行环境是开发环境还是线上环境。FLASK_DEBUG表示是否是debug模式。

终我们可以访问默认的http://127.0.0.1:5000,可以得到下面的内容:

说明整个程序运行成功了。

如果你想通过命令行来执行flask的应用,那么可以用下面的命令:

flask --app first run

注意,这里我们添加了--app这个参数来指定要运行的app名称。如果不指定的话,flask会去寻找名叫app.py或者wsgi.py的文件。如果你有这两个文件,那么就可以直接使用flask run来运行了。

这里的flask相当于python -m flask。

默认情况下flask的应用程序只能通过本地的浏览器来访问,如果你想通过远程来访问的话,可以指定访问的host,如下所示:

flask run --host=0.0.0.0

到此,我们的一个基本的简单的flask web应用就完成了。

什么?你还要了解更多?别急,下面我们再详细介绍一些web应用程序所必须了解的知识。

flask中的路由

路由也叫Routing,它是web应用程序中的灵魂,通过路由来定义各种URL和访问路径。

在flask中,可以使用@app.route来对路由进行定义。@app.route类似于注解,可以放置在python的方法之上。

route中可以定义路由的名称,路由的名称可以跟方法的名称不一样:

@app.route('/test')
def test123():
    return '我是一个测试'

路由的名称还可以是动态的,可以取一个跟注解方法中参数的名称一样的参数名作为路由的参数用一个尖括号括起来,如下所示:

from markupsafe import escape

@app.route('/student/<name>')
def what_is_your_name(name):
    return f'你的名字是: {escape(name)}'

这里的方法体中我们调用了python的f函数来对字符串进行格式化,在内部为了防止web输入端的恶意注入,这里引用了markupsafe的escape方法,可以对输入的字符串进行转义,从而避免了恶意的攻击。

除了在路径中指定参数之外,我们还可以自行指定参数的类型,在flask中路径参数可以设置为下面的几种类型:

类型说明
string默认类型,可以接收除了/之外的任何字符串
int可以接收正整数
float可以接收正的浮点数
path和string类似,但是可以接收/
uuid接收uuid字符串

相关文章