|
|
# 赵瑞萍：评论提交视图模块，用于处理用户评论发布、数据验证、业务逻辑处理及响应返回
|
|
|
# 基于Django FormView实现，支持CSRF保护、表单验证、评论状态控制及回复功能处理
|
|
|
|
|
|
# 赵瑞萍：导入Django核心组件，提供异常处理、响应、数据查询及装饰器支持
|
|
|
from django.core.exceptions import ValidationError # 数据验证异常，用于抛出评论相关业务错误
|
|
|
from django.http import HttpResponseRedirect # 重定向响应类，用于评论成功后跳转
|
|
|
from django.shortcuts import get_object_or_404 # 安全查询数据，不存在则返回404
|
|
|
from django.utils.decorators import method_decorator # 为类视图方法添加装饰器
|
|
|
from django.views.decorators.csrf import csrf_protect # CSRF保护装饰器，防止跨站请求伪造
|
|
|
from django.views.generic.edit import FormView # 表单处理通用类视图，简化表单逻辑
|
|
|
|
|
|
# 赵瑞萍：导入关联模型和表单，支撑评论业务数据处理
|
|
|
from accounts.models import BlogUser # 自定义用户模型，用于关联评论作者
|
|
|
from blog.models import Article # 文章模型，评论需关联具体文章
|
|
|
from .forms import CommentForm # 评论表单，用于前端输入验证
|
|
|
from .models import Comment # 评论模型，用于数据存储
|
|
|
|
|
|
|
|
|
class CommentPostView(FormView):
|
|
|
"""
|
|
|
赵瑞萍：评论提交处理类视图，继承FormView封装表单处理流程
|
|
|
核心功能：接收评论提交请求、验证数据合法性、处理评论保存逻辑、返回对应响应
|
|
|
支持场景：普通评论发布、评论回复、评论审核状态控制、CSRF防护
|
|
|
"""
|
|
|
# 赵瑞萍：指定表单类为CommentForm，用于数据验证和字段映射
|
|
|
form_class = CommentForm
|
|
|
# 赵瑞萍：指定模板为文章详情页，用于表单错误时重新渲染页面并显示错误
|
|
|
template_name = 'blog/article_detail.html'
|
|
|
|
|
|
@method_decorator(csrf_protect)
|
|
|
def dispatch(self, *args, **kwargs):
|
|
|
"""
|
|
|
赵瑞萍：重写dispatch方法，添加CSRF保护
|
|
|
通过method_decorator将csrf_protect装饰器应用到请求分发流程，确保所有请求经过CSRF验证
|
|
|
防止跨站请求伪造攻击，保护评论提交接口安全
|
|
|
"""
|
|
|
# 赵瑞萍：调用父类dispatch方法，维持原有请求分发逻辑
|
|
|
return super(CommentPostView, self).dispatch(*args, **kwargs)
|
|
|
|
|
|
def get(self, request, *args, **kwargs):
|
|
|
"""
|
|
|
赵瑞萍：处理GET请求，避免直接通过URL访问评论提交接口
|
|
|
当用户以GET方式访问时，重定向到对应文章详情页的评论区
|
|
|
"""
|
|
|
# 赵瑞萍：从URL参数中获取文章ID，确定评论所属文章
|
|
|
article_id = self.kwargs['article_id']
|
|
|
# 赵瑞萍：查询文章对象，不存在则返回404
|
|
|
article = get_object_or_404(Article, pk=article_id)
|
|
|
# 赵瑞萍：获取文章绝对URL，拼接评论区锚点，重定向到评论区
|
|
|
url = article.get_absolute_url()
|
|
|
return HttpResponseRedirect(url + "#comments")
|
|
|
|
|
|
def form_invalid(self, form):
|
|
|
"""
|
|
|
赵瑞萍：表单数据验证失败时的处理方法
|
|
|
当用户输入不符合规则（如评论为空、长度超限），重新渲染文章详情页并携带错误信息
|
|
|
"""
|
|
|
# 赵瑞萍：从URL参数获取文章ID，关联当前评论的文章
|
|
|
article_id = self.kwargs['article_id']
|
|
|
# 赵瑞萍：查询文章对象，确保页面渲染时有文章数据
|
|
|
article = get_object_or_404(Article, pk=article_id)
|
|
|
|
|
|
# 赵瑞萍：返回渲染后的页面，携带包含错误信息的表单和文章对象
|
|
|
return self.render_to_response({
|
|
|
'form': form, # 含错误提示的表单对象，前端可渲染错误信息
|
|
|
'article': article # 文章对象，用于页面展示文章内容
|
|
|
})
|
|
|
|
|
|
def form_valid(self, form):
|
|
|
"""
|
|
|
赵瑞萍：表单数据验证通过后的核心业务逻辑处理
|
|
|
完成评论对象的构建、关联数据设置、业务规则校验及保存，最后重定向到评论位置
|
|
|
"""
|
|
|
# 赵瑞萍：获取当前登录用户对象（需登录才能评论）
|
|
|
user = self.request.user
|
|
|
# 赵瑞萍：根据用户ID查询BlogUser实例，作为评论作者
|
|
|
author = BlogUser.objects.get(pk=user.pk)
|
|
|
# 赵瑞萍：从URL参数获取文章ID，确定评论所属文章
|
|
|
article_id = self.kwargs['article_id']
|
|
|
# 赵瑞萍：查询文章对象，不存在则返回404
|
|
|
article = get_object_or_404(Article, pk=article_id)
|
|
|
|
|
|
# 赵瑞萍：业务规则校验——检查文章是否允许评论
|
|
|
# 若文章评论状态为'c'（关闭）或文章状态为'c'（关闭），抛出验证异常
|
|
|
if article.comment_status == 'c' or article.status == 'c':
|
|
|
raise ValidationError("该文章评论已关闭.")
|
|
|
|
|
|
# 赵瑞萍：保存表单数据但不提交到数据库（commit=False），预留字段补充空间
|
|
|
comment = form.save(False)
|
|
|
comment.article = article # 关联评论到对应的文章
|
|
|
|
|
|
# 赵瑞萍：获取博客系统设置，判断评论是否需要审核
|
|
|
from djangoblog.utils import get_blog_setting
|
|
|
settings = get_blog_setting()
|
|
|
# 赵瑞萍：若无需审核，直接设置评论为启用状态（可立即显示）
|
|
|
if not settings.comment_need_review:
|
|
|
comment.is_enable = True
|
|
|
|
|
|
comment.author = author # 关联评论到作者
|
|
|
|
|
|
# 赵瑞萍：处理评论回复功能——判断是否存在父评论ID
|
|
|
if form.cleaned_data['parent_comment_id']:
|
|
|
# 赵瑞萍：根据父评论ID查询父评论对象，建立回复关联
|
|
|
parent_comment = Comment.objects.get(
|
|
|
pk=form.cleaned_data['parent_comment_id'])
|
|
|
comment.parent_comment = parent_comment # 关联当前评论到父评论
|
|
|
|
|
|
# 赵瑞萍：最终将评论数据提交到数据库保存
|
|
|
comment.save(True)
|
|
|
|
|
|
# 赵瑞萍：重定向到文章详情页中当前评论的锚点位置，方便用户查看自己的评论
|
|
|
return HttpResponseRedirect(
|
|
|
"%s#div-comment-%d" %
|
|
|
(article.get_absolute_url(), comment.pk) # 拼接文章URL和评论锚点（如#div-comment-1）
|
|
|
) |
