演示地址: http://mxonline.mtianyan.cn
教程仓库地址1: https://github.com/mtianyan/DjangoGetStarted
教程仓库地址2: https://github.com/mtianyan/Mxonline2
教程仓库地址3: https://github.com/mtianyan/Mxonline3
上节教程完成后代码(来学习本节前置条件):
github仓库地址:https://github.com/mtianyan/DjangoGetStarted
可能现在你还在通过手写sql语句来操作数据库,当我们有了orm,数据库操作变得很简单。这一小节我们来学习Django中的orm。
没有orm 的情况下message/views.py代码:
import MySQLdb
# 使用原生sql获取书的列表
def book_list(request):
# 创建到数据库的连接: 指明用户名,数据库,密码
db = MySQLdb.connect(user = 'me', db='mydb', passwd='secret', host='localhost')
# 创建一个游标对象执行器
cursor = db.cursor()
# 书写我们需要的sql语句
cursor.execute('SELECT name FROM books ORDER BY name')
# 对于fetchall()的结果做遍历,将遍历回来的结果当做数组,取第0个值name。
names = [row[0] for row in cursor.fetchall()]
db.close()
可不可以让数据库字段的查询和使用类的一个属性一样简单?没错登登登:orm上场了
book:name
book.name
book.save()
Django的orm就是为了让我们不再写上面那样的语句,而是像使操作数据库像使用类和类属性一样。
verbose_name:对象的人类可读的名称,单数:
verbose_name = "pizza"
class Meta,内嵌于 UserMessage 这个类的定义中
如果 class Publisher 是顶格的,那么 class Meta 在它之下要缩进4个空格--按 Python 的传统
你可以在任意一个 模型 类中使用 Meta 类,来设置一些与特定模型相关的选项。
如:设置ordering = ['name'],默认地都会按 name 字段排序
message/models.py:
# 继承于django.db.models.Model
class UserMessage(models.Model):
# 设置最大长度,verbose_name在后台显示字段会用到
name = models.CharField(max_length=20, verbose_name=u"用户名")
# Django提供内置的邮箱字段会帮忙验证` default_validators = [validators.validate_email]`
email = models.EmailField(verbose_name=u"邮箱")
address = models.CharField(max_length=100, verbose_name=u"联系地址")
message = models.CharField(max_length=500, verbose_name=u"留言信息")
class Meta:
verbose_name = u"用户留言信息"
# db_table ,这里我们让它自动生成所以不用指定
这时我们执行makemigrations messages
会发现并没有改动。
因为setting中我们没有注册我们的app: message
注意:新建的app都要在setting中注册
DjangoGetStarted/settings.py 大概36行INSTALLED_APPS
:
`INSTALLED_APPS`
[
前面的不用变,后面新增下一行
'message'
]
这时候我们重新运行Tools 菜单下 Run manage.py Task
会提示:
如果提示:
SyntaxError: Non-ASCII character '\xe7' in file D:\CodeSpace\PythonProject\DjangoGetStarted\apps\message\models.py on line
请注意可能你忘记在写过中文的地方加上:
#coding: utf-8
注意必须加在第一或二行。
然后执行下面命令:
makemigrations message
migrate message 生成数据表
前往Navicat验证:
可以看到我们的数据表已经创建成功。默认数据表名称为
app名称_类名转换为小写
自动生成的id作为主键。
除过普通的对应数据库的字段类型如CharField
,还有很多高级类型。如EmailField
提供email验证。
models.ForeignKey # 外键
models.DateTimeField # 时间字段
models.IntegerField # 整型
models.IPAddressField # IP地址
models.FileField # 上传文件
models.ImageField # 图片
ctrl按住+左键点击
models
进入之后点击fields
拖到文件开始可以看到所有字段:
__all__ = [str(x) for x in (
'AutoField', 'BLANK_CHOICE_DASH', 'BigIntegerField', 'BinaryField',
'BooleanField', 'CharField', 'CommaSeparatedIntegerField', 'DateField',
'DateTimeField', 'DecimalField', 'DurationField', 'EmailField', 'Empty',
'Field', 'FieldDoesNotExist', 'FilePathField', 'FloatField',
'GenericIPAddressField', 'IPAddressField', 'IntegerField', 'NOT_PROVIDED',
'NullBooleanField', 'PositiveIntegerField', 'PositiveSmallIntegerField',
'SlugField', 'SmallIntegerField', 'TextField', 'TimeField', 'URLField',
'UUIDField',
)]
CharField
必须指明默认最大长度。null=True,blank=True
指明字段可以为空defalut = " "
指定默认值。
name = models.CharField(max_length=20,null=True,blank=True, verbose_name=u"用户名")
id是自动生成的,如果需要自定义主键,message/models.py中添加字段:
object_id = models.CharField(primary_key=True, verbose_name="主键")
此时点击Tools 菜单下 Run manage.py Task
输入makemigrations message
知识点:CharField必须指明最大长度
object_id改为:
object_id = models.CharField(primary_key=True, max_length=50 ,verbose_name="主键")
这时点击Tools 菜单下 Run manage.py Task
输入makemigrations message
You are trying to add a non-nullable field 'object_id' to usermessage 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)
2) Quit, and let me add a default in models.py
根据提示信息,我们需要给object_id
添加默认值:
object_id = models.CharField(primary_key=True, max_length=50,default="", verbose_name="主键")
get新知识点:object_id必须有默认值
输入2
退出:然后输入makemigrations message
再输入下面命令生成数据表
migrate message
可以看到上图过程中会告诉我们做了哪些变化,如删除了默认系统生成的主键
id
,变更了name
。新增了我们的object_id
前往Navicat验证右键设计表:
可以看到object_id
已经成为我们的新主键。
Meta信息中我们可以指定常见的类型:
db_table = "user_meassage"
自定义后生成表,表名会与我们的保持一致。而不会前缀appname
如:message_
这里因为我们已经生成过了,就不要做验证改变表名了。
ordering = '-object_id'
ordering指定默认排序字段,如:就会以object_id倒序
verbose_name_plural = u"用户留言信息"
verbose_name_plural:复数信息,便于人阅读。否则会在后台显示用户留言信息s
已经学习完毕了orm
将数据表映射表。
github地址:https://github.com/mtianyan/DjangoGetStarted
此节结束对应github commit:
留言板数据库orm映射成表完成。内容截止教程3-3结束。
github仓库地址:https://github.com/mtianyan/DjangoGetStarted
在message/views.py
中:
from .models import UserMessage
将我们刚才创建的model,import进来。.
代表是与当前同级的目录。
按照下图所示添加一条测试数据。
然后再我们的getform
方法内部添加下面代码:
def getform(request):
# UserMessage默认的数据管理器objects。
# 方法all()是将所有数据返回成一个queryset类型(django的内置类型)
all_message = UserMessage.objects.all()
#我们可以对于all_message进行遍历操作
for message in all_message:
# 每个message实际就是一个UserMessage对象(这时我们就可以使用对象的相关方法)。
print message.name
return render(request, 'message_form.html')
调试过程:
点击上图小红框位置,打上断点。
点击Run -> debug后:在浏览器里打开:http://127.0.0.1:8000/form/
此时鼠标左键点击:all_message.可以看到这是一个{QuerySet}类型的对象,里面存放着[
按f6
使运行到下一步。此时下方的值窗口内可以看到message的值。说明我们成功取到了数据库的值。
all_message = UserMessage.objects.filter(name=' mtianyan', address='西安')
按照上面调试过程重新调试可以看到我们同样取出了值。
小练习:将名字改为与自己数据库存放值不同的。查看结果。
变成了空列表,说明一切正确。
了解:django/db/models/base.py 源码中提供save方法
def save(self, force_insert=False, force_update=False, using=None,
update_fields=None):
getform方法中添加代码:
# 存储部分
# 首先实例化一个对象
user_message = UserMessage()
# 为对象增加属性
user_message.name = "mtianyan2"
user_message.message = "blog.mtianyan.cn"
user_message.address = "西安"
user_message.email = "[email protected]"
user_message.object_id = "efgh"
# 调用save方法进行保存
user_message.save()
return
语句可以在下方值窗口查看到值
可以看到成功的添加了数据
mtianyan2
templates/message_form.html:
method是post。action就是指向我们在urls.py中配置的
/form/
前面必须加斜杠指根路径下form
里面的input会自动把值传递给后台:这时我们就可以在getform中取到刚才传递过来的值。
运行项目:然后输入需要填写的值。点击提交:出现403错误
Forbidden (403)
CSRF verification failed. Request aborted.
根据提示:我们的页面没有进行crsf的验证,这时django的安全机制,不允许任意form都往后台提交。
知识点:所以我们需要在html页面中加入csrf_token
{% csrf_token %}
原有那行删除掉。打上断点
刷新页面并提交。这时候在值窗口可以看到request对象下的POST中存放着我们提交的数据。内容如下
数据以dict:key-value 形式存储 key是由如下图html中的name所决定对应的。
request.POST
中数据取出,存入user_message
对象
# html表单部分
# 此处对应html中的method="post",表示我们只处理post请求
if request.method == "POST":
# 就是取字典里key对应value值而已。取name,取不到默认空
name = request.POST.get('name', '')
message = request.POST.get('message', '')
address = request.POST.get('address', '')
email = request.POST.get('email', '')
# 实例化对象
user_message = UserMessage()
# 将html的值传入我们实例化的对象.
user_message.name = name
user_message.message = message
user_message.address = address
user_message.email = email
user_message.object_id = "ijkl"
# 调用save方法进行保存
user_message.save()
因为这次是表单提交,已经变成了post方式。按
f6
进行单步调试。
一直单步到如下图蓝色
这时候值浏览窗口可以看到
检查我们的user_message对象的属性是否已经全部添加进去,
使用f8 继续项目并前往Navicat验证
可以看到我们的数据库中已经新增,标志着我们已经成功存入数据。
对于查询到的数据做删除:
# 方法2 :filter取出指定条件值,逗号代表and 必须同时满足两个条件才返回。
all_message = UserMessage.objects.filter(name='mtianyan', address='西安')
# 我的数据库里保存着可以匹配到该条数据的一行。
# 删除操作:使用delete方法删除all_message
all_message.delete()
for message in all_message:
# 删除取到的message对象
message.detele()
# print message.name
点击run并访问:http://127.0.0.1:8000/form/
进入Navicat进行验证。
可以看到我们的那条mtianyan + 西安的数据已经被删除。
至此:我们已经学会了新增,删除,查询。
本节结束github对应commit:
django model的增删改数据库。本次内容截止教程3-4。
项目Github地址:https://github.com/mtianyan/DjangoGetStarted
本节开始对应对应Github的commit:django model的增删改数据库。本次内容截止教程3-4。
本节将介绍url的配置,以及如何将数据库数据填充回前台html页面。
情景:只允许用户修改mtianyan
,如果没有就添加,如果有就回填使用户可以修改。
message/views.py中的getform方法中
message = None
all_message = UserMessage.objects.filter(name='mtianyan', address='西安')
# if 判断是否存在数据
if all_message:
# all_message是一个list,可以使用切片。
message = all_message[0]
这里注意把前几节写的删除掉
return render(request, 'message_form.html',{
"my_message" : message
})
这里前面的"my_meassage"是我们可以自行命名的。会有一个
my_message
对象随着返回前端页面。
为input系列标签添加value
: 使用my_message.name
取到我们传递过来的my_message
对象的属性值。
请自行完成姓名,邮箱,联系地址三个
input
标签。
为textarea
标签添加值
运行项目,访问:http://127.0.0.1:8000/form/
成功!!我们已经将后台数据库数据成功展示到前台。
在我们的template模板中也就是form.html中,不允许我们写Python的语法,
它提供了一套自己的内建标签。
官方文档中template内建标签用法传送门
if - else
官方提供模板如下:
个人实践:
满足if运行结果:
不满足if:如改为my_message.name == "mtianyan1"
运行结果:
ifequal
& ifnotequal
官方文档解释:ifequal a b
相当于f a == b
.ifnotequal
则相当于if a != b
个人实践:
结果为:未找到中文昵称
官方文档解释:其实就是切片操作。从头开始切到第n个。
个人实践:
本来
mtianyan
与mtianyan1
是不同的,但是切片后前八位相同。
运行结果显示 :对应中文昵称:天涯明月笙
DjangoGetStarted/urls.py:
为r'^form/$'
添加别名:
url(r'^form/$', getform, name = "form_new")
前往html中修改action地址为下面所示:
这时我们如果改动urls.py中的r'^form/$'
不需要再修改前端代码中值。
注意url匹配规则中一定不要忘记/$
符号代表以form/
结束的才会有效。不会向后继续匹配。比如没有/$
url(r'^form', getform, name="form_new")
这时我们进入浏览器访问时输入http://127.0.0.1:8000/formemmm
都可以被响应。
特别是如果底下还配置有被这个规则包含的条目,会产生被写在更靠前的拦截住得不到正确处理的Bug。
上图我们是想要让formtest响应admin.site.urls。但是会被form提前拦截住。
所以我们一定要注意加上/$
符号。
至此我们完成了留言板项目:学习到了Django必备的基础知识。
下一章我们将开始我们的进阶学习:开发在线教育平台网站。
本章结束:
对应Commit: 留言板项目学习完成,本次内容截止教程3-5。完结,撒花。
项目Github地址:https://github.com/mtianyan/DjangoGetStarted