资讯专栏INFORMATION COLUMN

Django搭建个人博客:编写博客文章的Model模型

winterdawn / 2490人阅读

摘要:在里写一个数据库驱动的应用的第一步是定义模型,也就是数据库结构设计和附加的其它元数据。模型元数据是任何不是字段的东西,例如排序选项数据库表名单数和复数名称和。

Django 框架主要关注的是模型(Model)、模板(Template)和视图(Views),称为MTV模式。

它们各自的职责如下:

层次 职责
模型(Model),即数据存取层 处理与数据相关的所有事务: 如何存取、如何验证有效性、包含哪些行为以及数据之间的关系等。
模板(Template),即业务逻辑层 处理与表现相关的决定: 如何在页面或其他类型文档中进行显示。
视图(View),即表现层 存取模型及调取恰当模板的相关逻辑。模型与模板的桥梁。

简单来说就是Model存取数据,View决定需要调取哪些数据,而Template则负责将调取出的数据以合理的方式展现出来。

在 Django 里写一个数据库驱动的 Web 应用的第一步是定义模型Model,也就是数据库结构设计和附加的其它元数据。

模型包含了储存的数据所必要的字段和行为。Django 的目标是你只需要定义数据模型,其它的杂七杂八代码你都不用关心,它们会自动从模型生成。

所以让我们首先搞定Model

编写Model.py

如前面所讲,Django中通常一个模型(Model)映射一个数据库,处理与数据相关的事务。

对博客网站来说,最重要的数据就是文章。所以首先来建立一个存放文章的数据模型。

打开article/models.py文件,输入如下代码:

article/models.py

from django.db import models
# 导入内建的User模型。
from django.contrib.auth.models import User
# timezone 用于处理时间相关事务。
from django.utils import timezone

# 博客文章数据模型
class ArticlePost(models.Model):
    # 文章作者。参数 on_delete 用于指定数据删除的方式,避免两个关联表的数据不一致。
    author = models.ForeignKey(User, on_delete=models.CASCADE)

    # 文章标题。models.CharField 为字符串字段,用于保存较短的字符串,比如标题
    title = models.CharField(max_length=100)

    # 文章正文。保存大量文本使用 TextField
    body = models.TextField()

    # 文章创建时间。参数 default=timezone.now 指定其在创建数据时将默认写入当前的时间
    created = models.DateTimeField(default=timezone.now)

    # 文章更新时间。参数 auto_now=True 指定每次数据更新时自动写入当前时间
    updated = models.DateTimeField(auto_now=True)

代码非常直白。每个模型被表示为 django.db.models.Model 类的子类。每个模型有一些类变量,它们都表示模型里的一个数据库字段。

每个字段都是 Field 类的实例 。比如字符字段被表示为 CharField ,日期时间字段被表示为 DateTimeField。这将告诉 Django 每个字段要处理的数据类型。

定义某些 Field 类实例需要参数。例如 CharField 需要一个 max_length参数。这个参数的用处不止于用来定义数据库结构,也用于验证数据。

使用 ForeignKey定义一个关系。这将告诉 Django,每个(或多个) ArticlePost 对象都关联到一个 User 对象。Django本身具有一个简单完整的账号系统(User),足以满足一般网站的账号申请、建立、权限、群组等基本功能。

ArticlePost类定义了一篇文章所必须具备的要素:作者、标题、正文、创建时间以及更新时间。我们还可以额外再定义一些内容,规范ArticlePost中数据的行为。加入以下代码:

article/models.py

...

class ArticlePost(models.Model):
    ...
    
    # 内部类 class Meta 用于给 model 定义元数据
    class Meta:
        # ordering 指定模型返回的数据的排列顺序
        # "-created" 表明数据应该以倒序排列
        ordering = ("-created",)

    # 函数 __str__ 定义当调用对象的 str() 方法时的返回值内容
    def __str__(self):
        # return self.title 将文章标题返回
        return self.title

内部类Meta中的ordering定义了数据的排列方式。-created表示将以创建时间的倒序排列,保证了最新的文章总是在网页的最上方。注意ordering是元组,括号中只含一个元素时不要忘记末尾的逗号。

__str__方法定义了需要表示数据时应该显示的名称。给模型增加 __str__方法是很重要的,它最常见的就是在Django管理后台中做为对象的显示值。因此应该总是返回一个友好易读的字符串。后面会看到它的好处。

整理并去掉注释,全部代码放在一起是这样:

article/models.py

from django.db import models
from django.contrib.auth.models import User
from django.utils import timezone

class ArticlePost(models.Model):
    author = models.ForeignKey(User, on_delete=models.CASCADE)
    title = models.CharField(max_length=100)
    body = models.TextField()
    created = models.DateTimeField(default=timezone.now)
    updated = models.DateTimeField(auto_now=True)
    
    class Meta:
        ordering = ("-created",)
        
    def __str__(self):
        return self.title

恭喜你,你已经完成了博客网站最核心的数据模型的大部分内容。

代码不到20行,是不是完全没啥感觉。后面会慢慢体会Django的强大。

另外建议新手不要复制粘贴代码。科学表明,缓慢的敲入字符有助于提高编程水平。

代码分解

这部分内容如果不能理解也没关系,先跳过,待水平提高再回过头来阅读。

导入(Import)

Django框架基于python语言,而在python中用import或者from...import来导入模块。

模块其实就一些函数和类的集合文件,它能实现一些相应的功能。当我们需要使用这些功能的时候,直接把相应的模块导入到我们的程序中就可以使用了。

import用于导入整个功能模块。但实际使用时往往只需要用模块中的某一个功能,为此导入整个模块有点大材小用,因此可以用from a import b表示从模块a中导入b给我用就可以了。

类(Class)

Python作为面向对象编程语言,最重要的概念就是类(Class)和实例(Instance)。

类是抽象的模板,而实例是根据这个类创建出来的一个个具体的“对象”。每个对象都拥有相同的方法,但各自的数据可能不同。而这些方法被打包封装在一起,就组成了类。

比如说我们刚写的这个ArticlePost类,作用就是就为博客文章的内容提供了一个模板。每当有一篇新文章生成的时候,都要比对ArticlePost类来创建authortitlebody...等等数据;虽然每篇文章的具体内容可能不一样,但是必须都遵循相同的规则。

在Django中,数据由模型来处理,而模型的载体就是类(Class)。

字段(Field)

字段(field)表示数据库表的一个抽象类,Django使用字段类创建数据库表,并将Python类型映射到数据库。

在模型中,字段被实例化为类属性并表示特定的表,同时具有将字段值映射到数据库的属性及方法。

比方说ArticlePost类中有一个title的属性,这个属性中保存着Charfield类型的数据:即一个较短的字符串。

ForeignKey外键

ForeignKey是用来解决“一对多”问题的,用于关联查询。

什么叫“一对多”?

在我们的ArticlePost模型中,一篇文章只能有一个作者,而一个作者可以有很多篇文章,这就是“一对多”关系

又比如一个班级的同学中,每个同学只能有一种性别,而每种性别可以对应很多的同学,这也是“一对多”。

因此,通过ForeignKey外键,将UserArticlePost关联到了一起,最终就是将博客文章的作者和网站的用户关联在一起了。

既然有“一对多”,当然也有“一对一”(OneToOneField )、“多对多”(ManyToManyField。目前用不到这些外键,后面再回头来对比其差别。

注意这里有个小坑,Django2.0 之前的版本on_delete参数可以不填;Django2.0以后on_delete是必填项,不写会报错。

内部类(Meta)

内部类class Meta用来使用类提供的模型元数据。模型元数据是“任何不是字段的东西”,例如排序选项ordering、数据库表名db_table、单数和复数名称verbose_nameverbose_name_plural。要不要写内部类是完全可选的,当然有了它可以帮助理解并规范类的行为。

class ArticlePost中我们使用的元数据ordering = ("-created",),表明了每当我需要取出文章列表,作为博客首页时,按照-created(即文章创建时间,负号标识倒序)来排列,保证了最新文章永远在最顶部位置。

数据迁移(Migrations)

编写好了Model后,接下来就需要进行数据迁移。

迁移是Django对模型所做的更改传递到数据库中的方式。因此每当对数据库进行了更改(添加、修改、删除等)操作,都需要进行数据迁移。

Django 的迁移代码是由你的模型文件自动生成的,它本质上只是个历史记录,Django 可以用它来进行数据库的滚动更新,通过这种方式使其能够和当前的模型匹配。

在虚拟环境中进入my_blog文件夹(还没熟悉venv的再温习: 在Windows中搭建Django的开发环境),输入python manage.py makemigrations对模型的更改创建新的迁移表

(env) e:django_projectmy_blog>python manage.py makemigrations
Migrations for "article":
  articlemigrations001_initial.py
    - Create model ArticlePost

(env) e:django_projectmy_blog>

通过运行 makemigrations 命令,Django 会检测你对模型文件的修改,并且把修改的部分储存为一次迁移。

然后输入python manage.py migrate应用迁移到数据库中

(env) e:django_projectmy_blog>python manage.py migrate
Operations to perform:
  Apply all migrations: admin, article, auth, contenttypes, sessions
Running migrations:
  Applying contenttypes.0001_initial... OK
  ...
  Applying sessions.0001_initial... OK

(env) e:django_projectmy_blog>

migrate 命令选中所有还没有执行过的迁移并应用在数据库上,也就是将模型的更改同步到数据库结构上。迁移是非常强大的功能,它能让你在开发过程中持续的改变数据库结构而不需要重新删除和创建表。它专注于使数据库平滑升级而不会丢失数据。

有点拗口,如果没懂也没关系,总之在迁移之后,对Model的编写就算完成了。

总结

本章初步了解了Django的MTV模式,编写了博客文章的Model模型ArticlePost,并将其迁移到了数据库中。

下一步就向View进军,学习如何调取模型中的数据。

有疑问请在杜赛的个人网站留言,我会尽快回复。

或Email私信我:dusaiphoto@foxmail.com

项目完整代码:Django_blog_tutorial

转载请告知作者并注明出处。

文章版权归作者所有,未经允许请勿转载,若此文章存在违规行为,您可以联系管理员删除。

转载请注明本文地址:https://www.ucloud.cn/yun/42462.html

相关文章

  • Django搭建个人博客:在博文中发表评论

    摘要:确认创建成功后,记得在中注册因为我们想显示发表评论的时间,修改时区设置为上海的时区。处理错误请求发表评论仅接受请求。返回到一个适当的中即用户发送评论后,重新定向到文章详情页面。总结本章实现了发表评论展示评论的功能。 在没有互联网的年代,我们用日记来记录每天的心得体会。小的时候我有一个带锁的日记本,生怕被别人看见里面写了啥,钥匙藏得那叫一个绝。 现在时代变了,网络版的日记本:博客,却巴不...

    Jinkey 评论0 收藏0
  • Django搭建个人博客:改写View视图

    摘要:改写视图函数上一章我们感受了视图的工作流程。循坏表示依次取出中的元素,命名为,并分别执行接下来操作。即为语言,中间包裹了一个段落的文字。有疑问请在杜赛的个人网站留言,我会尽快回复。 改写视图函数 上一章我们感受了视图的工作流程。 为了让视图真正发挥作用,改写article/views.py中的article_list视图函数: article/views.py from django...

    KaltZK 评论0 收藏0
  • Django搭建个人博客:扩展用户信息

    摘要:博客网站的用户信息并不复杂,因此扩展就足够了。可以在这个基础上,扩展为一个美观详细的用户信息页面。当然最好再给个人信息添加一个入口。没有对用户的登录状态进行检查。总结本章使用一对一链接的方式,扩展并更新了用户信息。 可能你已经发现了,Django自带的User模型非常实用,以至于我们没有写用户管理相关的任何模型。 但是自带的User毕竟可用的字段较少。比方说非常重要的电话号码、头像等都...

    Eastboat 评论0 收藏0
  • Django搭建个人博客:使用Form表单类发表新文章

    摘要:一些表单界面元素文本框或复选框非常简单并内置在中,而其他会复杂些像弹出日期选择等操作控件。和标签中的属性指定了当前文本框提交的数据的名称,它必须与表单类中的字段名称对应,否则服务器无法将字段和数据正确的对应起来。 前面我们已经学会如何用Markdown语法书写文章了。 但是还有问题呀。之前写文章都是在后台中进行的,万一有别的普通用户也要发表文章怎么办?万一我想拓展些后台中没有的提交验证...

    Java3y 评论0 收藏0
  • Django搭建个人博客:设置文章栏目

    摘要:而文章分类一个重要的途径就是设置栏目。修改文件栏目的栏目标题创建时间文章栏目的一对多外键栏目的有两个字段,名称和创建日期。修改文章的栏目功能,也就完成了。对个人博客来说,栏目数据的变动通常是很少的。 博客的文章类型通常不止一种:有时候你会写高深莫测的技术文章,有时候又纯粹只记录一下当天的心情。 因此对文章的分类就显得相当的重要了,既方便博主对文章进行分类归档,也方便用户有针对性的阅读。...

    keelii 评论0 收藏0

发表评论

0条评论

最新活动
阅读需要支付1元查看
<