|
|
# 导入Django配置、数据库模型、时间工具和翻译工具
|
|
|
from django.conf import settings
|
|
|
from django.db import models
|
|
|
from django.utils.timezone import now # 获取当前时区时间的工具
|
|
|
from django.utils.translation import gettext_lazy as _ # 国际化翻译工具，用于多语言支持
|
|
|
|
|
|
# 导入博客文章模型，评论将与文章关联
|
|
|
from blog.models import Article
|
|
|
|
|
|
|
|
|
# 创建评论模型（数据库表结构的抽象）
|
|
|
class Comment(models.Model):
|
|
|
# 评论正文：文本字段，最大长度300， verbose_name为'正文'（后台显示名称）
|
|
|
body = models.TextField('正文', max_length=300)
|
|
|
|
|
|
# 创建时间：日期时间字段，使用当前时区时间作为默认值，国际化翻译字段名为'creation time'
|
|
|
creation_time = models.DateTimeField(_('creation time'), default=now)
|
|
|
|
|
|
# 最后修改时间：日期时间字段，默认值为当前时间（后续可通过代码更新）
|
|
|
last_modify_time = models.DateTimeField(_('last modify time'), default=now)
|
|
|
|
|
|
# 评论作者：外键关联到Django内置用户模型（settings.AUTH_USER_MODEL）
|
|
|
# on_delete=models.CASCADE表示：如果用户被删除，其评论也会被级联删除
|
|
|
author = models.ForeignKey(
|
|
|
settings.AUTH_USER_MODEL,
|
|
|
verbose_name=_('author'),
|
|
|
on_delete=models.CASCADE)
|
|
|
|
|
|
# 关联文章：外键关联到博客文章模型（Article）
|
|
|
# on_delete=models.CASCADE表示：如果文章被删除，其下所有评论也会被级联删除
|
|
|
article = models.ForeignKey(
|
|
|
Article,
|
|
|
verbose_name=_('article'),
|
|
|
on_delete=models.CASCADE)
|
|
|
|
|
|
# 父评论：自关联外键，用于实现评论回复功能
|
|
|
# 'self'表示关联到当前模型自身，blank=True和null=True允许为空（即顶级评论）
|
|
|
# 父评论被删除时，子评论也会被级联删除
|
|
|
parent_comment = models.ForeignKey(
|
|
|
'self',
|
|
|
verbose_name=_('parent comment'),
|
|
|
blank=True,
|
|
|
null=True,
|
|
|
on_delete=models.CASCADE)
|
|
|
|
|
|
# 是否启用：布尔字段，默认不启用（可能用于评论审核功能）
|
|
|
# blank=False和null=False表示该字段必填且不能为NULL
|
|
|
is_enable = models.BooleanField(_('enable'),
|
|
|
default=False, blank=False, null=False)
|
|
|
|
|
|
# 模型元数据配置（影响模型的整体行为和显示）
|
|
|
class Meta:
|
|
|
ordering = ['-id'] # 默认排序：按ID降序（最新评论在前）
|
|
|
verbose_name = _('comment') # 模型的单数显示名称（用于后台）
|
|
|
verbose_name_plural = verbose_name # 模型的复数显示名称（与单数相同）
|
|
|
get_latest_by = 'id' # 指定通过id字段获取最新记录
|
|
|
|
|
|
# 模型的字符串表示：在后台和打印对象时显示评论正文
|
|
|
def __str__(self):
|
|
|
return self.body |
