Функции представления — рендеринг списка статей и страниц с подробностями
В этой главе вы научитесь запрашивать данные из базы данных с помощью функций представления, рендерить главную страницу и страницы с подробностями, а также разделять маршруты с помощью Blueprint.
Обязанности функций представления
Функции представления Flask несут те же обязанности, что и Django:Получить запрос → Запросить данные → Отрендерить шаблон。
Пример
from flask import Flask, render_template
from models import Post, Category
@app.route("/")
def index():
"""Главная страница блога: отображает все статьи"""
posts = Post.query.order_by(Post.created_at.desc()).all()
categories = Category.query.all()
return render_template('index.html', posts=posts, categories=categories)
Параметры пути и параметры запроса
| Тип параметра | Пример URL | Как получаются представления |
|---|---|---|
| Параметр пути | /post/3 | В маршрутах, <type:variable_name> → параметр функции |
| Параметр запроса | /?category=python | request.args.get('key') |
Маршруты Flask поддерживают несколько преобразователей типов:<int:id>(integer),<string:slug>(по умолчанию, не включает /),<path:path>(содержит /),<float:price>и т. д.
Страница статьи
Пример
from flask import abort
@app.route("/post/<int:post_id>")
def post_detail(post_id):
"""Страница статьи"""
# get_or_404 эквивалентно: Post.query.get(post_id) or abort(404)
post = Post.query.get_or_404(post_id,
description=f'Статья #{post_id} не существует')
return render_template('post_detail.html', post=post)
Пользовательская страница ошибки 404
Пример
def not_found(error):
return render_template('404.html'), 404
Фильтрация по категориям
Пример
from flask import request
@app.route("/")
def index():
category_slug = request.args.get('category', '')
keyword = request.args.get('q', '') # Поиск по ключевому слову (реализовано в главе 6)
posts_query = Post.query.order_by(Post.created_at.desc())
# Фильтр по категории
if category_slug:
posts_query = posts_query.join(Category).filter(Category.slug == category_slug)
posts = posts_query.all()
categories = Category.query.all()
return render_template('index.html',
posts=posts, categories=categories,
category_slug=category_slug, keyword=keyword)
request.argsявляется неизменяемым MultiDict, используется для чтения параметров URL-запроса. Используйте.get('key', '默认值')Безопасное извлечение, возвращает значение по умолчанию, если параметр отсутствует, вместо возбуждения ошибки.
Blueprint — разделение маршрутов
Когда количество функций представлений растёт, размещение их всех в app.py становится неуправляемым.
BlueprintЭто схема группировки маршрутов Flask: разделите представления по функциональным модулям и зарегистрируйте через app.register_blueprint().
app/ ├── blueprints/ │ ├── __init__.py │ ├── main.py # 首页、关于、搜索 │ └── posts.py # 文章列表、详情 ├── templates/ ├── models.py └── __init__.py
Пример
from flask import Blueprint, render_template, request
from app.models import Post, Category
# Blueprint('blueprint_name', __name__, url_prefix='/')
main_bp = Blueprint('main', __name__)
@main_bp.route("/")
def index():
"""Главная страница блога"""
category_slug = request.args.get('category', '')
posts_query = Post.query.order_by(Post.created_at.desc())
if category_slug:
posts_query = posts_query.join(Category).filter(Category.slug == category_slug)
return render_template('index.html',
posts=posts_query.all(),
categories=Category.query.all(),
category_slug=category_slug)
Пример
from flask import Blueprint, render_template, abort
from app.models import Post
posts_bp = Blueprint('posts', __name__)
@posts_bp.route("/post/<int:post_id>")
def post_detail(post_id):
post = Post.query.get_or_404(post_id)
return render_template('post_detail.html', post=post)
Зарегистрируйте Blueprint в точке входа приложения:
Пример
from flask import Flask
from app.blueprints.main import main_bp
from app.blueprints.posts import posts_bp
app = Flask(__name__)
# Регистрация blueprints: все функции представлений blueprints будут объединены в одном приложении
app.register_blueprint(main_bp)
app.register_blueprint(posts_bp)
Blueprint может указывать
url_prefix(напримерurl_prefix='/blog'), тогда все маршруты внутри blueprint автоматически получат этот префикс. Blueprint также может иметь собственные каталоги шаблонов и статических файлов.
Создание шаблонов для главной страницы и страницы подробностей
index.html
Пример
{% extends 'base.html' %}
{% block title %}EXAMPLE Blog - Главная{% endblock %}
{% block content %}
<h2 class="section-title">Последние статьи</h2>
<!-- Навигация фильтра категорий -->
<div class="category-bar">
<a href="{{ url_for('main.index') }}"
class="{% if not category_slug %}active{% endif %}">Все</a>
{% for cat in categories %}
<a href="{{ url_for('main.index', category=cat.slug) }}"
class="{% if category_slug == cat.slug %}active{% endif %}">
{{ cat.name }}
</a>
{% endfor %}
</div>
{% if posts %}
<div class="article-grid">
{% for post in posts %}
<a href="{{ url_for('posts.post_detail', post_id=post.id) }}" class="card-link">
<div class="article-card">
<div class="card-content">
<span class="card-category">{{ post.category.name }}</span>
<h3>{{ post.title }}</h3>
<p>{{ post.summary|truncate(80) }}</p>
<span class="card-date">{{ post.created_at.strftime('%Y-%m-%d') }}</span>
</div>
</div>
</a>
{% endfor %}
</div>
{% else %}
<p class="empty-tip">В этой категории пока нет статей.</p>
{% endif %}
{% endblock %}
При использовании представления Blueprint в url_for() формат следующий:
url_for('蓝图名.函数名'), напримерurl_for('posts.post_detail', post_id=3). Обратите внимание на отличие от Django{% url %}сравнение тегов: Flask использует{{ url_for() }}, можно вкладывать в выражения Python для большей гибкости.
Итоги главы
В этой главе вы освоили представления Flask и организацию маршрутов: Post.query для запроса данных, параметр пути <int:post_id> и параметр запроса request.args, get_or_404 для безопасных запросов, abort(404) и пользовательские страницы ошибок, а также Blueprint для разделения маршрутов по модулям.
Теперь у блога есть три полноценные страницы: список статей на главной, фильтрация по категориям и страницы с подробной информацией.
Другие расширения