1. 创建django项目

可通过如下命令创建名为myproject的django项目,

1
2
3
django-admin startproject myproject
cd myproject
python manage.py migrate

备注

  1. python manage.py migrate意思是把数据模型(Python中定义的Model)和数据库同步。
  2. python manage.py makemigrations是当模型的相关代码发生变动时,对变动进行提交保存,后接migrate

2. 创建app

1
python manage.py startapp base # 这里base就是app的名字

创建完成后要注册app,在setting.py中找到INSTALLED_APPS,加入app名

1
2
3
4
INSTALLED_APPS = [
'base',
...
]

一个django项目的结构如下
django项目结构.png

3. 创建数据模型(Model)

models.py中,建立数据模型,类似于pojo,即一个对象包含哪些字段,这也被称为Schema

1
2
3
4
5
6
from django.db import models

# Create your models here.
class Item(models.Model):
name = models.CharField(max_length=200)
created = models.DateTimeField(auto_now_add=True)

如上所述,数据模型变动后,要进行迁移

1
2
python manage.py makemigrations
python manage.py migrate

makemigrations后,即建立了数据模型和数据库的联系,可以通过python manage.py sqlmigrate base 0001生成sql语句,但这只是供查看确认,并不执行,migrate才是执行。

临时加入数据

可以另外开一个shell进行一些操作,比如添加数据

1
python manage.py shell

这条命令相比直接运行python,可以导入该django项目的环境变量。

在shell中添加数据

1
2
3
4
5
6
7
8
9
10
11
12
13
>>> from base.models import Item
>>> Item.objects.create(name='item1')
<Item: Item object (1)>
>>> Item.objects.create(name='item2')
<Item: Item object (2)>
>>> Item.objects.create(name='item3')
<Item: Item object (3)>
>>> items = Item.objects.all()
>>> print(items)
<QuerySet [<Item: Item object (1)>, <Item: Item object (2)>, <Item: Item object (3)>]>
# 也可以这样
>>> item = Item(name='item4')
>>> item.save()

4. 创建后端逻辑(View)

views.py文件中完成

比如最简单的,

1
2
def home(request):
return HttpResponse("home page")

这样后续执行该逻辑时,网页上就显示了home page这行字。

当然,更一般的,后端会提供一些数据处理,并显示在定义好的前端模板上,这样就要和前端模板绑定。比如现在要把所有的物品显示在前端页面上,那么后端就要从数据库拉取所有的items,

1
2
3
def get_items(request):
items = Item.objects.all()
return render(request, 'items.html', {'items': items})

这样就可以把items数据传递给items.html这个前端模板。

5. 创建前端模板(templates)

base文件夹下创建templates文件夹,再在templates文件夹下创建base文件夹,并在其中新建items.html文件,即base/templates/base/items.html,这样设置后,在django项目中,我们可以通过base/items.html定位到这个模板。

Django框架中存在模板寻找器,可搜索每个app的特定文件夹。

文件内容如下

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
<!DOCTYPE html>
<html lang="en">
<head>
<meta charset="UTF-8">
<meta http-equiv="X-UA-Compatible" content="IE=edge">
<meta name="viewport" content="width=device-width, initial-scale=1.0">
<title>Items</title>
</head>
<body>
<ul>
{% for item in items %}
<li>{{item.name}}</li>
{% endfor %}
</ul>
</body>
</html>

大意就是把各个物品的名字显示成一个无序列表。

6. 绑定网址

以上已经完成了后端与数据库、前端与后端的数据传递,那么用户如何访问这样一个网页呢?就需要在urls.py中绑定好网址和后端。

在base文件夹下新建urls.py文件,内容如下

1
2
3
4
5
6
7
from . import views 
from django.urls import path

urlpatterns = [
path("items/", views.get_items),
path("", views.home)
]

但这个url目前只在base这个app下,并没有被django项目所识别,因此,需要在myproject/urls.py文件中进行引用,以让项目进行识别。

1
2
3
4
5
6
from django.urls import include # 这是新增的行

urlpatterns = [
path('admin/', admin.site.urls),
path('base/', include('base.urls')) # 这是新增的行
]

7. 运行

最后,执行python manage.py runserver即可运行网站,打开http://127.0.0.1:8000/base/items/ 就显示了物品列表如下。
基本Django项目结果.png

8. 参考

  1. Django Crash Course - Introduction + Python Web Development Tutorial
  2. Django REST Framework Oversimplified