3.3 Flask 核心概念入门

Flask 核心概念入门教程：应用实例、路由与请求响应详解

Flask 中文教程

本教程详细介绍了Flask的核心概念，包括应用实例的创建与初始化、路由与视图函数的关联逻辑，以及请求与响应的基础流程，适合初学者快速上手Python Web开发。

Flask 核心概念入门教程

简介

Flask 是一个使用 Python 编写的轻量级 Web 框架，它以微型和易用著称，是初学者学习 Web 开发的理想选择。本教程将带你从零开始，深入理解 Flask 的核心概念，包括应用实例的创建、路由与视图函数的关联，以及请求与响应的基本流程。

一、Flask 核心概念入门

在开始编码之前，了解 Flask 的基础概念至关重要。

1. 什么是 Flask？

Flask 是一个微型 Web 框架，它基于 Werkzeug（一个 WSGI 工具库）和 Jinja2（一个模板引擎）。与其他大型框架不同，Flask 提供了基础的 Web 开发功能，如路由、模板渲染和会话管理，但保持了高度的灵活性和扩展性。

2. 核心组件

应用实例（App）：Flask 应用的核心，通过 Flask 类创建，用于配置和管理整个应用。
路由（Route）：定义 URL 路径与视图函数之间的映射关系。
视图函数（View Function）：处理特定请求并返回响应的函数。
请求（Request）：客户端发送的 HTTP 请求数据，如 GET 或 POST 参数。
响应（Response）：服务器返回给客户端的数据，可以是 HTML、JSON 或文件等。

3. 为什么选择 Flask？

简单易学：语法简洁，文档完善。
灵活性：允许开发者根据需要添加扩展。
轻量级：核心功能少，启动快，适合小型到中型项目。

二、应用实例（app）的创建与初始化

创建一个 Flask 应用是入门的第一步。

1. 安装 Flask

在开始之前，确保已安装 Python 和 pip（Python 包管理器）。通过以下命令安装 Flask：

pip install Flask

2. 创建应用实例

在 Python 文件中，导入 Flask 模块并创建一个应用实例。

from flask import Flask

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

解释：__name__ 是一个特殊变量，表示当前模块的名字。Flask 使用它来定位模板和静态文件。应用实例 app 是所有操作的入口点。

3. 初始化配置

初始化可以包括设置调试模式、密钥或其他参数。例如：

app.config['DEBUG'] = True  # 启用调试模式，开发时便于排查错误
app.config['SECRET_KEY'] = 'your_secret_key'  # 设置会话密钥

调试模式：当 DEBUG 为 True 时，Flask 会提供详细的错误信息，并自动重载代码更改。
SECRET_KEY：用于会话、CSRF 保护等安全功能，生产环境应使用随机字符串。

4. 运行应用

定义一个主函数来启动应用。

if __name__ == '__main__':
    app.run(debug=True, host='0.0.0.0', port=5000)

参数说明：
- debug=True：等同于设置 app.config['DEBUG']，启用调试模式。
- host='0.0.0.0'：允许所有 IP 访问，默认为 localhost。
- port=5000：指定端口号，默认是 5000。

运行脚本后，打开浏览器访问 http://localhost:5000 即可看到应用运行。

三、路由与视图函数的关联逻辑

路由是 URL 路径与视图函数的桥梁，让 Flask 知道哪个函数处理哪个请求。

1. 基本路由

使用 @app.route() 装饰器来定义路由。

@app.route('/')
def index():
    return 'Hello, Flask!'

解释：当用户访问根路径（如 http://localhost:5000/）时，Flask 调用 index 函数并返回字符串响应。
装饰器：@app.route('/') 将 index 函数绑定到 URL / 上。

2. 带参数的路由

路由可以包含动态部分，以捕获 URL 中的变量。

@app.route('/user/<username>')
def show_user(username):
    return f'User: {username}'

解释：<username> 是一个占位符，当访问 http://localhost:5000/user/Alice 时，username 被传递为 'Alice' 到 show_user 函数。
类型转换：可以使用 <int:user_id> 等指定类型，如 @app.route('/post/<int:post_id>') 确保 post_id 是整数。

3. 多个路由映射同一函数

一个视图函数可以对应多个路由。

@app.route('/')
@app.route('/home')
def home():
    return 'Welcome to the homepage!'

访问 / 或 /home 都会调用 home 函数。

4. 请求方法

路由可以指定允许的 HTTP 方法，如 GET 或 POST。

from flask import request

@app.route('/login', methods=['GET', 'POST'])
def login():
    if request.method == 'POST':
        # 处理表单提交
        return 'Login successful'
    else:
        # 显示登录页面
        return 'Please login'

methods：列表指定接受的方法，默认为 ['GET']。
request：从 flask 导入，用于获取请求数据。

5. 路由关联逻辑

当 Flask 收到一个请求时：

解析 URL 路径。
匹配已注册的路由规则。
调用对应的视图函数，并传递参数（如果有）。
视图函数返回一个响应对象或字符串，Flask 将其发送给客户端。

四、请求与响应的基础流程

理解请求和响应是 Web 开发的核心。

1. 请求对象（request）

request 对象封装了客户端发送的 HTTP 请求数据。

from flask import request

@app.route('/data')
def get_data():
    # 获取 GET 参数
    name = request.args.get('name', 'Guest')  # 默认为 'Guest' 如果未提供
    # 获取 POST 表单数据
    if request.method == 'POST':
        email = request.form.get('email')
    return f'Name: {name}'

常用属性：
- request.method：HTTP 方法，如 'GET' 或 'POST'。
- request.args：字典形式存储 GET 参数。
- request.form：字典形式存储 POST 表单数据。
- request.files：上传的文件。
- request.headers：HTTP 头部信息。

2. 响应对象（response）

响应是服务器返回给客户端的数据。Flask 视图函数可以返回多种类型：

字符串：自动转换为响应对象，默认 HTML 类型。
响应对象：使用 make_response() 或直接创建 Response 对象。
JSON 数据：使用 jsonify() 返回 JSON 响应。

from flask import jsonify, make_response

@app.route('/json')
def return_json():
    data = {'message': 'Hello', 'status': 'success'}
    return jsonify(data)  # 自动设置 Content-Type 为 application/json

@app.route('/custom')
def custom_response():
    response = make_response('Custom response')
    response.headers['X-Custom-Header'] = 'MyHeader'
    return response

jsonify：将字典转换为 JSON 响应，并设置正确的头部。
状态码：可以指定响应状态码，如 return 'Error', 400 或 return jsonify(error='Not found'), 404。

3. 请求-响应流程

从客户端发起请求到服务器返回响应的完整流程：

客户端发送请求：浏览器或应用发送 HTTP 请求到服务器。
Flask 接收请求：Flask 的 WSGI 服务器（如内置开发服务器）接收请求并传递给应用实例。
路由匹配：应用实例根据 URL 路径匹配定义的路由，找到对应的视图函数。
执行视图函数：Flask 调用视图函数，传递请求数据（通过 request 对象）。
生成响应：视图函数处理逻辑，返回响应数据（字符串、JSON 或响应对象）。
发送响应：Flask 将响应发送回客户端，包括状态码、头部和内容。

示例：完整的简单应用

from flask import Flask, request, jsonify

app = Flask(__name__)

@app.route('/')
def index():
    return 'Welcome to Flask App'

@app.route('/greet/<name>')
def greet(name):
    return f'Hello, {name}!'

@app.route('/api/data', methods=['POST'])
def api_data():
    if request.method == 'POST':
        data = request.json  # 假设发送 JSON 数据
        return jsonify(received=data), 200

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

运行此脚本，测试不同路由来观察请求与响应。

总结

通过本教程，你学习了 Flask 的核心概念：

应用实例：使用 Flask(__name__) 创建和配置。
路由：通过 @app.route() 将 URL 映射到视图函数。
视图函数：处理请求并返回响应。
请求与响应：利用 request 对象获取输入，使用 jsonify 或字符串返回输出。

Flask 的简洁性使其成为学习 Web 开发的绝佳起点。继续实践，探索更多高级功能如模板、数据库集成和扩展。记住，调试模式和文档是你的好帮手！如有疑问，访问 Flask 官方文档。

祝学习愉快！

上一章 3.2 Flask 项目结构解析

下一章 4.1 路由基础配置