Функция избранного и управление бэкендом
В этой главе вы научитесь реализовывать функцию закладок с использованием связей «многие ко многим» и быстро создавать административную панель бэкенда с помощью Flask-Admin.
Проектирование связи «многие ко многим»
Требования к функции избранного:Пользователь может добавить в избранное несколько постов, и пост может быть добавлен в избранное несколькими пользователями.。
В SQLAlchemy связи «многие ко многим» обрабатываются с помощьюассоциативной таблицыреализации.
Пример
from datetime import datetime
# Ассоциативная таблица: не нужно определять её как класс модели, создайте её напрямую с помощью db.Table
favorites = db.Table('favorites',
db.Column('user_id', db.Integer, db.ForeignKey('users.id'), primary_key=True),
db.Column('post_id', db.Integer, db.ForeignKey('posts.id'), primary_key=True),
db.Column('created_at', db.DateTime, default=datetime.utcnow)
)
class Post(db.Model):
__tablename__ = 'posts'
# ... существующие поля остаются без изменений ...
Затем запустите миграцию:
(venv) $ flask db migrate -m "新增收藏关联表" (venv) $ flask db upgrade
Представления добавления в избранное и удаления из избранного
Пример
from flask import Blueprint, render_template, redirect, url_for, request, flash
from flask_login import login_required, current_user
from app.models import Post, db, favorites
user_bp = Blueprint('user', __name__)
@user_bp.route("/favorite/<int:post_id>", methods=['POST'])
@login_required
def toggle_favorite(post_id):
"""Переключить статус избранного"""
post = Post.query.get_or_404(post_id)
# Проверить, добавлено ли уже в избранное: запросить таблицу связей для этой комбинации пользователя и поста
is_faved = db.session.query(favorites).filter(
favorites.c.user_id == current_user.id,
favorites.c.post_id == post.id
).first() is not None
if is_faved:
# Убрать из избранного
db.session.execute(
favorites.delete().where(
(favorites.c.user_id == current_user.id) &
(favorites.c.post_id == post.id)
)
)
db.session.commit()
flash(f'Удалено из избранного "{post.title}"', 'info')
else:
# Добавить в избранное
db.session.execute(
favorites.insert().values(user_id=current_user.id, post_id=post.id)
)
db.session.commit()
flash(f'Добавлено в избранное "{post.title}"', 'success')
return redirect(request.referrer or url_for('main.index'))
@user_bp.route("/favorites")
@login_required
def favorites_list():
"""Список избранного текущего пользователя"""
# Запрос статей, добавленных пользователями в избранное, через таблицу связей
faved_posts = Post.query.join(
favorites, (favorites.c.post_id == Post.id)
).filter(
favorites.c.user_id == current_user.id
).order_by(favorites.c.created_at.desc()).all()
return render_template('favorites.html', posts=faved_posts)
Зарегистрируйте Blueprint в app.py
Пример
app.register_blueprint(user_bp)
Добавьте кнопки избранного на страницу подробной информации и страницу списка
Пример
{% if current_user.is_authenticated %}
<form method="post" action="{{ url_for('user.toggle_favorite', post_id=post.id) }}">
<button type="submit" class="fav-btn">
{% set is_faved = false %}
{# Проверить, находится ли текущий пользователь в списке пользователей, добавивших статью в избранное #}
♡ В избранное
</button>
</форма>
{% endif %}
Операции добавления в закладки используют POST-запросы (отправку формы), а не GET-ссылки. GET-запросы не должны вызывать побочных эффектов (изменения базы данных); это фундаментальный принцип веб-разработки.
Flask-Admin — управление бэкендом
Flask-AdminЭто расширение в экосистеме Flask, эквивалентное Django Admin.
После настройки вы можете управлять статьями и категориями в браузере.
(venv) $ pip install flask-admin
Пример
from flask_admin import Admin
from flask_admin.contrib.sqla import ModelView
from app.models import Post, Category, Пользователь
# Пользовательский ModelView: управление тем, какие поля отображаются в административной панели
class PostAdmin(ModelView):
column_list = ['title', 'category', 'created_at', 'updated_at']
column_searchable_list = ['title', 'summary']
column_filters = ['category', 'created_at']
form_columns = ['title', 'slug', 'summary', 'content', 'category']
class CategoryAdmin(ModelView):
column_list = ['name', 'slug']
form_columns = ['name', 'slug']
# Создание экземпляра Admin
admin = Admin(app, name='ПРИМЕР Админ блога', template_mode='bootstrap4')
admin.add_view(PostAdmin(Post, db.session, name='Статьи'))
admin.add_view(CategoryAdmin(Category, db.session, name='Категории'))
admin.add_view(ModelView(User, db.session, name='Пользователи'))
Запустите сервер и перейдите/admin, и вы сможете войти в интерфейс администратора.
Flask-Admin против Django Admin
| Особенности | Flask-Admin | Django Admin |
|---|---|---|
| Способ интеграции | Стороннее расширение, требует pip install | Встроено в django.contrib.admin |
| Регистрация моделей | admin.add_view(ModelView(Model, session)) | admin.site.register(Model) |
| Поля списка | column_list | list_display |
| Поиск | column_searchable_list | search_fields |
| Filter | column_filters | list_filter |
| Требуется аутентификация | Не встроено (требуется вручную добавить @login_required) | Встроенные права администратора |
Flask-Admin по умолчанию не требует входа для доступа; для контроля прав доступа его нужно использовать вместе с Flask-Login. Простой способ — добавить
@login_required, или переопределить у ModelViewis_accessibleметод для проверки прав администратора.
Итоги главы
В этой главе вы реализовали две важные возможности: использование таблицы ассоциаций db.Table + операций db.session.execute для реализации связи «многие ко многим» для закладок; и использование Flask-Admin для быстрого создания системы управления бэкендом.
Теперь интерактивные функции блога (пользователи, закладки) и функции управления (бэкенд) полностью готовы.
Другие расширения