Update models.py

src/DjangoBlog-master/comments/models.py

@@ -1,39 +1,47 @@
-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 django.conf import settings  # 导入Django项目设置，用于获取用户模型
+from django.db import models  # 导入Django模型模块，用于定义数据模型
+from django.utils.timezone import now  # 导入当前时间工具，用于时间字段默认值
+from django.utils.translation import gettext_lazy as _  # 导入翻译函数，支持国际化
 
-from blog.models import Article
+from blog.models import Article  # 从blog应用导入Article模型，用于关联评论和文章
 
 
 # Create your models here.
 
 class Comment(models.Model):
+    # 评论内容字段，文本类型，最大长度300字符，显示名称为"正文"
     body = models.TextField('正文', max_length=300)
+    # 评论创建时间字段，使用国际化显示名称，默认值为当前时间
     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',
         verbose_name=_('parent comment'),
         blank=True,
         null=True,
         on_delete=models.CASCADE)
+    # 评论是否启用的开关，布尔类型，默认不启用，不允许为空
     is_enable = models.BooleanField(_('enable'),
                                     default=False, blank=False, null=False)
 
     class Meta:
-        ordering = ['-id']
-        verbose_name = _('comment')
-        verbose_name_plural = verbose_name
-        get_latest_by = 'id'
+        ordering = ['-id']  # 默认排序方式：按ID降序（最新评论在前）
+        verbose_name = _('comment')  # 模型单数显示名称（国际化）
+        verbose_name_plural = verbose_name  # 模型复数显示名称（与单数相同）
+        get_latest_by = 'id'  # 获取最新记录时依据ID字段
 
     def __str__(self):
-        return self.body
+        # 模型实例的字符串表示，返回评论内容
+        return self.body