Функция избранного и управление бэкендом

В этой главе вы научитесь реализовывать функцию закладок с использованием связей «многие ко многим» и быстро создавать административную панель бэкенда с помощью Flask-Admin.


Проектирование связи «многие ко многим»

Требования к функции избранного:Пользователь может добавить в избранное несколько постов, и пост может быть добавлен в избранное несколькими пользователями.。

В SQLAlchemy связи «многие ко многим» обрабатываются с помощьюассоциативной таблицыреализации.

Пример

# Путь к файлу: models.py - добавить таблицу связей и изменить модель Post
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

Представления добавления в избранное и удаления из избранного

Пример

# Путь к файлу: app/blueprints/user.py (новый файл)
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

Пример

from app.blueprints.user import user_bp
app.register_blueprint(user_bp)

Добавьте кнопки избранного на страницу подробной информации и страницу списка

Пример

<!-- Добавьте в область операций со статьёй в post_detail.html и index.html -->
{% 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

Пример

# Путь к файлу: app.py или создайте новый admin_setup.py
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-AdminDjango Admin
Способ интеграцииСтороннее расширение, требует pip installВстроено в django.contrib.admin
Регистрация моделейadmin.add_view(ModelView(Model, session))admin.site.register(Model)
Поля спискаcolumn_listlist_display
Поискcolumn_searchable_listsearch_fields
Filtercolumn_filterslist_filter
Требуется аутентификацияНе встроено (требуется вручную добавить @login_required)Встроенные права администратора

Flask-Admin по умолчанию не требует входа для доступа; для контроля прав доступа его нужно использовать вместе с Flask-Login. Простой способ — добавить@login_required, или переопределить у ModelViewis_accessibleметод для проверки прав администратора.


Итоги главы

В этой главе вы реализовали две важные возможности: использование таблицы ассоциаций db.Table + операций db.session.execute для реализации связи «многие ко многим» для закладок; и использование Flask-Admin для быстрого создания системы управления бэкендом.

Теперь интерактивные функции блога (пользователи, закладки) и функции управления (бэкенд) полностью готовы.

Другие расширения