Django-tutorial 1

Django 是一个使用python作为后端语言的框架。学习 Django 源于我想要让我的 jandan 脚本可以提供在线服务…… 没想到这个东东这么复杂，亏了呀！

安装Django

https://docs.djangoproject.com/zh-hans/4.1/intro/install/ 如果在系统范围安装，安装前需要先装好python3.x。官方教程还建议使用venv虚拟环境的方式，不过我一直弄不太懂venv，就不尝试了。

1python -m pip install Django

检查是否安装成功：

1python -m django --version

新建项目

创建

1django-admin startproject mysite

项目会创建一个如下图的目录，关于这些文件都是干啥的可以参考这个链接： https://docs.djangoproject.com/zh-hans/4.1/intro/tutorial01/

实际上一般只有 urls、settings 两个文件大概会用到

启动

启动项目，我们只要运行刚才生成的manage.py

1python manage.py runserver

http://127.0.0.1:8000/ 打开看看吧！

可以通过下面的命令来自定义端口

1python manage.py runserver 8080

刚才我们创建了一堆 python 文件，可以在运行时热重载，但如果添加了新文件，就要重新启动 manage.py 了。

新建APP

创建投票应用

进入 manage.py 目录

刚才创建的是 django 的基础架构，我们现在添加一个 polls app （投票应用），自己添加 app 的时候可以随便命名。

1python manage.py startapp polls

创建视图

要在 polls 应用下面创建一个视图，http://127.0.0.1:8000/polls/index

需要修改两个文件：views.py & urls.py

在views.py

1from django.http import HttpResponse
2
3def index(request):
4    return HttpResponse("Hello, world. You're at the polls index.")

polls/urls.py还不存在，新建一个urls.py如下：

1from django.urls import path
2from . import views
3
4urlpatterns = [
5	path('', views.index, name='index'),
6]

还要去mysite/urls.py ，指向一下这个新建的 polls/urls.py 。

(可以理解为这个是管根目录的，我们刚才那个是管/polls目录的)

1from django.contrib import admin
2from django.urls import include, path
3
4urlpatterns = [
5	path('admin/', admin.site.urls),
6	path('polls/', include('polls.urls')),
7]

然后访问： http://127.0.0.1:8000/polls/ 就可以了。

逻辑上，django 先请求 mysite/urls.py ，指向了 polls/urls.py 再指向 views.py 文件返回 respond 。

path函数

函数 path() 具有四个参数，

两个必须参数：route 和 view , 路径 / 对应的 py 函数
两个可选参数：kwargs 和 name。传参用 / 全局引用、模板使用。

这部分我觉得官网讲的非常清晰简洁（再页面最下方）： https://docs.djangoproject.com/zh-hans/4.1/intro/tutorial01/

设置-时区

时区在后面数据库中非常有用(比如数据插入时间)，推荐先设置成正确的时区。

在 settings.py 中修改这个

1TIME_ZONE = 'UTC' #美国时间（默认）
2TIME_ZONE = 'Asia/Shanghai' #中国时间

设置参考（这个网站包含所有的 settings.py 的项） https://docs.djangoproject.com/zh-hans/4.1/ref/settings/#std-setting-TIME_ZONE

设置-数据库

生成数据表

这个语句自动创建 INSTALLED_APPS 中的表。

1python manage.py migrate

基础知识

数据库的配置在 mysite/settings.py 中，如下所示，可以使用各种数据库：

1'django.db.backends.sqlite3'
2'django.db.backends.postgresql'
3'django.db.backends.mysql'
4'django.db.backends.oracle'

默认使用sqlite，其他的可以看文档： https://docs.djangoproject.com/zh-hans/4.1/ref/settings/#std-setting-DATABASES

下面是默认配置：

1DATABASES = {
2	'default': {
3		'ENGINE': 'django.db.backends.sqlite3', #换数据库修改这里
4		'NAME': BASE_DIR / 'db.sqlite3',
5	}
6}

django 提供一些自带的 APP，可以在 settings.py 里面看到，迁移时会自动根据已经安装的APP来创建数据表。：

1INSTALLED_APPS = [
2    'django.contrib.admin',
3    'django.contrib.auth',
4    'django.contrib.contenttypes',
5    'django.contrib.sessions',
6    'django.contrib.messages',
7    'django.contrib.staticfiles',
8]

创建模型

上面 INSTALLED_APPS 能生成的数据表，不包括我们新创建的 polls APP ，这里开始逐步把它加入

需要创建两个模型：问题 Question 和选项 Choice。

Question 问题
Choice 选项和当前得票数，连接到Question

修改 polls/models.py，内容如下：

 1from django.db import models
 2
 3class Question(models.Model):
 4    question_text = models.CharField(max_length=200) #问题内容
 5    pub_date = models.DateTimeField('date published') #问题发布时间
 6
 7class Choice(models.Model):
 8    question = models.ForeignKey(Question, on_delete=models.CASCADE) #外链到问题
 9    choice_text = models.CharField(max_length=200) #选项内容
10    votes = models.IntegerField(default=0) #选项票数

主键(IDs)会被自动创建
表名首字母大写
字段小写英文，下划线相连

通过这个polls/models.py，django 可以得到创建数据库的信息。

我们需要把自己的app也加入mysite/settings.py 的INSTALLED_APPS列表中：

1INSTALLED_APPS = [
2    'django.contrib.admin',
3    'django.contrib.auth',
4    'django.contrib.contenttypes',
5    'django.contrib.sessions',
6    'django.contrib.messages',
7    'django.contrib.staticfiles',
8    'polls.apps.PollsConfig', #这一行
9]

激活模型

这个步骤是下面的创建表的前置步骤

运行 makemigrations 命令，Django 会检测你对模型文件的修改，在 polls/migrations 生成数据库表的 schema ，Django 通过schema 来创建数据表。我们刚才创建了 polls/models.py ，用这个语句“激活”它。

1python manage.py makemigrations polls

（迁移用）生成建表语句，会根据你在 mysite/settings.py中选择的数据库种类，输出对应的建表语句：

1python manage.py sqlmigrate polls 0001

再次生成数据表

1python manage.py migrate

模型的 `str` 函数

给模型增加__str__函数，在后面使用 python shell 添加数据时，可以更轻松的看懂、更易读。

给polls/models.py新增两个def __str__(self):

 1from django.db import models
 2
 3class Question (models.Model):
 4    question_text = models.CharField(max_length=200)
 5    pub_date = models.DateTimeField('date published')
 6    def __str__(self):
 7        return self.question_text
 8
 9class Choice(models.Model):
10    question = models.ForeignKey(Question,on_delete=models.CASCADE)
11    choice_text = models.CharField(max_length=200)
12    votes = models.IntegerField(default=0)
13    def __str__(self):
14        return self.choice_text

再添加一个was_published_recently(self)函数，可以给Question增加一个“最近发布”的功能：

1from django.utils import timezone
2
3class Question(models.Model):
4	...
5    def was_published_recently(self):
6        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)

去 py shell里面看一下，刚刚写的函数有没有效果

1python manage.py shell

1from polls.models import Choice, Question
2Question.objects.all()
3#<QuerySet [<Question: What's up?>]>
4
5q = Question.objects.get(pk=1)
6q.was_published_recently()
7## True

尝试数据库API

下面的语句都是在py shell中执行的

1python manage.py shell

manage.py 会设置 DJANGO_SETTINGS_MODULE 环境变量，这个变量会让 Django 根据 mysite/settings.py 文件来设置 Python 包的导入路径,(我发现这个python shell 有补全功能)

增加条目

通过python 语句增加条目，首先要引入我们刚才写的models

1from polls.models import Choice, Question

新建一个 question，并保存到数据库中

1from django.utils import timezone #需要用到时区获取时间
2q = Question(question_text="What's new?",pub_date=timezone.now()) 
3q.save() #把新建的q实例存储到数据库中

查看当前 Question 表所有的内容，看看是否添加成功

1Question.objects.all()

增加条目关联条目

给 question 增加 choice ，一般来说可以先给 choice 表增加一行，再绑定 question ，但是 django 推荐你使用下面这种方式。

通过 q.choice_set.create 创建 choice。

通过问题 id=1 获取 question

1q = Question.objects.get(pk=1)

查看目前关联的所有 choice

1q.choice_set.all()

增加一些choice

1q.choice_set.create(choice_text='choice 1', votes=0)
2q.choice_set.create(choice_text='choice 2', votes=0)

可以给新增加的 choice 赋值给对象 c

1c = q.choice_set.create(choice_text='Just hacking again', votes=0)

通过 c 可以反向找到 question

1c.question 
2#<Question: What's up?>

查看所有的 choice 、查看 choice 个数的内置函数

1q.choice_set.all() 
2#<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>
3q.choice_set.count() 
4#3

删除条目

删除内容为 “Just hacking” 开头的 choice 。

1c = q.choice_set.filter(choice_text__startswith='Just hacking')
2c.delete()

查看字段内容

先选取一个问题（id = 1）

1q = Question.objects.get(pk=1)

使用 python 访问他的字段内容

1q.id
2q.question_text
3q.pub_date

修改字段内容

1q.question_text = "What's up?"
2q.save()

Admin 管理页面

django 可以给数据库自动生成管理页面（太棒啦！）

创建一个用户，用于登陆管理页面

1python manage.py createsuperuser

启动

1python manage.py runserver

但是里面没有我们创建的polls 应用！需要修改 polls/admin.py

1from django.contrib import admin
2from .models import Question,Choice
3admin.site.register(Question)
4admin.site.register(Choice)

view 视图

在上面“新建APP”章节已经讲过了创建视图，但是仅能返回简单的字符串。

`views.py`

在polls/views.py增加三个function，代表三个页面，投票详情、投票结果、投票动作。

1def detail(request, question_id):
2    return HttpResponse(f"You're looking at question {question_id}." )
3
4def results(request, question_id):
5    return HttpResponse(f"You're looking at the results of question {question_id}.")
6
7def vote(request, question_id):
8    return HttpResponse(f"You're voting on question {question_id}." )

函数写法：

在 urls.py 中会引用其函数名。
至少包括 request 参数，
必须返回 HttpResponse对象
可以加上自定义参数,比如这里的question_id作为输入。

`urls.py`

修改文件： polls/urls.py

增加三个路由，/id投票详情、/id/results投票结果、/id/vote投票动作。

 1from django.urls import path
 2
 3from . import views
 4
 5urlpatterns = [
 6    #ex: /polls/
 7    path('', views.index, name='index'),
 8    #ex: /polls/5/
 9    path('<int:question_id>/', views.detail, name='detail'),
10    #ex: /polls/5/results/
11    path('<int:question_id>/results/', views.results, name='results'),
12    #ex: /polls/5/vote/
13    path('<int:question_id>/vote/', views.vote, name='vote'),
14]

参数:

url 路径
绑定的函数名称
用于联动模板的 name （可以省略）如果是有参数的 url 路径，末尾的斜杠不能删

HTML 模板

我们要把 index 修改一下，让他显示最新的五个问题，并且能跳转到问题细节。

在polls 下创建一个 templates/polls 文件夹，在里面新建一个 index.html

1{% if latest_question_list %}
2    <ul>
3    {% for question in latest_question_list %}
4        <li><a href="/polls/{{ question.id }}/">{{ question.question_text }}</a></li>
5    {% endfor %}
6    </ul>
7{% else %}
8    <p>No polls are available.</p>
9{% endif %}

这里为了代码简短，展示核心代码功能，未为添加完整的 html 结构和 css ，这些都是很好修改和添加的。

然后更新一下 views.py ，让他使用这个模板

1from .models import Question
2
3def index(request):
4    latest_question_list = Question.objects.order_by('-pub_date')[:5]
5    template = loader.get_template('polls/index.html')
6    context = {
7        'latest_question_list': latest_question_list,
8    }
9    return HttpResponse(template.render(context, request))

用 数据库api 来获取 list ，选取最新的
用 context 将 latest_question_list 传递给 HTML 模板
用 render 方法生成 HttpResponse

Django-Tutorial 1

目录

安装Django

新建项目

创建

启动

新建APP

创建投票应用

创建视图

path函数

设置-时区

设置-数据库

生成数据表

基础知识

创建模型

激活模型

模型的 `str` 函数

尝试数据库API

增加条目

增加条目关联条目

删除条目

查看字段内容

修改字段内容

更多的查询API

Admin 管理页面

view 视图

`views.py`

`urls.py`

HTML 模板

Django-Tutorial 1

目录

安装Django

新建项目

创建

启动

新建APP

创建投票应用

创建视图

path函数

设置-时区

设置-数据库

生成数据表

基础知识

创建模型

激活模型

模型 的 __str__ 函数

尝试数据库API

增加条目

增加条目关联条目

删除条目

查看字段内容

修改字段内容

更多的查询API

Admin 管理页面

view 视图

views.py

urls.py

HTML 模板

相关文章

模型的 `str` 函数

`views.py`

`urls.py`