《Django Web框架教学笔记》
目录
文章目录
静态文件
- 什么是静态文件
- 不能与服务器端做动态交互的文件都是静态文件
- 如:图片,css,js,音频,视频,html文件(部分,如:404页面)
- 静态文件配置
- 在 settings.py 中配置一下两项内容:
-
配置静态文件的访问路径
- 通过哪个url地址找静态文件
- STATIC_URL = ‘/static/’
- 说明:
- 指定访问静态文件时是需要通过 /static/xxx或 127.0.0.1:8000/static/xxx
- xxx 表示具体的静态资源位置
-
配置静态文件的存储路径
STATICFILES_DIRS
注:是一个元组,不是单个元素
- STATICFILES_DIRS保存的是静态文件在服务器端的存储位置
-
示例:
# file: setting.py STATICFILES_DIRS = ( os.path.join(BASE_DIR, "static"), ) #元组
- 访问静态文件
-
使用静态文件的访问路径进行访问
- 访问路径: STATIC_URL = ‘/static/’
- 示例:
<img src="/static/images/lena.jpg"> <img src="http://127.0.0.1:8000/static/images/lena.jpg">
-
通过 {% static %}标签访问静态文件
{% static %}
表示的就是静态文件访问路径
- 加载 static
{% load static %}
- 使用静态资源时
- 语法:
{% static '静态资源路径' %}
- 示例:
<img src="{% static 'images/lena.jpg' %}">
- 语法:
-
Django中的应用 - app
- 应用在Django项目中是一个独立的业务模块,可以包含自己的路由,视图,模板,模型
创建应用app
-
创建步骤
- 用manage.py 中的子命令 startapp 创建应用文件夹
python3 manage.py startapp 应用名称
如:python3 manage.py startapp music
- 在settings.py里注册应用
INSTALLED_APPS = [ # .... 'user', #用户信息模块 'music', #音乐模块 ]
应用的结构
-
migrations
文件夹 – 迁移- 保存数据迁移的中间文件
-
__init__.py
- 应用子包的初始化文件
-
admin.py
- 应用的后台管理配置文件
-
apps.py
- 应用的属性配置文件
-
models.py
-
与数据库相关的模型映射类文件
当写好模型后会同步到数据库中
-
-
tests.py
- 应用的单元测试文件
-
views.py
- 定义视图处理函数的文件
应用的分布式路由
- Django中,主路由配置文件(urls.py)可以不处理用户具体路由,主路由配置文件的可以做请求的分发(分布式请求处理)。具体的请求可以由各自的应用来进行处理
- 如图:
include 函数
-
作用:
- 用于分发将当前路由转到各个应用的路由配置文件的 urlpatterns 进行分布式处理
-
函数格式
- include(‘app命字.url模块名’)
模块
app命字/url模块名.py
文件件里必须有urlpatterns 列表
使用前需要使用from django.conf.urls import include
导入此函数 -
练习:
1.创建两个应用 1.创建 sport 应用,并注册 2.创建 news 应用,并注册 2.创建分布式路由系统 1. http://127.0.0.1:8000/sport/index 交给 sport 应用中的 index_view() 函数处理 2. http://127.0.0.1:8000/news/index 交给 news 应用中的 index_view() 函数处理
#代码实现: #settings.py INSTALLED_APPS = [ 'django.contrib.admin', 'django.contrib.auth', 'django.contrib.contenttypes', 'django.contrib.sessions', 'django.contrib.messages', 'django.contrib.staticfiles', 'music', # music 应用注册 'user' # user 应用注册 ] #urls.py from django.urls import path, include urlpatterns = [ path('admin/', admin.site.urls), path('music/',include('music.urls')), path('user/',include('user.urls')), ] #music/urls.py from django.urls import path from . import views urlpatterns = [ #127.0.0.1:8000/music/index path('index',views.index), ] #user/urls.py from django.urls import path from . import views urlpatterns =[ #127.0.0.1:8000/user/index path('index',views.index), ] #music/views.py from django.shortcuts import render def index(request): return render(request,'music/index.html') #user/views.py from django.shortcuts import render def index(request): return render(request,'music/index.html') #music/templates/music/index.html <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <h1>music/index</h1> </body> </html> #user/templates/music/index.html <!DOCTYPE html> <html lang="en"> <head> <meta charset="UTF-8"> <title>Title</title> </head> <body> <h1>user/index</h1> </body> </html>
应用的模板
应用内部可以配置模板目录
1,应用下手动创建 templates 文件夹
2,settings.py中确认 TEMPLATE 配置项中 的 'APP_DIRS' 值
例如 : 'APP_DIRS': True
#应用下templates 和 外层templates 都存在时,django的查找模板规则
1,优先查找外层templates目录下的模板
2,按INSTALLED_APPS配置下的 应用顺序 逐层查找
#为了防止重名,模板下创建一个与该子应用名称相同的子目录,将该文件放置子目录下
模型层
Django下配置使用 mysql 数据库
- 安装 mysqlclient [版本 mysqlclient 1.3.13以上 ,官网目前为1.4.x]
-
安装前确认ubuntu是否已安装 python3-dev 和 default-libmysqlclient-dev
-
sudo apt list --installed|grep -E ‘libmysqlclient-dev|python3-dev’
-
-
若命令无输出则需要安装 - sudo apt-get install python3-dev default-libmysqlclient-dev
-
确保上述两个库已经安装,执行 sudo pip3 install mysqlclient即可
sudo apt-get update
sudo apt-get install default-libmysqlclient-dev
sudo pip3 install mysqlclient
-
- 创建 和 配置数据库
- 创建数据库
- 创建
create database 数据库名 default charset utf8 ;
create database mywebdb default charset utf8 collate utf8_general_ci; 注解: c:关注 i:敏感,对大小写不敏感,即不区分大小写。
- 创建
- 数据库的配置
- sqlite 数据库配置
# file: settings.py DATABASES = { 'default': { 'ENGINE': 'django.db.backends.sqlite3', 'NAME': os.path.join(BASE_DIR, 'db.sqlite3'), } }
- mysql 数据库配置
DATABASES = { 'default' : { 'ENGINE': 'django.db.backends.mysql', 'NAME': 'mywebdb', # 数据库名称,需要自己定义 'USER': 'root', 'PASSWORD': '123456', # 管理员密码 'HOST': '127.0.0.1', 'PORT': 3306, } }
- sqlite 数据库配置
- 关于数据为的SETTING设置
- ENGINE
- 指定数据库的后端引擎
'django.db.backends.mysql' 'django.db.backends.sqlite3' 'django.db.backends.oracle' 'django.db.backends.postgresql'
- mysql引擎如下: - 'django.db.backends.mysql' 2. NAME - 指定要连接的数据库的名称 - `'NAME': 'mywebdb'` 3. USER - 指定登录到数据库的用户名 - `'USER':'root'` 4. PASSWORD - 连接数据库的密码。 - `'PASSWORD':'123456'` 5. HOST - 连接数据库时使用哪个主机。 - `'HOST':'127.0.0.1'` 6. PORT - 连接数据库时使用的端口。 - `'PORT':'3306'`
- ENGINE
- 创建数据库
模型(Models)
- 模型是一个Python类,它是由django.db.models.Model派生出的子类。
- 一个模型类代表数据库中的一张数据表
- 模型类中每一个类属性都代表数据库中的一个字段。
- 模型是数据交互的接口,是表示和操作数据库的方法和方式
Django 的 ORM框架
- ORM(Object Relational Mapping)即对象关系映射,它是一种程序技术,它允许你使用类和对象对数据库进行操作,从而避免通过SQL语句操作数据库
- ORM框架的作用
- 建立模型类和表之间的对应关系,允许我们通过面向对象的方式来操作数据库。
- 根据设计的模型类生成数据库中的表格。
- 通过简单的配置就可以进行数据库的切换。
- ORM 好处:
- 只需要面向对象编程, 不需要面向数据库编写代码.
- 对数据库的操作都转化成对类属性和方法的操作.
- 不用编写各种数据库的sql语句.
- 实现了数据模型与数据库的解耦, 屏蔽了不同数据库操作上的差异.
- 不在关注用的是mysql、oracle…等数据库的内部细节.
- 通过简单的配置就可以轻松更换数据库, 而不需要修改代码.
- 只需要面向对象编程, 不需要面向数据库编写代码.
- ORM 缺点
- 对于复杂业务,使用成本较高
- 根据对象的操作转换成SQL语句,根据查询的结果转化成对象, 在映射过程中有性能损失.
- ORM 示意
模型示例
-
此示例为添加一个 bookstore_book 数据表来存放图书馆中书目信息
-
添加一个 bookstore 的 app
$ python3 manage.py startapp bookstore
-
注册app
# file : setting.py INSTALLED_APPS = [ ... 'bookstore', ]
-
添加模型类
# file : bookstore/models.py from django.db import models class Book(models.Model): title = models.CharField("书名", max_length=50, default='') price = models.DecimalField('定价', max_digits=7, decimal_places=2, default=0.0) #DecimalField比float精度更高,一般用于价格。max_digits:精度,位数(包括小数点后的位数), decimal_places:小数点保留几位
-
数据库的迁移
- 迁移是Django同步您对模型所做更改(添加字段,删除模型等) 到您的数据库模式的方式
- 生成或更新迁移文件
将每个应用下的models.py文件生成一个中间文件,并保存在migrations文件夹中
python3 manage.py makemigrations
-
执行迁移脚本程序
执行迁移程序实现迁移。将每个应用下的migrations目录中的中间文件同步回数据库
python3 manage.py migrate
注: 每次修改完模型类再对服务程序运行之前都需要做以上两步迁移操作。
模型类Models 创建
-
模型类需继承自
django.db.models.Model
Models的语法规范
from django.db import models
class 模型类名(models.Model):
字段名 = models.字段类型(字段选项)> 模型类名是数据表名的一部分,建议类名首字母大写 > 字段名又是当前类的类属性名,此名称将作为数据表的字段名 > 字段类型用来映射到数据表中的字段的类型 > 字段选项为这些字段提供附加的参数信息 注:新添加的字段添加时建议设置默认值,避免导致增加新字段后原数据对应的新添加字段无内容与数据字段默认不能为空冲突。
字段类型
-
BooleanField()
- 数据库类型:tinyint(1)
- 编程语言中:使用True或False来表示值
- 在数据库中:使用1或0来表示具体的值
-
CharField()
- 数据库类型:varchar
- 注意:
- 必须要指定max_length参数值
-
DateField()
- 数据库类型:date
- 作用:表示日期
- 参数:
- auto_now: 每次保存对象时,自动设置该字段为当前时间(取值:True/False)。 (最近写入时间,修改时间)
- auto_now_add: 当对象第一次被创建时自动设置当前时间(取值:True/False)。 (创建时间)
- default: 设置当前时间(取值:字符串格式时间如: ‘2019-6-1’)。
- 以上三个参数只能多选一
-
DateTimeField()
- 数据库类型:datetime(6)
- 作用:表示日期和时间
- 参数同DateField
-
DecimalField()
-
数据库类型:decimal(x,y)
-
编程语言中:使用小数表示该列的值
-
在数据库中:使用小数
-
参数:
- max_digits: 位数总数,包括小数点后的位数。 该值必须大于等于decimal_places.
- decimal_places: 小数点后的数字数量
-
示例:
money=models.DecimalField( max_digits=7, decimal_places=2, default=0.0 )
-
-
FloatField() 近似表示
- 数据库类型:double
- 编程语言中和数据库中都使用小数表示值
-
EmailField()
- 数据库类型:varchar
- 编程语言和数据库中使用字符串
-
IntegerField()
- 数据库类型:int
- 编程语言和数据库中使用整数
-
URLField()
- 数据库类型:varchar(200)
- 编程语言和数据库中使用字符串
-
ImageField()
- 数据库类型:varchar(100)
- 作用:在数据库中为了保存图片的路径
- 编程语言和数据库中使用字符串
-
TextField()
- 数据库类型:longtext
- 作用:表示不定长的字符数据
字段选项
- 字段选项, 指定创建的列的额外的信息
- 允许出现多个字段选项,多个选项之间使用,隔开
- primary_key
- 如果设置为True,表示该列为主键,如果指定一个字段为主键,则此数库表不会创建id字段
- blank
- 设置为True时,字段可以为空。设置为False时,字段是必须填写的。
- null
- 如果设置为True,表示该列值允许为空。
- 默认为False,如果此选项为False建议加入default选项来设置默认值
- default
- 设置所在列的默认值,如果字段选项null=False建议添加此项
- db_index
- 如果设置为True,表示为该列增加索引
- unique
- 如果设置为True,表示该字段在数据库中的值必须是唯一(不能重复出现的)
- db_column
- 指定列的名称,如果不指定的话则采用属性名作为列名
- verbose_name
- 设置此字段在admin界面上的显示名称。
-
示例:
# 创建一个属性,表示用户名称,长度30个字符,必须是唯一的,不能为空,添加索引 name = models.CharField(max_length=30, unique=True, null=False, db_index=True)
-
文档参见:
Meta内部类
-
使用内部 Meta类 来给模型赋予属性,Meta类下有很多内建的类属性,可对模型类做一些控制
-
示例:
# file : bookstore/models.py from django.db import models class Book(models.Model): title = models.CharField("书名", max_length=50, default='') price = models.DecimalField('定价', max_digits=7, decimal_places=2, default=0.0) class Meta: db_table = 'book' #可改变当前模型类对应的表名
数据库迁移的错误处理方法
-
当执行
$ python3 manage.py makemigrations
出现如下迁移错误时的处理方法- 错误信息
You are trying to add a non-nullable field 'des' to book without a default; we can't do that (the database needs something to populate existing rows). Please select a fix: 1) Provide a one-off default now (will be set on all existing rows with a null value for this column) 2) Quit, and let me add a default in models.py Select an option:
- 翻译为中文如下:
您试图添加一个非空字段'des'来预订没有默认;我们不能这样做(数据库需要填充现有行) 请选择修复: 1)现在提供一次性默认值(将对所有现有行设置此列的空值) 2)退出,让我在models.py中添加一个默认值 选择一个选项:
- 错误原因
- 当对模型类新添加一个字段时可出现该错误
- 原理是 添加新字段后,数据库不知道原来已有数据对于新建字段该如何赋值,所以新增字段时,务必要添加default默认值。
- 处理方法:
- 选择1 则会进入到shell中,手动输入一个默认值
- 退出当前生成迁移文件的过程,自己去修改models.py, 新增加一个
default=XXX
的缺省值(推荐使用)
- 错误信息
-
数据库的迁移文件混乱的解决办法
- 删除 所有 migrations 里所有的 000?_XXXX.py (
__init__.py
除外) - 删除 数据库
- sql> drop database mywebdb;
- 重新创建 数据库
- sql> create datebase mywebdb default charset…;
- 重新生成migrations里所有的 000?_XXXX.py
- python3 manage.py makemigrations
- 重新更新数据库
- python3 manage.py migrate
- 删除 所有 migrations 里所有的 000?_XXXX.py (
模型层的基本操作
- 基本操作包括增删改查操作,即(CRUD操作)
- CRUD是指在做计算处理时的增加(Create)、读取查询(Read)、更新(Update)和删除(Delete)
管理器对象
- 每个继承自 models.Model 的模型类,都会有一个 objects 对象被同样继承下来。这个对象叫管理器对象
- 数据库的增删改查可以通过模型的管理器实现
class MyModel(models.Model): ... MyModel.objects.create(...) # objects 是管理器对象 eg:MyModel.objects.create(title='python',pub='清华大学出版社',price=100)
创建数据对象
- Django 使用一种直观的方式把数据库表中的数据表示成Python 对象
- 创建数据中每一条记录就是创建一个数据对象
- MyModel.objects.create(属性1=值1, 属性2=值1,…)
- 成功: 返回创建好的实体对象
- 失败: 抛出异常
- 创建 MyModel 实例对象,并调用 save() 进行保存
obj = MyModel(属性=值,属性=值) obj.属性=值 obj.save()
- MyModel.objects.create(属性1=值1, 属性2=值1,…)
Django shell 的使用
-
在Django提供了一个交互式的操作项目叫
Django Shell
它能够在交互模式用项目工程的代码执行相应的操作 -
利用 Django Shell 可以代替编写View的代码来进行直接操作
-
在Django Shell 下只能进行简单的操作,不能运行远程调式
-
启动方式:
$ python3 manage.py shell 注:每当增加了或者修改了模型类,同步到数据库后,如果需要通过django shell去操作,需要退出,重新进入。
- 注:
1. 每当增加了或者修改了模型类,同步到数据库后,如果需要通过django shell去操作,需要退出,重新进入。
2. django shell 与 python shell区别:django shell 里内置很多django模块,并且使用python shell没有django shell 的使用环境
- 练习:
```
在 bookstore/models.py 应用中添加两个model类
1. Book - 图书
1. title - CharField 书名,非空,唯一
2. pub - CharField 出版社,字符串,非空
3. price - DecimalField 图书定价 总长6位/小数点2位
4. market_price - 图书零售价 总长6位/小数点2位
2. Author - 作者
1. name - CharField 姓名,非空
2. age - IntegerField, 年龄,非空,缺省值为1
3. email - EmailField, 邮箱,允许为空
```
- 然后用 Django Shell 添加如下数据
- 图书信息
| 书名 | 定价 | 零售价 | 出版社 |
|---------|-------|--------------|----------------|
| Python | 20.00 | 25.00 | 清华大学出版社 |
| Django | 70.00 | 75.00 | 清华大学出版社 |
| JQuery | 90.00 | 85.00 | 机械工业出版社 |
| Linux | 80.00 | 65.00 | 机械工业出版社 |
| HTML5 | 90.00 | 105.00 | 清华大学出版社 |
- 作者信息:
| 姓名 | 年龄 | 邮箱 |
|-------|------|-----|
| 王老师 | 28 | wangweichao@tedu.cn |
| 吕老师 | 31 | lvze@tedu.cn |
| 祁老师 | 30 | qitx@tedu.cn |
```python
代码实现:
#bookstore.models.py 创建模型类
from django.db import models
# Create your models here.
class Book(models.Model):
title = models.CharField(verbose_name='书名',max_length=50,unique=True)
price = models.DecimalField('定价',max_digits=5,decimal_places=2)
market_price = models.DecimalField('零售价',max_digits=5,decimal_places=2, default=0.0)
pub = models.CharField(verbose_name='出版社',max_length=50, default='')
is_active = models.BooleanField('是否活跃',default=True)
class Meta:
db_table = 'book'
class Author(models.Model):
name = models.CharField(verbose_name='姓名', max_length=20)
age = models.IntegerField('年龄',default=18)
email = models.EmailField('邮箱',null=True)
#django shell
pytho3 manage.py shell
from bookstore.models import Author
Author.objects.create(name='王老师',age='28',email='wangweichao@tedu.com ')
Author.objects.create(name='吕老师',age='31',email='lvze@tedu.com')
Author.objects.create(name='祁老师',age='30',email='qitx@tedu.com')