知识预览
ORM 简介
单表操作
ORM 简介
MVC 或者 MVC 框架中包括一个重要的部分, 就是 ORM, 它实现了数据模型与数据库的解耦, 即数据模型的设计不需要依赖于特定的数据库, 通过简单的配置就可以轻松更换数据库, 这极大的减轻了开发人员的工作量, 不需要面对因数据库变更而导致的无效劳动
ORM 是 "对象 - 关系 - 映射" 的简称.
- #sql 中的表
- #创建表:
- CREATE TABLE employee(
- id INT PRIMARY KEY auto_increment ,
- name VARCHAR (20),
- gender BIT default 1,
- birthday DATA ,
- department VARCHAR (20),
- salary DECIMAL (8,2) unsigned,
- );
- #sql 中的表纪录
- #添加一条表纪录:
- INSERT employee (name,gender,birthday,salary,department)
- VALUES ("alex",1,"1985-12-12",8000,"保洁部");
- #查询一条表纪录:
- SELECT * FROM employee WHERE age=24;
- #更新一条表纪录:
- UPDATE employee SET birthday="1989-10-24" WHERE id=1;
- #删除一条表纪录:
- DELETE FROM employee WHERE name="alex"
- #python 的类
- class Employee(models.Model):
- id=models.AutoField(primary_key=True)
- name=models.CharField(max_length=32)
- gender=models.BooleanField()
- birthday=models.DateField()
- department=models.CharField(max_length=32)
- salary=models.DecimalField(max_digits=8,decimal_places=2)
- #python 的类对象
- #添加一条表纪录:
- emp=Employee(name="alex",gender=True,birthday="1985-12-12",epartment="保洁部")
- emp.save()
- #查询一条表纪录:
- Employee.objects.filter(age=24)
- #更新一条表纪录:
- Employee.objects.filter(id=1).update(birthday="1989-10-24")
- #删除一条表纪录:
- Employee.objects.filter(name="alex").delete()
对应关系代码战士
单表操作
创建表
1 创建模型
创建名为 book 的 App, 在 book 下的 models.py 中创建模型:
- from django.db import models
- # Create your models here.
- class Book(models.Model):
- id=models.AutoField(primary_key=True)
- title=models.CharField(max_length=32)
- state=models.BooleanField()
- pub_date=models.DateField()
- price=models.DecimalField(max_digits=8,decimal_places=2)
- publish=models.CharField(max_length=32)
2 更多字段和参数
每个字段有一些特有的参数, 例如, CharField 需要 max_length 参数来指定 VARCHAR 数据库字段的大小. 还有一些适用于所有字段的通用参数. 这些参数在文档中有详细定义, 这里我们只简单介绍一些最常用的:
更多字段:
<1> CharField
字符串字段, 用于较短的字符串.
CharField 要求必须有一个参数 maxlength, 用于从数据库层和 Django 校验层限制该字段所允许的最大字符数.
- <2> IntegerField
- #用于保存一个整数.
- <3> FloatField
一个浮点数. 必须 提供两个参数:
参数 描述
max_digits 总位数(不包括小数点和符号)
decimal_places 小数位数
举例来说, 要保存最大值为 999 (小数点后保存 2 位), 你要这样定义字段:
models.FloatField(..., max_digits=5, decimal_places=2)
要保存最大值一百万 (小数点后保存 10 位) 的话, 你要这样定义:
models.FloatField(..., max_digits=19, decimal_places=10)
admin 用一个文本框 (<input type="text">) 表示该字段保存的数据.
<4> AutoField
一个 IntegerField, 添加记录时它会自动增长. 你通常不需要直接使用这个字段;
自定义一个主键: my_id=models.AutoField(primary_key=True)
如果你不指定主键的话, 系统会自动添加一个主键字段到你的 model.
<5> BooleanField
A true/false field. admin 用 checkbox 来表示此类字段.
<6> TextField
一个容量很大的文本字段.
admin 用一个 <textarea> (文本区域)表示该字段数据.(一个多行编辑框).
<7> EmailField
一个带有检查 Email 合法性的 CharField, 不接受 maxlength 参数.
<8> DateField
一个日期字段. 共有下列额外的可选参数:
Argument 描述
auto_now 当对象被保存时, 自动将该字段的值设置为当前时间. 通常用于表示 "last-modified" 时间戳.
auto_now_add 当对象首次被创建时, 自动将该字段的值设置为当前时间. 通常用于表示对象创建时间.
- (仅仅在 admin 中有意义...)
- <9> DateTimeField
一个日期时间字段. 类似 DateField 支持同样的附加选项.
<10> ImageField
类似 FileField, 不过要校验上传对象是否是一个合法图片.# 它有两个可选参数: height_field 和 width_field,
如果提供这两个参数, 则图片将按提供的高度和宽度规格保存.
<11> FileField
一个文件上传字段.
要求一个必须有的参数: upload_to, 一个用于保存上载文件的本地文件系统路径. 这个路径必须包含 strftime #formatting,
该格式将被上载文件的 date/time
替换(so that uploaded files don't fill up the given directory).
admin 用一个 < input type="file">部件表示该字段保存的数据(一个文件上传部件) .
注意: 在一个 model 中使用 FileField 或 ImageField 需要以下步骤:
(1)在你的 settings 文件中, 定义一个完整路径给 MEDIA_ROOT 以便让 Django 在此处保存上传文件.
(出于性能考虑, 这些文件并不保存到数据库.) 定义 MEDIA_URL 作为该目录的公共 URL. 要确保该目录对
web 服务器用户帐号是可写的.
(2) 在你的 model 中添加 FileField 或 ImageField, 并确保定义了 upload_to 选项, 以告诉 Django
使用 MEDIA_ROOT 的哪个子目录保存上传文件. 你的数据库中要保存的只是文件的路径(相对于 MEDIA_ROOT).
出于习惯你一定很想使用 Django 提供的 get_<#fieldname>_url 函数. 举例来说, 如果你的 ImageField
叫作 mug_shot, 你就可以在模板中以 {{ object.#get_mug_shot_url }} 这样的方式得到图像的绝对路径.
<12> URLField
用于保存 URL. 若 verify_exists 参数为 True (默认), 给定的 URL 会预先检查是否存在( 即 URL 是否被有效装入且
没有返回 404 响应).
- admin 用一个 <input type="text"> 文本框表示该字段保存的数据(一个单行编辑框)
- <13> NullBooleanField
类似 BooleanField, 不过允许 NULL 作为其中一个选项. 推荐使用这个字段而不要用 BooleanField 加 null=True 选项
admin 用一个选择框 <select> (三个可选择的值: "Unknown", "Yes" 和 "No" ) 来表示这种字段数据.
<14> SlugField
"Slug" 是一个报纸术语. slug 是某个东西的小小标记(短签), 只包含字母, 数字, 下划线和连字符.# 它们通常用于 URLs
若你使用 Django 开发版本, 你可以指定 maxlength. 若 maxlength 未指定, Django 会使用默认长度: 50. #在
以前的 Django 版本, 没有任何办法改变 50 这个长度.
这暗示了 db_index=True.
它接受一个额外的参数: prepopulate_from, which is a list of fields from which to auto-#populate
the slug, via JavaScript,in the object's admin form: models.SlugField
(prepopulate_from=("pre_name", "name"))prepopulate_from 不接受 DateTimeFields.
<13> XMLField
一个校验值是否为合法 xml 的 TextField, 必须提供参数: schema_path, 它是一个用来校验文本的 RelaxNG schema #的文件系统路径.
<14> FilePathField
可选项目为某个特定目录下的文件名. 支持三个特殊的参数, 其中第一个是必须提供的.
参数 描述
path 必需参数. 一个目录的绝对文件系统路径. FilePathField 据此得到可选项目.
Example: "/home/images".
match 可选参数. 一个正则表达式, 作为一个字符串, FilePathField 将使用它过滤文件名.
注意这个正则表达式只会应用到 base filename 而不是
路径全名. Example: "foo.*\.txt^", 将匹配文件 foo23.txt 却不匹配 bar.txt 或 foo23.gif.
recursive 可选参数. 要么 True 要么 False. 默认值是 False. 是否包括 path 下面的全部子目录.
这三个参数可以同时使用.
match 仅应用于 base filename, 而不是路径全名. 那么, 这个例子:
FilePathField(path="/home/images", match="foo.*", recursive=True)
... 会匹配 /home/images/foo.gif 而不匹配 /home/images/foo/bar.gif
<15> IPAddressField
一个字符串形式的 IP 地址, (i.e. "24.124.1.30").
<16> CommaSeparatedIntegerField
用于存放逗号分隔的整数值. 类似 CharField, 必须要有 maxlength 参数.
View Code
更多参数:
(1)null
如果为 True,Django 将用 NULL 来在数据库中存储空值. 默认值是 False.
(1)blank
如果为 True, 该字段允许不填. 默认为 False.
要注意, 这与 null 不同. null 纯粹是数据库范畴的, 而 blank 是数据验证范畴的.
如果一个字段的 blank=True, 表单的验证将允许该字段是空值. 如果字段的 blank=False, 该字段就是必填的.
(2)default
字段的默认值. 可以是一个值或者可调用对象. 如果可调用 , 每有新对象被创建它都会被调用.
(3)primary_key
如果为 True, 那么这个字段就是模型的主键. 如果你没有指定任何一个字段的 primary_key=True,
Django 就会自动添加一个 IntegerField 字段做为主键, 所以除非你想覆盖默认的主键行为,
否则没必要设置任何一个字段的 primary_key=True.
(4)unique
如果该值设置为 True, 这个数据字段的值在整张表中必须是唯一的
(5)choices
由二元组组成的一个可迭代对象(例如, 列表或元组), 用来给字段提供选择项. 如果设置了 choices , 默认的表单将是一个选择框而不是标准的文本框,<br > 而且这个选择框的选项就是 choices 中的选项.
View Code
3 settings 配置
若想将模型转为 MySQL 数据库中的表, 需要在 settings 中配置:
- DATABASES = {
- 'default': {
- 'ENGINE': 'django.db.backends.mysql',
- 'NAME':'bms', # 要连接的数据库, 连接前需要创建好
- 'USER':'root', # 连接数据库的用户名
- 'PASSWORD':'', # 连接数据库的密码
- 'HOST':'127.0.0.1', # 连接主机, 默认本级
- 'PORT':3306 # 端口 默认 3306
- }
- }
注意 1:NAME 即数据库的名字, 在 MySQL 连接前该数据库必须已经创建, 而上面的 SQLite 数据库下的 db.sqlite3 则是项目自动创建 USER 和 PASSWORD 分别是数据库的用户名和密码. 设置完后, 再启动我们的 Django 项目前, 我们需要激活我们的 MySQL. 然后, 启动项目, 会报错: no module named MySQLdb . 这是因为 django 默认你导入的驱动是 MySQLdb, 可是 MySQLdb 对于 py3 有很大问题, 所以我们需要的驱动是 PyMySQL 所以, 我们只需要找到项目名文件下的__init__, 在里面写入:
- import pymysql
- pymysql.install_as_MySQLdb()
最后通过两条数据库迁移命令即可在指定的数据库中创建表 :
- python manage.py makemigrations
- python manage.py migrate
注意 2: 确保配置文件中的 INSTALLED_APPS 中写入我们创建的 App 名称
- INSTALLED_APPS = [
- 'django.contrib.admin',
- 'django.contrib.auth',
- 'django.contrib.contenttypes',
- 'django.contrib.sessions',
- 'django.contrib.messages',
- 'django.contrib.staticfiles',
- "book"
- ]
注意 3: 如果报错如下:
django.core.exceptions.ImproperlyConfigured: mysqlclient 1.3.3 or newer is required; you have 0.7.11.None
MySQLclient 目前只支持到 python3.4, 因此如果使用的更高版本的 python, 需要修改如下:
通过查找路径 C:\Programs\Python\Python36-32\Lib\site-packages\Django-2.0-py3.6.egg\django\db\backends\MySQL
这个路径里的文件把
- if version <(1, 3, 3):
- raise ImproperlyConfigured("mysqlclient 1.3.3 or newer is required; you have %s" % Database.__version__)
注释掉 就 OK 了.
注意 4: 如果想打印 ORM 转换过程中的 sql, 需要在 settings 中进行如下配置:
- LOGGING = {
- 'version': 1,
- 'disable_existing_loggers': False,
- 'handlers': {
- 'console':{
- 'level':'DEBUG',
- 'class':'logging.StreamHandler',
- },
- },
- 'loggers': {
- 'django.db.backends': {
- 'handlers': ['console'],
- 'propagate': True,
- 'level':'DEBUG',
- },
- }
- }
添加表纪录
方式 1
- # create 方法的返回值 book_obj 就是插入 book 表中的 python 葵花宝典这本书籍纪录对象
- book_obj=Book.objects.create(title="python 葵花宝典",state=True,price=100,publish="苹果出版社",pub_date="2012-12-12")
方式 2
- book_obj=Book(title="python 葵花宝典",state=True,price=100,publish="苹果出版社",pub_date="2012-12-12")
- book_obj.save()
查询表纪录
查询 API
- <1>
- all(): 查询所有结果
- <2>
- filter(**kwargs): 它包含了与所给筛选条件相匹配的对象
- <3>
- get(**kwargs): 返回与所给筛选条件相匹配的对象, 返回结果有且只有一个,
如果符合筛选条件的对象超过一个或者没有都会抛出错误.
- <4>
- exclude(**kwargs): 它包含了与所给筛选条件不匹配的对象
- <5>
- order_by(*field): 对查询结果排序
- <6>
- reverse(): 对查询结果反向排序
- <8>
- count(): 返回数据库中匹配查询 (QuerySet) 的对象数量.
- <9>
- first(): 返回第一条记录
- <10>
- last(): 返回最后一条记录
- <11>
- exists(): 如果 QuerySet 包含数据, 就返回 True, 否则返回 False
- <12>
- values(*field): 返回一个 ValueQuerySet-- 一个特殊的 QuerySet, 运行后得到的并不是一系列
model 的实例化对象, 而是一个可迭代的字典序列
- <13>
- values_list(*field): 它与 values()非常相似, 它返回的是一个元组序列, values 返回的是一个字典序列
- <14>
- distinct(): 从返回结果中剔除重复纪录
基于双下划线的模糊查询
- Book.objects.filter(price__in=[100,200,300])
- Book.objects.filter(price__gt=100)
- Book.objects.filter(price__lt=100)
- Book.objects.filter(price__range=[100,200])
- Book.objects.filter(title__contains="python")
- Book.objects.filter(title__icontains="python")
- Book.objects.filter(title__startswith="py")
- Book.objects.filter(pub_date__year=2012)
删除表纪录
删除方法就是 delete(). 它运行时立即删除对象而不返回任何值. 例如:
model_obj.delete()
你也可以一次性删除多个对象. 每个 QuerySet 都有一个 delete() 方法, 它一次性删除 QuerySet 中所有的对象.
例如, 下面的代码将删除 pub_date 是 2005 年的 Entry 对象:
Entry.objects.filter(pub_date__year=2005).delete()
在 Django 删除对象时, 会模仿 SQL 约束 ON DELETE CASCADE 的行为, 换句话说, 删除一个对象时也会删除与它相关联的外键对象. 例如:
- b = Blog.objects.get(pk=1)
- # This will delete the Blog and all of its Entry objects.
- b.delete()
要注意的是: delete() 方法是 QuerySet 上的方法, 但并不适用于 Manager 本身. 这是一种保护机制, 是为了避免意外地调用 Entry.objects.delete() 方法导致 所有的 记录被误删除. 如果你确认要删除所有的对象, 那么你必须显式地调用:
Entry.objects.all().delete()
如果不想级联删除, 可以设置为:
pubHouse = models.ForeignKey(to='Publisher', on_delete=models.SET_NULL, blank=True, null=True)
修改表纪录
Book.objects.filter(title__startswith="py").update(price=120)
此外, update()方法对于任何结果集 (QuerySet) 均有效, 这意味着你可以同时更新多条记录 update()方法会返回一个整型数值, 表示受影响的记录条数.
代码示例: 图书管理系统
项目列表:
models 文件:
- from django.db import models
- # Create your models here.
- # 存放表结构
- class Book(models.Model): # 创建 book 的 table
- nid = models.AutoField(primary_key=True) # 自增约束的主键
- title = models.CharField(max_length=32) # varchar 字符串类型
- price = models.DecimalField(max_digits=8,decimal_places=2) # 精度最高的浮点型, 最大 8 整数位, 2 为浮点型
- pub_date = models.DateTimeField() # 格式'2012-12-12'
- publish = models.CharField(max_length=32)
views 文件:
- from django.shortcuts import render, HttpResponse,redirect
- from app01.models import Book # 导入 models 中的 Book 类
- from django.urls import reverse
- # Create your views here.
- def addbook(request):
- '''
- 添加表记录
- 方式 1:
- 生成类的对象 + save
- 方式 2:[常用]
- 类. objects.create(参数)
- 注意: create 方法返回当前类生成的表记录的对象(对应方式 1 中的 book)
- '''
- # 方式 1
- # book = Book(title='python', price=123, pub_date='2012-12-12', publish='人民出版社')
- # book.save()
- # 方式 2
- # Book.objects.create(title='linux', price=111, pub_date='2012-12-12', publish='人民出版社')
- if request.method == 'POST':
- # 获取用户提交的数据
- # 方式 1
- # title = request.POST.get('title')
- # price = request.POST.get('price')
- # pub_date = request.POST.get('pub_date')
- # publish = request.POST.get('publish')
- # Book.objects.create(title=title, price=price, pub_date=pub_date, publish=publish)
- # 方式 2
- data = request.POST.dict()
- del data['csrfmiddlewaretoken']
- book = Book.objects.create(**data)
- return redirect(reverse('books'))
- else:
- return render(request, 'addbook.html')
- def books(request):
- book_list = Book.objects.all() # 查所有
- # book_list = Book.objects.filter(title='python') # title='pyhton'的书籍
- print(book_list) # QuerySet 数据类型
- print(book_list[0].title) # 第一条数据的 title
- return render(request, 'books.html', {'book_list':book_list})
- def delbook(request, delete_book_id):
- Book.objects.filter(nid=delete_book_id).delete()
- return redirect(reverse('books'))
urls 文件:
- from django.contrib import admin
- from django.urls import path,re_path
- from app01 import views
- urlpatterns = [
- path('admin/', admin.site.urls),
- path('books/add/', views.addbook),
- path('books/', views.books, name='books'),
- re_path('books/delete/(\d+)', views.delbook, name='books'),
- ]
templates/addbook 文件:
- <!DOCTYPE HTML>
- <HTML lang="en">
- <head>
- <meta charset="UTF-8">
- <title>Title</title>
- <link rel="stylesheet" href="https://cdn.jsdelivr.net/npm/[email protected]/dist/CSS/bootstrap.min.css"
- integrity="sha384-BVYiiSIFeK1dGmJRAkycuHAHRg32OmUcww7on3RYdg4Va+PmSTsz/K68vbdEjh4u" crossorigin="anonymous">
- <style>
- .container{
- margin: 50px;
- }
- </style>
- </head>
来源: http://www.bubuko.com/infodetail-3269311.html