Django是一个Web框架——一套用于帮助开发交互式网站的工 具。Django能够响应网页请求,还能让你更轻松地读写数据库、管理用户等。在第19章和第 20章,我们将改进“学习笔记”项目,再将其部署到活动的服务器,让你和你的朋友能够使用它
1、建立规范
新建目录并使用
python3 -m venv ll_env
2、激活虚拟环境
linux:
source ll_env/bin/activate
windows:
ll_env\Scripts\activate
要停止使用虚拟环境,可执行命令deactivate
3、安装Django
创建并激活虚拟环境后,就可安装Django了 Django仅在虚拟环境处于活动状态时才可用
pip install Django
4、在Django中创建项目
django-admin startproject learning_log .
ls
#learning_log ll_env manage.py
ls learning_log
#__init__.py settings.py urls.py wsgi.py
千万别忘了这个句点,否则部署应用程序时将遭遇一些配置问题
目录learning_log包含4个文件,其中最重要的是settings.py、urls.py和wsgi.py。文件settings.py指定Django如何与你的系统交互以及如何管理项目。在开发项目的过程中,我们将修改其中一些设置,并添加一些设置。文件urls.py告诉Django应创建哪些网页来响应浏览器请求。文件wsgi.py帮助Django提供它创建的文件,这个文件名是web server gateway interface(Web服务器网关接口)的首字母缩写
5、创建数据库
Django将大部分与项目相关的信息都存储在数据库中,因此我们需要创建一个供Django使用的数据库。为给项目“学习笔记”创建数据库,请在处于活动虚拟环境中的情况下执行下面的命令
python manage.py migrate
我们将修改数据库称为迁移数据库。首次执行命令migrate时,将让Django确保数据库与项目的当前状态匹配。在使用SQLite(后面将更详细地介绍)的新项目中首次执行这个命令时,Django将新建一个数据库。在处,Django指出它将创建必要的数据库表,用于存储我们将在这个项目(Synchronize unmigrated apps,同步未迁移的应用程序)中使用的信息,再确保数据库结构与当前代码(Apply all migrations,应用所有的迁移)匹配
Django又创建了一个文件——db.sqlite3。SQLite是一种使用单个文件的数据库,是编写简单应用程序的理想选择,因为它让你不用太关注数据库管理的问题
6、查看项目
下面来核实Django是否正确地创建了项目。为此,可执行命令runserver
python manage.py runserver
通过http://127.0.0.1:8000/即可访问测试
若端口被占用 使用
python manage.py runserver 8001
创建应用程序
当前,在前面打开的终端窗口中应该还运行着runserver。请再打开一个终端窗口(或标签页),并切换到manage.py所在的目录。激活该虚拟环境,再执行命令startapp:
source ll_env/bin/activate
python manage.py startapp learning_logs
ls learning_logs/
#admin.py __init__.py migrations models.py tests.py views.py
命令startappappname让Django建立创建应用程序所需的基础设施。如果现在查看项目目录,将看到其中新增了一个文件夹learning_logs。打开这个文件夹,看看Django都创建了什么 。其中最重要的文件是models.py、admin.py和views.py。我们将使用models.py来定义我们要在应用程序中管理的数据。admin.py和views.py将在稍后介绍
定义模型
我们来想想涉及的数据。每位用户都需要在学习笔记中创建很多主题。用户输入的每个条目都与特定主题相关联,这些条目将以文本的方式显示。我们还需要存储每个条目的时间戳,以便能够告诉用户各个条目都是什么时候创建的。打开文件models.py,看看它当前包含哪些内容
from django.db import models
# Create your models here.
这为我们导入了模块models,还让我们创建自己的模型。模型告诉Django如何处理应用程序中存储的数据。在代码层面,模型就是一个类,就像前面讨论的每个类一样,包含属性和方法。下面是表示用户将要存储的主题的模型:
from django.db import models
# Create your models here.
class Topic(models.Model):
"""用户学习的主题"""
text = models.CharField(max_length=200)
date_added = models.DateTimeField(auto_now_add=True)
def __str__(self):
"""返回模型的字符串表示"""
return self.text
我们创建了一个名为Topic的类,它继承了Model——Django中一个定义了模型基本功能的类。Topic类只有两个属性:text和date_added。属性text是一个CharField——由字符或文本组成的数据。需要存储少量的文本,如名称、标题或城市时,可使用CharField。定义CharField属性时,必须告诉Django该在数据库中预留多少空间。在这里,我们将max_length设置成了200(即200个字符),这对存储大多数主题名来说足够了。属性date_added是一个DateTimeField——记录日期和时间的数据。我们传递了实参auto_add_now=True,每当用户创建新主题时,这都让Django将这个属性自动设置成当前日期和时间
我们需要告诉Django,默认应使用哪个属性来显示有关主题的信息。Django调用方法str()来显示模型的简单表示。在这里,我们编写了方法str(),它返回存储在属性text中的字符串
激活模型
要使用模型,必须让Django将应用程序包含到项目中。为此,打开settings.py(它位于目录learning_log/learning_log中),你将看到一个这样的片段,即告诉Django哪些应用程序安装在项目中:
修改为:
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
# 我的应用程序
'learning_logs',
]
通过将应用程序编组,在项目不断增大,包含更多的应用程序时,有助于对应用程序进行跟踪。这里新建了一个名为My apps的片段,当前它只包含应用程序learning_logs。接下来,需要让Django修改数据库,使其能够存储与模型Topic相关的信息。为此,在终端窗口中执行下面的命令
python manage.py makemigrations learning_logs
#
Migrations for 'learning_logs':
learning_logs\migrations\0001_initial.py
- Create model Topic
命令makemigrations让Django确定该如何修改数据库,使其能够存储与我们定义的新模型相关联的数据。输出表明Django创建了一个名为0001_initial.py的迁移文件,这个文件将在数据库中为模型Topic创建一个表。下面来应用这种迁移,让Django替我们修改数据库
python manage.py migrate
这个命令的大部分输出都与我们首次执行命令migrate的输出相同。我们需要检查的是处的输出行,在这里,Django确认为learning_logs应用迁移时一切正常(OK)。每当需要修改“学习笔记”管理的数据时,都采取如下三个步骤:修改models.py;对learning_logs调用makemigrations;让Django迁移项目
Django管理网站
为应用程序定义模型时,Django提供的管理网站(admin site)让你能够轻松地处理模型。网站的管理员可使用管理网站,但普通用户不能使用。在本节中,我们将建立管理网站,并通过它使用模型Topic来添加一些主题。
创建超级用户
python manage.py createsuperuser
向管理网站注册模型
Django自动在管理网站中添加了一些模型,如User和Group,但对于我们创建的模型,必须手工进行注册。我们创建应用程序learning_logs时,Django在models.py所在的目录中创建了一个名为admin.py的文件
from django.contrib import admin
# Register your models here.
from learning_logs.models import Topic
admin.site.register(Topic)
这些代码导入我们要注册的模型Topic,再使用admin.site.register()让Django通过管理网站管理我们的模型。现在,使用超级用户账户访问管理网站:访问http://localhost:8000/admin/,并输入你刚创建的超级用户的用户名和密码,你将看到类似于图18-2所示的屏幕。这个网页让你能够添加和修改用户和用户组,还可以管理与刚才定义的模型Topic相关的数据