第十三章 用户评论
允许用户互动交流时社交博客平台成功的关键。在本章中,我们将学习如何实现用户评论功能。这一技术可以直接应用到大型的社交程序当中。
准备评论数据库
评论和普通博客文章没有什么不同,同样有内容,作者和时间戳,在这个部分中都是使用了Markdown语法写的。图13-1展示了数据库中comments表和其他表的关系:
评论是针对特定的博客文章的,所以在posts表中需要定义一个一对多关系。我们将使用这个关系来获取指定文章的所有相关评论列表。
comment表和users表组成了一对多的关系。通过这一关系我们可以获取某一用户的所有评论,统计他写了多少评论,等一些信息都可以展示在用户属性页面上。Comment模型的定义如下(13-1)所示:
Example 13-1. app/models.py: Comment model
class Comment(db.Model):
__tablename__ = 'comments'
id = db.Column(db.Integer, primary_key=True)
body = db.Column(db.Text)
body_html = db.Column(db.Text)
timestamp = db.Column(db.DateTime, index=True, default=datetime.utcnow)
disabled = db.Column(db.Boolean)
author_id = db.Column(db.Integer, db.ForeignKey('users.id'))
post_id = db.Column(db.Integer, db.ForeignKey('posts.id'))
@staticmethod
def on_changed_body(target, value, oldvalue, initiator):
allowed_tags = ['a', 'abbr', 'acronym', 'b', 'code', 'em', 'i','strong']
target.body_html = bleach.linkify(bleach.clean(markdown(value, output_format='html'),
tags=allowed_tags, strip=True))
db.event.listen(Comment.body, 'set', Comment.on_changed_body)
comment模型的属性跟post模型基本一样,但添加了一个disabled字段,通过设置它的boolean值,版主可以禁止或屏蔽攻击性和不合适的言论。就像对博客文章的处理那样,评论也定义了一个事件触发器,当body字段变更时,就会自动把markdown文本转换成HTML。这一流程跟我们在第十一章中对博客文章的处理一样,但由于评论的内容通常较短,markdown转换过程中允许的html标记更少,段落标记被移除了,只留下了字符格式化标记。
为了完成数据库更改,User和Post模型也都需要和comments表建立一对多关系,如例子13-2所示:
Example 13-2. app/models/user.py: One-to-many relationships from users and posts to comments
class User(db.Model):
# ...
comments = db.relationship('Comment', backref='author', lazy='dynamic')
class Post(db.Model):
# ...
comments = db.relationship('Comment', backref='post', lazy='dynamic')
提交并显示Comment
在本程序中,我们在第十一章中通过添加永久链接,在单独页面中显示了博客文章评论,评论也在这一页面显示。同时,这页上也包含了一个表单用来提交评论。例子13-3显示了用来输入评论的web表单——只包含一个简单的文本域和一个提交按钮。
Example 13-3. app/main/forms.py: Comment input form
class CommentForm(Form):
body = StringField('', validators=[Required()])
submit = SubmitField('Submit')
例子13-4展示了更新后的路由设置,通过/post/<int:id>支持评论
Example 13-4. app/main/views.py: Blog post comments support
@main.route('/post/<int:id>', methods=['GET', 'POST'])
def post(id):
post = Post.query.get_or_404(id)
form = CommentForm()
if form.validate_on_submit():
comment = Comment(body=form.body.data,post=post,
author=current_user._get_current_object())
db.session.add(comment)
flash('Your comment has been published.')
return redirect(url_for('.post', id=post.id, page=-1))
page = request.args.get('page', 1, type=int)
if page == -1:
page = (post.comments.count() - 1) /
current_app.config['FLASKY_COMMENTS_PER_PAGE'] + 1
pagination = post.comments.order_by(Comment.timestamp.asc()).paginate(
page, per_page=current_app.config['FLASKY_COMMENTS_PER_PAGE'],
error_out=False)
comments = pagination.items
return render_template('post.html', posts=[post], form=form,
comments=comments, pagination=pagination)
该视图函数实例化评论表单并将其发送到post.html模板进行显示。当提交表单时,加入一个新评论的逻辑流程类似于对博客文章的处理。如同在Post例子中那样,评论的author不能直接设置成current_user,因为这个变量是一个上下文代理对象。表达式current_user._get_current_object()返回的是实际的User对象。