实战Flask API项目指南之 Flask基础知识

本系列文章将带你深入探索实战Flask API项目指南，通过跟随小菜的学习之旅，你将逐步掌握Flask 在实际项目中的应用。让我们一起踏上这个精彩的学习之旅吧！

前言

当小菜踏入Flask后端开发的世界，掌握Flask应用的基本结构是起步的关键。本文将深入探讨基本的Flask应用结构，以及如何构建一个简单的Flask应用。

注意：本文叙述的比较详细（即比较啰嗦），不喜欢长篇大论的读者朋友们直接看末尾的  运行Flask应用  即可。

安装

在开始之前，小菜需要安装Flask。可以通过以下步骤进行安装：

1. 打开命令行终端。
2. 运行以下命令来安装 Flask

pip install flask

基础知识

接下来，会在这里介绍有关于Flask的基础知识。

0. 最小的 Flask 应用程序

A Minimal Application：https://flask.palletsprojects.com/en/2.3.x/quickstart/

代码如下：

# hello.py
from flask import Flask

app = Flask(__name__)

@app.route("/")
def hello_world():
    return "<p>Hello, World!</p>"

代码释义：

• 首先导入 Flask类。此类的一个实例将是我们的 WSGI 应用程序。
• 接下来我们创建该类的一个实例。第一个参数是应用程序的模块或包的名称。 __name__ 是一个方便的快捷方式，适用于大多数情况。这是必要的，以便 Flask 知道在哪里寻找模板和静态文件等资源。
• 然后使用route()装饰器告诉Flask什么URL应该触发我们的函数。
• 该函数返回我们想要在用户浏览器中显示的消息。默认内容类型是 HTML，因此字符串中的 HTML 将由浏览器呈现。

在命令行终端，输入flask --app hello run（这个方式有些麻烦，不推荐）

• --app参数指定了Flask应用的名称或导入路径（这里是hello，即文件名hello.py）。
• run命令将启动一个开发服务器来运行你的Flask应用。它会启动一个简单的服务器用于测试和开发。

$ flask --app hello run
 * Serving Flask app 'hello'
 * Running on http://127.0.0.1:5000 (Press CTRL+C to quit)

此时在浏览器访问http://127.0.0.1:5000，可以看到以下画面，这就说明这个web程序成功启动啦！

应用程序发现行为

• 作为快捷方式，如果文件名为 app.py 或 wsgi.py，则不必添加 --app。直接使用 flask run 即可启动flask
• 有关更多详细信息，请参阅命令行界面（这个在下面再做介绍）

为了可以让小菜更深入的去理解，下面来拆解一下上面的这份 最小的 Flask 应用程序 代码。

1. Flask应用的基本结构

Flask应用通常由 Python 文件构成，其中包含了应用的设置、路由、视图函数等。一个简单的Flask 应用通常包含以下几个主要部分：

• 导入Flask类：from flask import Flask
• 创建应用实例：app = Flask(__name__)

# 导入Flask类
from flask import Flask

# 创建应用实例
app = Flask(__name__)

2. 路由与视图函数

路由：routes

视图函数：view function

在Flask中，（在下一章节中，会对该概念进行详细介绍）

• 路由用于定义URL与对应的视图函数之间的映射关系。 它告诉Flask应用在哪个URL路径下执行哪个视图函数。例如，@app.route('/') 装饰器告诉应用当访问根路径 “/” 时，执行后面的视图函数。
• 视图函数则负责处理具体的请求并返回响应。它们包含了你希望在特定URL被访问时执行的逻辑。在下面代码中，def hello_world() 是一个视图函数，它返回一个简单的HTML段落，即 “Hello, World!”。

@app.route("/")
def hello_world():
    return "<p>Hello, World!</p>"

3. 请求与响应

当涉及到Web应用程序时，

• 请求 的是客户端（通常是浏览器）发送给服务器的信息，

• 响应 是服务器对请求作出的回应。

• 当在浏览器中输入URL并按下回车键时，浏览器会向服务器发出一个HTTP请求。在这种情况下，由于装饰器@app.route("/")指定了根路径 ("/") 对应于hello_world函数，因此它会匹配到这个路由。

• 服务器接收到请求后，hello_world函数被调用。这个函数并不需要接收任何参数，因为它只是简单地返回一个字符串。

• 在函数内部，return语句告诉服务器要返回一个响应。在这种情况下，响应是一个简单的HTML段落，即<p>Hello, World!</p>。

• 服务器将响应发送回给浏览器，浏览器会将响应内容解析为HTML并显示在页面上。这就是为什么你在浏览器中访问根路径http://127.0.0.1:5000时，会看到 Hello, World! 个段落。

总结来说，在代码示例中，hello_world函数处理请求，并生成包含 Hello, World! 的响应，最终在浏览器中显示出来。

@app.route("/")
def hello_world():
    return "<p>Hello, World!</p>"

4. 运行Flask应用

这里的两种运行方式效果一致

命令行 运行

还是上面 最小的 Flask 应用程序 的代码，

• 在命令行终端，输入flask --app hello run

$ flask --app hello run

作为快捷方式，如果文件名为 app.py 或 wsgi.py，则不必添加 --app。直接使用 flask run 即可启动flask

$  flask run

Python 运行

修改 最小的 Flask 应用程序 的代码，

• app.run()： 这是在Python代码中直接调用Flask应用实例的run()方法来运行应用。

# app.py
from flask import Flask

app = Flask(__name__)

@app.route("/")
def hello_world():
    return "<p>Hello, World!</p>"


# 追加的代码
if __name__ == '__main__':
    app.run()

这将使应用在调试模式下运行，以便在开发过程中进行实时调试和错误查找。

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

tips

在 app.run() 设置了 debug=True，当代码发生改动时服务器会自动重新加载，并且在出错时提供详细的调试信息。

换句话说，当你的代码发生变化时，Flask 服务器会自动识别修改，并且重新加载你的应用，无需手动停止并重新开始你的服务器。

即热启动。

总结

通过本文，小菜深入了解了Flask应用的基本结构，包括创建应用实例、定义路由和视图函数，以及运行应用的两种方式。

Flask为我们提供了一个简单而强大的方式来构建Web应用程序，让我们能够更好地掌握后端开发的基础。随着不断的实践和学习，小菜将能够更加熟练地运用Flask来开发出功能丰富的API接口的后端平台。