Función de favoritos y administración de backend
En este capítulo aprenderás a implementar la función de favoritos usando relaciones muchos a muchos y a crear rápidamente una administración de backend con Flask-Admin.
Diseño de relaciones muchos a muchos
Requisitos de la función de favoritos:Un usuario puede marcar como favoritos múltiples artículos, y un artículo puede ser marcado como favorito por múltiples usuarios。
En SQLAlchemy, las relaciones muchos a muchos se implementan medianteTabla de asociación (Association Table).
Ejemplo
from datetime import datetime
# Tabla de asociación: no es necesario definirla como clase de modelo, se crea directamente con 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'
# ... los campos existentes no cambian ...
Luego ejecuta la migración:
(venv) $ flask db migrate -m "新增收藏关联表" (venv) $ flask db upgrade
Vistas de favoritos y cancelar favoritos
Ejemplo
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):
"""Alternar estado de favorito"""
post = Post.query.get_or_404(post_id)
# Verificar si ya está en favoritos: consultar si existe esta combinación de usuario-artículo en la tabla de asociación
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:
# Cancelar favorito
db.session.execute(
favorites.delete().where(
(favorites.c.user_id == current_user.id) &
(favorites.c.post_id == post.id)
)
)
db.session.commit()
flash(f'Se ha cancelado el favorito de «{post.title}»', 'info')
else:
# Agregar a favoritos
db.session.execute(
favorites.insert().values(user_id=current_user.id, post_id=post.id)
)
db.session.commit()
flash(f'Se ha agregado «{post.title}» a favoritos', 'success')
return redirect(request.referrer or url_for('main.index'))
@user_bp.route("/favorites")
@login_required
def favorites_list():
"""Lista de favoritos del usuario actual"""
# Consultar los artículos favoritos del usuario a través de la tabla de asociación
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)
Registrar Blueprint en app.py
Ejemplo
app.register_blueprint(user_bp)
Agregar botón de favoritos en la página de detalles y la página de listado
Ejemplo
{% 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 %}
{# Verificar si el usuario actual está en la lista de favoritos del artículo #}
♡ Favorito
</button>
</form>
{% endif %}
La operación de favorito utiliza una solicitud POST (envío de formulario), no un enlace GET. Las solicitudes GET no deben producir efectos secundarios (modificar la base de datos); este es un principio básico del desarrollo web.
Flask-Admin — Administración de backend
Flask-AdminEs la extensión en el ecosistema Flask equivalente a Django Admin.
Después de la configuración, puedes gestionar los datos de artículos y categorías en el navegador.
(venv) $ pip install flask-admin
Ejemplo
from flask_admin import Admin
from flask_admin.contrib.sqla import ModelView
from app.models import Post, Category, User
# Personalizar ModelView: controlar qué campos se muestran en el backend
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']
# Crear instancia de Admin
admin = Admin(app, name='Panel de administración del blog EJEMPLO', template_mode='bootstrap4')
admin.add_view(PostAdmin(Post, db.session, name='Artículos'))
admin.add_view(CategoryAdmin(Category, db.session, name='Categorías'))
admin.add_view(ModelView(User, db.session, name='Usuarios'))
Inicia el servidor y visita/adminpara acceder a la interfaz de administración de backend.
Flask-Admin vs Django Admin
| Característica | Flask-Admin | Django Admin |
|---|---|---|
| Método de integración | Extensión de terceros, requiere pip install | Integrado en django.contrib.admin |
| Registro de modelos | admin.add_view(ModelView(Model, session)) | admin.site.register(Model) |
| Campos de lista | column_list | list_display |
| Búsqueda | column_searchable_list | search_fields |
| Filtrado | column_filters | list_filter |
| Requiere autenticación | No integrado (requiere agregar @login_required manualmente) | Permisos de administrador integrados |
Flask-Admin no requiere inicio de sesión para acceder por defecto; es necesario combinarlo con Flask-Login para agregar control de permisos. Una forma sencilla es agregar antes de la función de vista
@login_required, o sobrescribir el método de ModelViewis_accessiblepara verificar los permisos de administrador.
Resumen del capítulo
En este capítulo implementaste dos funciones importantes: la relación muchos a muchos de favoritos usando la tabla de asociación db.Table + operaciones db.session.execute; y la creación rápida del sistema de administración de backend con Flask-Admin.
Ahora las funciones interactivas del blog (usuarios, favoritos) y las funciones de administración (backend) están completas.
Otras extensiones