push

src/DjangoBlog-master(1)/DjangoBlog-master/comments/models.py

@@ -9,31 +9,63 @@ from blog.models import Article
 # Create your models here.
 
 class Comment(models.Model):
+    """
+    评论模型类
+    用于存储博客文章的评论信息，支持多级回复功能
+    """
+
+    # 评论正文，最大长度300字符，在管理界面显示为'正文'
     body = models.TextField('正文', max_length=300)
+
+    # 评论创建时间，默认值为当前时间，使用Django的国际化支持
     creation_time = models.DateTimeField(_('creation time'), default=now)
+
+    # 评论最后修改时间，默认值为当前时间
     last_modify_time = models.DateTimeField(_('last modify time'), default=now)
+
+    # 评论作者，关联用户模型，删除用户时级联删除其所有评论
     author = models.ForeignKey(
         settings.AUTH_USER_MODEL,
         verbose_name=_('author'),
         on_delete=models.CASCADE)
+
+    # 所属文章，关联文章模型，删除文章时级联删除所有相关评论
     article = models.ForeignKey(
         Article,
         verbose_name=_('article'),
         on_delete=models.CASCADE)
+
+    # 父级评论，支持评论回复功能，允许为空表示顶级评论
     parent_comment = models.ForeignKey(
-        'self',
+        'self',  # 自关联，指向同一个模型
         verbose_name=_('parent comment'),
-        blank=True,
-        null=True,
-        on_delete=models.CASCADE)
+        blank=True,  # 在表单中允许为空
+        null=True,  # 在数据库中允许为NULL
+        on_delete=models.CASCADE)  # 删除父评论时级联删除子评论
+
+    # 评论是否启用（审核通过），默认未启用，不允许为空
     is_enable = models.BooleanField(_('enable'),
                                     default=False, blank=False, null=False)
 
     class Meta:
+        """
+        模型的元数据配置
+        """
+        # 按ID降序排列，新的评论显示在前面
         ordering = ['-id']
+
+        # 单数名称，在管理界面显示
         verbose_name = _('comment')
+
+        # 复数名称，与单数相同
         verbose_name_plural = verbose_name
+
+        # 指定获取最新记录时使用的字段
         get_latest_by = 'id'
 
     def __str__(self):
-        return self.body
+        """
+        对象的字符串表示方法
+        在Django管理界面和其他显示对象的地方使用
+        """
+        return self.body  # 直接返回评论正文作为显示内容