小酌Django2——博客文章发布

Blog应用：博客文章发布

编写数据模型类

设计数据库和表结构是做网站的基础；在Django中，不需要通过SQL直接跟数据交互，而是完全用Python的方式创建数据模型，之后交给Django完成数据库操作；

利用Django开发网站，一般需要先编写数据模型：就是在./blog/models.py中写一个类BlogArticles；
该类与数据库中的数据表具有对应关系；

BlogArticles类：

本质继承自django.db.models.Model；
类型定义的属性对应着数据库表的一个字段；

from django.db import models
from django.utils import timezone
from django.contrib.auth.models import Userclass BlogArticles(models.Model):title = models.CharField(max_length=300) #author = models.ForeignKey(User, related_name="blog_posts") # 外键来自User，表示用户、文章 一对多的关系；related_name="blog_posts"作用是允许通过User类反向查找到BlogArticles；body = models.TextField()publish = models.DateTimeField(default=timezone.now)class Meta: # 与元类不同ordering = ("-publish",) # 规定BlogArticles实例对象按publish字段值倒序显示；def __str__(self):return self.title

根据数据模型类建立数据库

先根据数据模型类创建模型；
在基于模型建立数据库；

创建模型

请先确认已经在mysite1目录下的settings.py中注册blog应用；
在根目录下，执行python manage.py makemigrations（记得先执行下ls）；创建存储应用的数据库表结构的指令的文件；

这里报了一个错误：

TypeError: __init__() missing 1 required positional argument: 'on_delete'

原因：

django 升级到2.0之后,表与表之间关联的时候,必须要写on_delete参数；

 on_delete=None,               # 删除关联表中的数据时,当前表与其关联的field的行为on_delete=models.CASCADE,     # 删除关联数据,与之关联也删除on_delete=models.DO_NOTHING,  # 删除关联数据,什么也不做on_delete=models.PROTECT,     # 删除关联数据,引发错误ProtectedError# models.ForeignKey('关联表', on_delete=models.SET_NULL, blank=True, null=True)on_delete=models.SET_NULL,    # 删除关联数据,与之关联的值设置为null（前提FK字段需要设置为可空,一对一同理）# models.ForeignKey('关联表', on_delete=models.SET_DEFAULT, default='默认值')on_delete=models.SET_DEFAULT, # 删除关联数据,与之关联的值设置为默认值（前提FK字段需要设置默认值,一对一同理）on_delete=models.SET,         # 删除关联数据,a. 与之关联的值设置为指定值,设置：models.SET(值)b. 与之关联的值设置为可执行对象的返回值,设置：models.SET(可执行对象)

这里我们使用关联删除：on_delete=models.CASCADE；

修改代码如下：

author = models.ForeignKey(User, related_name="blog_posts", on_delete=models.CASCADE
)

重新执行上述命令：

$ ls
blog            db.sqlite3      manage.py       mysite1
$ python manage.py makemigrations
Migrations for 'blog':blog/migrations/0001_initial.py- Create model BlogArticles

现在，在blog/migrations 目录下我们通过执行makemigrations命令自动创建了一个BlogArticles 模型：0001_initial.py

# Generated by Django 3.0.8 on 2020-07-07 11:06from django.conf import settings
from django.db import migrations, models
import django.db.models.deletion
import django.utils.timezoneclass Migration(migrations.Migration):initial = Truedependencies = [migrations.swappable_dependency(settings.AUTH_USER_MODEL),]operations = [migrations.CreateModel(name='BlogArticles',fields=[('id', models.AutoField(auto_created=True, primary_key=True, serialize=False, verbose_name='ID')),('title', models.CharField(max_length=300)),('body', models.TextField()),('publish', models.DateTimeField(default=django.utils.timezone.now)),('author', models.ForeignKey(on_delete=django.db.models.deletion.CASCADE, related_name='blog_posts', to=settings.AUTH_USER_MODEL)),],options={'ordering': ('-publish',),},),]

这段代码的含义可以使用命令python manage.py sqlmigrate blog 0001查看：

sql语句显示：上述代码创建了一个名为blog_blogarticles的数据库表，blog是应用名，blogarticles是模型类名称全小写；
这实际就是一个能够建立数据库表的文件，基于此就可以进行后续数据库的创建；

$ python manage.py sqlmigrate blog 0001
BEGIN;
--
-- Create model BlogArticles
--
CREATE TABLE "blog_blogarticles" ("id" integer NOT NULL PRIMARY KEY AUTOINCREMENT, "title" varchar(300) NOT NULL, "body" text NOT NULL, "publish" datetime NOT NULL, "author_id" integer NOT NULL REFERENCES "auth_user" ("id") DEFERRABLE INITIALLY DEFERRED);
CREATE INDEX "blog_blogarticles_author_id_ed798e23" ON "blog_blogarticles" ("author_id");
COMMIT;

创建数据库

执行命令python manage.py migrate创建数据库；

$ python manage.py migrate
Operations to perform:Apply all migrations: admin, auth, blog, contenttypes, sessions
Running migrations:Applying blog.0001_initial... OK

现在，使用Navicat Premium打开根目录下的数据库文件，查看相应的数据库表结构，就可以看见已经创建好的表blog_blogarticles：

发布博客文章

最简单的发布——使用Django默认的管理功能发布文章；要使用此方法需要先创建超级管理员（创建后牢记用户名和密码）；

创建超级管理员

使用命令python manage.py createsuperuser；

$ python manage.py createsuperuser
Username (leave blank to use 'huaqiang'): baby_hua
Email address: xxx_xxxxx_xxx@163.com
Password: h1-8
Password (again):
Superuser created successfully.

运行项目，使用命令python manage.py runserver；
访问http://127.0.0.1:8000/admin/
使用超级管理员登录；

这里：

Groups和Users是Django在用户管理应用中默认的；单击Users就能看见目前唯一的用户baby_hua；
可以尝试进行用户的操作；

编辑blog/admin.py 注册Blog

还记得blog/admin.py文件的作用吗：

可在此文件中，自定义Django管理工具，如设置在管理界面能够管理的项目，或通过重新自定义与系统管理有关的类对象，向管理功能增加新的内容；

编辑blog/admin.py：

from django.contrib import admin# Register your models here.from .models import BlogArticles  # 引入BlogArticles类admin.site.register(BlogArticles)  # 在admin中注册该类

保存后查看项目：(未添加新文件，无需重启)

我们看到了一个新注册的BLOG：

尝试多添加几个博客文章；可以看到新建博客文章编辑的信息与BlogArticles类中属性是一致的；
再查看数据库，可以看到刚刚新建文章的多条记录；BlogArticles类中ForeignKey()属性也起了作用，author_id被赋了相应的值(auth_user表的主键id)；

提供时区数值：blog/models.py中使用的django.utils.timezone，依赖模块pytz

安装pytz模块，执行命令pip install pytz；重启项目；
注意上图中的时间未对应上，因为mysite1/settings.py中时区默认设置的是UTC，需要修改为东八区：TIME_ZONE = “Asia/Shanghai”；在看下显示时间就正确了；

丰富Blog列表的展示

查看已经创建的文章列表：列项的显示还可以更丰富一些，只需编辑blog/admin.py

from django.contrib import admin# Register your models here.from .models import BlogArticles  # 引入BlogArticles类class BlogArticlesAdmin(admin.ModelAdmin):list_display = ("title", "author", "publish")list_filter = ("publish", "author")search_fields = ("title", "body")raw_id_fields = ("author",)date_hierarchy = "publish"ordering = ["publish", "author"]admin.site.register(BlogArticles, BlogArticlesAdmin)  # 在admin中注册该类

修改前：

修改保存后，刷新界面：