基于Django的博客兼学术主页管理网站
摘要:
本系统基于后端Django框架和前端HTML页面,使用MVT设计模式构建了博客兼学术主页管理网站。该网站具有编写博客、阅读博客、点赞评论其他人博客的博客系统交互功能。同时具有查看他人学术主页、关注他人学术主页的学术社交功能。基于Ajax的前端页面使得所有交互信息可以实时动态刷新,功能设计对用户友好。本报告将针对系统的开发原理、功能特点和设计方案进行介绍
1 前言
1.1预期实现目标
用户通过主页进行注册,将信息写入数据库。登陆后可以写自己的博客,写完后也能存入数据库。除此之外用户可以对自己的博客进行增删改查操作。
已经登录的用户可以自行编辑学术主页并保存于数据库,可以查看其他用户的学术主页并根据自己的兴趣选择是否关注该用户,而路人只需通过链接即可访问主页。特权管理员可以对全局的数据进行修改并保存在数据库中。
简而言之,实现一个简单的CSDN。
1.2 系统的开发环境及运行环境
操作系统: Windows 10
建模工具: process on 在线流程图设计
数据库系统:Mysql
开发工具: Pycharm
Web部署:pythonanywhere
2 设计与分析
2.1 系统需求分析
本系统主要满足来自三方面的需求,这三个方面分别是游客、用户和管理员,也即是三类角色。
(1)用户是主要的需求者,第一次登录后可以注册账户。登录后编辑个人的学术主页、编写博客、修改博客、查看他人博客、对感兴趣的博客进行点赞、评论。查看其他用户的学术主页,关注感兴趣的学术主页。
(2)游客主要需求功能是查看现有用户列表、特定用户的学术主页
(3)管理员的功能需求主要是运维后端,包括删除特定的用户或博客。
本系统将用户、游客、管理员的身份及权限进行严格的划分,让用户拥有最高使用权限,可以查看、修改系统中的所有个人信息,如新建个人学术主页,修改个人学术主页信息,修改已发表博客内容等,让游客拥有少部分权限,仅能查看用户的学术主页信息。让管理员拥有修改系统后台部分数据的权限。而修改密码模块的权限每个用户都可拥有,用以修改自己的密码信息。通过进行严格的权限划分,可以更好地进行管理,也可更好地保护用户信息安全。
2.2 E-R图
根据用户需求进行分析,绘制ER图如下:
图1 ER图
基于以上E-R可以设计对应的数据类型如下
表1 note_note
名称 数据类型 是否为主键 自增属性
id bigint(20) PRI auto_increment
title varchar(100)
tag1 varchar(30)
tag2 varchar(30)
comment_num int(11)
seen_num int(11)
ok_num int(11)
is_show tinyint(1)
content longtext
create_time datetime(6)
update_time datetime(6)
auther_id varchar(30) MUL
表2 user_user
名称 数据类型 是否为主键 自增属性
username varchar(30) NO PRI
password varchar(32) NO
blog_num int(11) NO
mail_address varchar(20) NO
user_level int(11) NO
create_time datetime(6) NO
update_time datetime(6) NO
表3 acdmpage_award
名称 数据类型 是否为主键 自增属性
id bigint(20) PRI auto_increment
time date
title varchar(100)
description varchar(300)
link varchar(100)
auther_list varchar(100)
表4 acdmpage_award
名称 数据类型 是否为主键 自增属性
id bigint(20) PRI auto_increment
time date
title varchar(100)
description varchar(300)
link varchar(100)
auther_list varchar(100)
表5 acdmpage_academy_page
名称 数据类型 是否为主键 自增属性
id bigint(20) PRI auto_increment
introduction longtext
name varchar(10)
major varchar(100)
create_time datetime(6)
update_time datetime(6)
pic varchar(100)
awards_id bigint(20) MUL
papers_id bigint(20) MUL
projects_id bigint(20) MUL
records_id bigint(20) MUL
services_id bigint(20) MUL
user_id varchar(30) MUL
Fans_num Integer
表6 acdmpage_contact
名称 数据类型 是否为主键 自增属性
id bigint(20) PRI auto_increment
phone varchar(30)
email varchar(30)
github varchar(30)
zhihu varchar(30)
blog varchar(30)
表8 acdmpage_paper
名称 数据类型 是否为主键 自增属性
id bigint(20) PRI auto_increment
time date
title varchar(100)
description varchar(300)
link varchar(100)
auther_list varchar(100)
表9 acdmpage_project
名称 数据类型 是否为主键 自增属性
id bigint(20) PRI auto_increment
time date
title varchar(100)
description varchar(300)
link varchar(100)
auther_list varchar(100)
表10 acdmpage_record
名称 数据类型 是否为主键 自增属性
id bigint(20) PRI auto_increment
time date
title varchar(100)
content varchar(300)
表11 acdmpage_service
名称 数据类型 是否为主键 自增属性
id bigint(20) PRI auto_increment
time date
title varchar(100)
description varchar(300)
link varchar(100)
表12 acdlist_followrelation
名称 数据类型 是否为主键 自增属性
id bigint(20) PRI auto_increment
followed varchar(100)
following varchar(100)
2.3 系统用例图
图2 系统用例图
表12 用例图归纳
2.4 系统体系结构
2.5 功能流程图
系统主要功能有用户登录、用户注册和博客发布,系统每个功能运行流程图如下。
图4 用户登录流程图
图5 用户注册流程图
图6 博客发布流程图
3 代码实现部分
3.1 项目文件
图7 项目文件
3.2 文件说明
文件说明如下表:
表13 文件说明
3.3 部分实现代码
由于项目文件较多,此处仅展示部分代码。
3.3.1 项目的整体配置
数据库的配置
本次项目的数据库采用MySQL作为数据库,下面进行MySQL在django中的使用:
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.mysql',
# 'ENGINE': 'django.db.backends.postgresql_psycopg2',
'NAME': 'blogdb',
'USER': 'root',
'PASSWORD': '#####',
'HOST': '127.0.0.1',
'PORT': '3306'
}
}
项目app的配置
INSTALLED_APPS = [
'django.contrib.admin',
'django.contrib.auth',
'django.contrib.contenttypes',
'django.contrib.sessions',
'django.contrib.messages',
'django.contrib.staticfiles',
'user',
'index',
'note',
'acdmpage',
'comment',
'acdlist',
'statistic',
'mdeditor', # markdown语法
]
静态路径的配置
STATIC_URL = '/static/'
STATIC_ROOT = os.path.join(os.path.dirname(__file__),'acdmpage/static')
STATICFILES_DIRS = (
os.path.join(BASE_DIR, 'static').replace('\\', '/'),
os.path.join(BASE_DIR,).replace('\\', '/'),
)
全局一级路由的配置
urlpatterns = [
path("", index_views.index_view),
path('index', index_views.index_view),
path('test', index_views.index_test),
path('admin/', admin.site.urls),
path('note/', include('note.urls')),
path('user/', include('user.urls')),
path('academy/', include('acdmpage.urls')),
path('acdlist/', include('acdlist.urls')),
path('statistic/', include(('statistic.urls', 'statistic'), namespace='statistic')),
path('mdeditor/', include('mdeditor.urls'))
]
3.3.2 博客板块的功能实现
博客板块的数据库建模
下面以Note模型为例:
class Note(models.Model):
title = models.CharField('文章标题', max_length=100)
tag1 = models.CharField('标签1', max_length=30,)
tag2 = models.CharField('标签2', max_length=30,)
comment_num = models.IntegerField("评论数量", default=0)
seen_num = models.IntegerField("阅读数量", default=0)
ok_num = models.IntegerField("点赞数量", default=0)
is_show = models.BooleanField("是否可见", default=True)
# content = models.TextField("内容")
content = MDTextField("内容")
create_time = models.DateTimeField("创建时间", auto_now_add=True)
update_time = models.DateTimeField("更新时间", auto_now=True)
auther = models.ForeignKey(User, on_delete=models.CASCADE)
def __str__(self):
return 'Title %s Auther %s '%(self.title, self.auther)
def get_absolute_url(self):
return reverse('mynotes')
博客板块子路由的分发
urlpatterns = [
path('add', views.add_view),
path('update', views.update_view),
path('notelist', views.notelist_view),
path('delete', views.delete_view),
# path('<name>',views.get_note_of),
path('mynote', views.get_note_of, name='mynotes'),
path('single_note', views.get_note_single),
path('edit', views.note_edit),
path("like_handle", views.like_handle),
path('search', views.search_handle),
# path('myadd', views.myadd)
]
博客板块主要视图部分的功能代码实现:
添加文章:
def add_view(request: HttpRequest):
if request.method == 'GET':
form = ArticleForm()
return render(request, 'note/add_note.html', {'form': form})
elif request.method == 'POST':
print(request.POST)
username = request.session['username']
title = request.POST['title']
content = request.POST['content']
tag1 = request.POST['tag1']
tag2 = request.POST['tag2']
try:
user = User.objects.get(username=username)
# Note.objects.create(title=title, content=content, auther=user)
note = Note(title=title, content=content, auther=user, tag1=tag1, tag2=tag2)
if 'is_show' not in request.POST:
note.is_show = False
else:
note.is_show = True
note.save()
except Exception as e:
print("add failed %s" % (e))
return HttpResponse("添加失败 %s" % (e))
return HttpResponseRedirect('/note/mynote')
修改文章
def update_view(request):
if request.method == "GET":
return render(request, 'note/update_note.html')
elif request.method == "POST":
return HttpResponse("修改成功")
展示相关信息
@check_login
def notelist_view(request):
notelist = Note.objects.all()
print(locals())
return render(request, 'note/notelist.html', locals())
@check_login
def get_note_of(request):
name = request.session.get("username")
user = User.objects.filter(username=name)
notelist = Note.objects.filter(auther_id=name)
return render(request, 'note/ones_note.html', locals())
@check_login
def get_note_single(request: HttpRequest):
username = request.session.get("username")
user = User.objects.filter(username=username)
targetUser = request.GET['auther']
targetID = request.GET['noteId']
note = Note.objects.filter(id=targetID)
records = Like.objects.filter(user=username, note=targetID)
if records:
like = True
else:
like = False
for n in note:
n.seen_num += 1
n.save()
if username == targetUser:
flag = True
else:
flag = False
dic = {};
dic['username'] = username
dic['targetUser'] = targetUser
dic['note'] = note[0]
dic['flag'] = flag
dic['like'] = like
dic['sorted_tag_key'] = tag_count().keys()
dic['sorted_tag_value'] = tag_count().values()
return render(request, 'note/single_note.html', dic)
页面html采用模板继承的写法来简化页面代码的编写,这样的也可以将页面中的功能高度相关的模块独立出来,有利于代码的复用和后期功能的维护。
博客板块的页面代码如下图所示:
3.3.3 学术主页的创建与查看
User/views.py
def reg_view(request):
# 注册
# Get返回页面
#post提交
#用户名是主键,必须保持唯一性
#两次密码必须相同 密码加密操作
#注册免登录 即session或cookie
if request.method=='GET':
return render(request,'user/register.html')
elif request.method=='POST':
# 用户名唯一性检查
#密码安全性提示
username=request.POST['username']
mail_address = request.POST['mailaddr']
pwd1 = request.POST['pwd1']
pwd2 = request.POST['pwd2']
# 密码必须一致
if pwd1!=pwd2:
return HttpResponse("两次密码输入不一致")
# 哈希算法对密码加密
obj_hash=hashlib.md5()
obj_hash.update(pwd1.encode())
pwd=obj_hash.hexdigest()
#查询该用户名是否存在 检查用户名即主键唯一性
not_availiable=User.objects.filter(username=username)
if not_availiable:
return HttpResponse("用户名已存在")
try:
User.objects.create(username=username, mail_address=mail_address, password=pwd)
except Exception as e:
# 并发写入可能报错
print("---create user failed %s"%(e))
return HttpResponse("用户名已注册")
# session免登录
request.session['username']=username
request.session['uid']=pwd[0:5]
return HttpResponseRedirect("/index")
def login_view(request):
if request.method=='GET':
username = request.session.get('username')
uid = request.session.get('uid')
if not username:
username = request.COOKIES.get('username')
uid = request.COOKIES.get('uid')
print("1", username)
if username:
request.session['username'] = username
request.session['uid'] = uid
try:
user = User.objects.get(username=username)
pwd = user.password
if uid == pwd[0:5]:
return HttpResponse("已登录 跳转首页")
except Exception as e:
print("没有找到cookie或session")
return render(request,'user/login.html')
return render(request,'user/login.html')
elif request.method=='POST':
username=request.POST['username']
pwd = request.POST['pwd']
try:
user=User.objects.get(username=username)
except Exception as e:
print("---login failed %s"%(e))
return HttpResponse("用户名或密码错误")
obj_hash=hashlib.md5()
obj_hash.update(pwd.encode())
pwd=obj_hash.hexdigest()
password=user.password
if password!=pwd:
return HttpResponse("用户名或密码错误")
request.session['username']=username
request.session['uid']=pwd[0:5]
resp=HttpResponseRedirect("/index")
if 'remember' in request.POST:
resp.set_cookie('username',username,3600*24*3)
resp.set_cookie('uid',pwd[0:5])
return resp
def exit_view(request):
response=HttpResponseRedirect('/index')
user=request.session.get('username')
try:
if not user:
user=request.COOKIES.get('username')
if user:
response.delete_cookie('username')
response.delete_cookie('uid')
else:
request.session.flush()
response.delete_cookie('username')
response.delete_cookie('uid')
except Exception as e:
print("error occured when exit_view %s"%(e))
return response
return response
显示全站学术主页
def acdlist_view(request):
username = request.session.get("username")
ap = academy_page.objects.all()
dic = {}
for a in ap:
if FollowRelation.objects.filter(followed = a.user_id,following = username):
dic[a] = "取消关注"
else:
dic[a] = "关注"
return render(request, 'acdlist/acdlist.html', locals())
关注其他用户的学术主页
def look_view(request):
def success_response(fans_num, concern):
data = {}
data['status'] = 'SUCCESS'
data['fans_num'] = fans_num
print(fans_num)
data['concern'] = concern
return JsonResponse(data)
def error_response(message):
data = {}
data['status'] = 'ERROR'
data['message'] = message
return JsonResponse(data)
name = request.POST['user']
flag = request.POST['flag']
follow_name = request.POST['follow_name']
user = academy_page.objects.filter(user_id=name)[0]
follow_record, created = FollowRelation.objects.get_or_create(followed = follow_name,following = name)
follow_record.save()
followed_user = academy_page.objects.filter(user_id=follow_name)[0]
if flag=='1':
followed_user.fans_num = followed_user.fans_num + 1
else:
followed_user.fans_num = followed_user.fans_num - 1
FollowRelation.objects.filter(followed=follow_name, following=name).delete()
followed_user.save()
concern = True
return success_response(followed_user.fans_num,concern)
查看我的关注
def show_all_follow(request):
username = request.session.get("username")
ap = academy_page.objects.all()
list = []
for a in ap:
if FollowRelation.objects.filter(followed=a.user_id, following=username):
list.append(a)
return render(request, 'acdlist/acdfollow.html',locals())
描述关注与被关注关系的FollowRelation表
from django.db import models
class FollowRelation(models.Model):
followed = models.CharField(max_length=128, blank=True, null=True)
following = models.CharField(max_length=128, blank=True, null=True)
4 项目实现效果与说明
4.1 个人登录与注册
进入主页是先是已登录状态(用户root),背景图为必应每日一图api,欢迎当前用户,再下面显示每日一句调api,上面有查看博客列表,进入学术主页,查看个人博客,查看个人主页,退出登陆选项。而未登录时则不会显示个人博客与个人学术主页。界面如下:
图8 主页-已登录
图9 主页-未登录
主页用户地图
主页歌曲播放
相同的背景,进行用户登录,采用session和cookies记住用户实现免登录
图10 用户登录界面
用户注册时,默认用户等级为0,即一般用户,可以通过后台对该数值进行修改,从而赋予特权,即查看全局与修改全局。注册后直接写入数据库user_user表。
图11 用户注册界面
4.2 学术主页的编辑与查看
登录后,用户可以自行编辑自己的学术主页进行编辑,编辑论文,个人图片等信息。之后上线后,一般未登录用户可以通过链接直接访问。
学术主页查看
图12 学术主页查看界面
图13 预期实现效果
学术主页编辑
个人头像编辑
每次进入编辑页面自动加载已经保存的内容
主页profile编辑
动态添加introduction
需要增加表项时则点击添加
提交与保存
在全站学术主页中可以看到所有用户的主页和基本信息
可以关注除自己外的其他用户,每次进入全站学术主页中会显示“关注”或“取消关注”
关注后可以在我的关注中查看
4.3 博客部分
点击进入全站博客列表可以看到全站所有博客的相关信息,包括文章标题、作者、标签、阅读量、点赞数、评论数等相关信息,点击文章标题可进入具体文章的详情页面。如果点击的当前用户自己发表的文章,则可在文章详情页面进行点击按钮编辑。进入文章详情页面后会展示文章的具体内容,进行点赞、搜索全站博客等功能。每篇博客还设置了浏览量记录,即每进行一次页面访问都会使页面的浏览量加一。
博客的点赞功能演示如下所示:
返回博客列表后也可发现该文章对应的点赞数发生了变化:
详情页面的按标题搜索展示:
详情页面的按标签搜索展示,点击选择test标签:
点击上方导航栏可进入我的博客列表,在其中会展示当前用户自己写的所有博客,并可点击相关按钮进行对添加文章、删除文章、修改文章、查看文章等操作。
下面展示用户andy的我的博客界面:
点击添加文章按钮可进行添加文章的操作,需要填入文章的标题、标签、正文内容以及选择当前文章是否对全站用户开放。
添加成功后会返回我的博客列表:
对文章的具体操作操作可点击每条记录后的下拉菜单显示:
删除文章操作演示,删除了third这篇文章:
![在这里插入图片描述](https://img-blog.csdnimg.cn/b35d7d23cb36422093eb76624ac88283.png?x-oss-process=image/watermark,type_d3F5LXplbmhlaQ,shadow
_50,text_Q1NETiBAQ0FNbGl2ZQ==,size_20,color_FFFFFF,t_70,g_se,x_16)
修改文章展示:
4.4 数据库相关
全局的表(由于报告时间原因图片未更新,导致comment_comment未显示)
查询数据库中当前存在的用户列表
5 简单的上线部署
本次软件设计的部署我们采用在https://www.pythonanywhere.com/这个网站上经行简单部署。
pythonanywhere为python开发者提供了免费的云端环境(额外功能需付费)。
优点:
简单配置wsgi直接部署web应用
提供MySQL和Postgres
免费账户两个console,我一个Bash,一个MySQL
图形化文件编辑页面
简单够用的web监控面板,显示访问量、日志登服务
计划功能,设置时间,自动执行脚本
简洁、便捷、易用
PythonAnywhere是一个免费的python在线开发环境,可以测试用户的web应用。总部位于伦敦,使用的服务器托管在Amazon的EC2上,十分可靠。
PythonAnywhere允许客户只需编写自己的应用程序,无需配置或维护网络服务器;只要拥有一个浏览器和网络连接,客户就可以随时随地展开部署;并且它能快速安装Django、web2py、Flask和Bottle。
上传代码包:
我们采用先从本地上传到gitee上,在从pythonandywhere clone下来便于多端的同步。
上传后网页文件结构如图所示
虚拟环境搭建
先回到根目录
$ cd ..
创建虚拟环境,python版本为3.8,名称为 blog
$ virtualenv --python=python3.8 blog
激活并进入 blog 环境
激活后会前面有括号和(blog)字样
$ source blog/bin/activate
激活后:(blog) 07:33 ~ $
用pip命令查看该环境下的库,需要安装的用 pip install 安装就行
(blog) 07:33 ~$ pip list
进入到项目目录
(blog) 07:33 ~$ pip install -r requirements.txt
数据库配置
项目部署
创建网络应用
点击Web,选择Add a new web app,选择对话框中manual configuration(注不是“Django”选项):下一步选择Python 3.8(与虚拟环境的python版本相同),然后点击下一步以完成该向导。
Web应用的配置:
配置项目代码
配置虚拟环境
配置静态文件:
最后可通过 blogByAndy.pythonanywhere.com 访问
6 项目总结与反思
在本次项目中,我们主要使用了python对数据库进行操作,总结了一下和django框架下的python相关的ORM语句操作:
假如表结构是这样的:
class User(models.Model):
username = models.CharField(max_length=255, unique=True, verbose_name='用户名')
is_active = models.BooleanField(default=False, verbose_name='激活状态')
那么我们修改用户名和状态可以使用如下两种方法:
方法一:
User.objects.filter(id=1).update(username='nick',is_active=True)
方法二:
_t = User.objects.get(id=1)
_t.username='nick'
_t.is_active=True
_t.save()
方法一适合更新一批数据,类似于mysql语句update user set username=‘nick’ where id = 1
方法二适合更新一条数据,也只能更新一条数据,当只有一条数据更新时推荐使用此方法,另外此方法还有一个好处,我们接着往下看
具有auto_now属性字段的更新
通常会给表添加三个默认字段
自增ID,这个django已经默认加了,就像上边的建表语句,虽然只写了username和is_active两个字段,但表建好后也会有一个默认的自增id字段
创建时间,用来标识这条记录的创建时间,具有auto_now_add属性,创建记录时会自动填充当前时间到此字段
修改时间,用来标识这条记录最后一次的修改时间,具有auto_now属性,当记录发生变化时填充当前时间到此字段
就像下边这样的表结构:
class User(models.Model):
create_time = models.DateTimeField(auto_now_add=True, verbose_name='创建时间')
update_time = models.DateTimeField(auto_now=True, verbose_name='更新时间')
username = models.CharField(max_length=255, unique=True, verbose_name='用户名')
is_active = models.BooleanField(default=False, verbose_name='激活状态')
当表有字段具有auto_now属性且希望他能自动更新时,必须使用上边方法二的更新,不然auto_now字段不会更新,也就是:
_t = User.objects.get(id=1)
_t.username='nick'
_t.is_active=True
_t.save()
json/dict类型数据更新字段
目前主流的web开放方式都讲究前后端分离,分离之后前后端交互的数据格式大都用通用的json型,那么如何用最少的代码方便的更新json格式数据到数据库呢?同样可以使用如下两种方法:
方法一:
data = {'username':'nick','is_active':'0'}
User.objects.filter(id=1).update(**data)
同样这种方法不能自动更新具有auto_now属性字段的值
通常我们再变量前加一个星号(*)表示这个变量是元组/列表,加两个星号表示这个参数是字典
方法二:
data = {'username':'nick','is_active':'0'}
_t = User.objects.get(id=1)
_t.__dict__.update(**data)
_t.save()
方法二和方法一同样无法自动更新auto_now字段的值
注意这里使用到了一个dict方法
方法三:
_t = User.objects.get(id=1)
_t.role=Role.objects.get(id=3)
_t.save()
ForeignKey字段更新
假如我们的表中有Foreignkey外键时,该如何更新呢?
class User(models.Model):
create_time = models.DateTimeField(auto_now_add=True, verbose_name='创建时间')
update_time = models.DateTimeField(auto_now=True, verbose_name='更新时间')
username = models.CharField(max_length=255, unique=True, verbose_name='用户名')
is_active = models.BooleanField(default=False, verbose_name='激活状态')
role = models.ForeignKey(Role, on_delete=models.CASCADE, null=True, verbose_name='角色')
方法一:
User.objects.filter(id=1).update(role=2)
最简单的方法,直接让给role字段设置为一个id即可
当然也可以用dict作为参数更新:
User.objects.filter(id=1).update(**{'username':'nick','role':3})
方法二:
_role = Role.objects.get(id=2)
User.objects.filter(id=1).update(role=_role)
也可以赋值一个实例给role
当然也可以用dict作为参数更新:
_role = Role.objects.get(id=1)
User.objects.filter(id=1).update(**{‘username’:‘nick’,‘role’:_role})
方法三:
_t = User.objects.get(id=1)
_t.role=Role.objects.get(id=3)
_t.save()
注意:这里的role必须赋值为一个对象,不能写id,不然会报错"User.role" must be a “Role” instance
当使用dict作为参数更新时又有一点不同,如下代码:
_t = User.objects.get(id=1)
_t.__dict__.update(**{'username':'nick','role_id':2})
_t.save()
Foreignkey外键必须加上_id
,例如:{‘role_id’:3}
role_id后边必须跟一个id(int或str类型都可),不能跟role实例
ManyToManyField字段更新
假如表中有ManyToManyField字段时更新又有什么影响呢?
class User(models.Model):
create_time = models.DateTimeField(auto_now_add=True, verbose_name='创建时间')
update_time = models.DateTimeField(auto_now=True, verbose_name='更新时间')
username = models.CharField(max_length=255, unique=True, verbose_name='用户名')
is_active = models.BooleanField(default=False, verbose_name='激活状态')
role = models.ForeignKey(Role, on_delete=models.CASCADE, null=True, verbose_name='角色')
groups = models.ManyToManyField(Group, null=True, verbose_name='组')
m2m更新:m2m字段没有直接更新的方法,只能通过清空再添加的方法更新:
_t = User.objects.get(id=1)
_t.groups.clear()
_t.groups.add(*[1,3,5])
_t.save()
add():m2m字段添加一个值,当有多个值的时候可用列表,参照上边例子
_t.groups.add(2)
_t.groups.add(Group.objects.get(id=2))
remove():m2m字段移除一个值,,当有多个值的时候可用列表,参照上边例子
_t.groups.remove(2)
_t.groups.remove(Group.objects.get(id=2))
clear():清空m2m字段的值
Django model select的各种用法详解
基本操作
# 获取所有数据,对应SQL:select * from User
User.objects.all()
# 匹配,对应SQL:select * from User where name = '运维咖啡吧'
User.objects.filter(name='运维咖啡吧')
# 不匹配,对应SQL:select * from User where name != '运维咖啡吧'
User.objects.exclude(name='运维咖啡吧')
# 获取单条数据(有且仅有一条,id唯一),对应SQL:select * from User where id = 724
User.objects.get(id=123)
常用操作
# 获取总数,对应SQL:select count(1) from User
User.objects.count()
# 获取总数,对应SQL:select count(1) from User where name = '运维咖啡吧'
User.objects.filter(name='运维咖啡吧').count()
# 大于,>,对应SQL:select * from User where id > 724
User.objects.filter(id__gt=724)
# 大于等于,>=,对应SQL:select * from User where id >= 724
User.objects.filter(id__gte=724)
# 小于,<,对应SQL:select * from User where id < 724
User.objects.filter(id__lt=724)
# 小于等于,<=,对应SQL:select * from User where id <= 724
User.objects.filter(id__lte=724)
# 同时大于和小于, 1 < id < 10,对应SQL:select * from User where id > 1 and id < 10
User.objects.filter(id__gt=1, id__lt=10)
# 包含,in,对应SQL:select * from User where id in (11,22,33)
User.objects.filter(id__in=[11, 22, 33])
# 不包含,not in,对应SQL:select * from User where id not in (11,22,33)
User.objects.exclude(id__in=[11, 22, 33])
# 为空:isnull=True,对应SQL:select * from User where pub_date is null
User.objects.filter(pub_date__isnull=True)
# 不为空:isnull=False,对应SQL:select * from User where pub_date is not null
User.objects.filter(pub_date__isnull=True)
# 匹配,like,大小写敏感,对应SQL:select * from User where name like '%sre%',SQL中大小写不敏感
User.objects.filter(name__contains="sre")
# 匹配,like,大小写不敏感,对应SQL:select * from User where name like '%sre%',SQL中大小写不敏感
User.objects.filter(name__icontains="sre")
# 不匹配,大小写敏感,对应SQL:select * from User where name not like '%sre%',SQL中大小写不敏感
User.objects.exclude(name__contains="sre")
# 不匹配,大小写不敏感,对应SQL:select * from User where name not like '%sre%',SQL中大小写不敏感
User.objects.exclude(name__icontains="sre")
# 范围,between and,对应SQL:select * from User where id between 3 and 8
User.objects.filter(id__range=[3, 8])
# 以什么开头,大小写敏感,对应SQL:select * from User where name like 'sh%',SQL中大小写不敏感
User.objects.filter(name__startswith='sre')
# 以什么开头,大小写不敏感,对应SQL:select * from User where name like 'sh%',SQL中大小写不敏感
User.objects.filter(name__istartswith='sre')
# 以什么结尾,大小写敏感,对应SQL:select * from User where name like '%sre',SQL中大小写不敏感
User.objects.filter(name__endswith='sre')
# 以什么结尾,大小写不敏感,对应SQL:select * from User where name like '%sre',SQL中大小写不敏感
User.objects.filter(name__iendswith='sre')
# 排序,order by,正序,对应SQL:select * from User where name = '运维咖啡吧' order by id
User.objects.filter(name='运维咖啡吧').order_by('id')
# 多级排序,order by,先按name进行正序排列,如果name一致则再按照id倒叙排列
User.objects.filter(name='运维咖啡吧').order_by('name','-id')
# 排序,order by,倒序,对应SQL:select * from User where name = '运维咖啡吧' order by id desc
User.objects.filter(name='运维咖啡吧').order_by('-id')
进阶操作
# limit,对应SQL:select * from User limit 3;
User.objects.all()[:3]
# limit,取第三条以后的数据,没有对应的SQL,类似的如:select * from User limit 3,10000000,从第3条开始取数据,取10000000条(10000000大于表中数据条数)
User.objects.all()[3:]
# offset,取出结果的第10-20条数据(不包含10,包含20),也没有对应SQL,参考上边的SQL写法
User.objects.all()[10:20]
# 分组,group by,对应SQL:select username,count(1) from User group by username;
from django.db.models import Count
User.objects.values_list('username').annotate(Count('id'))
# 去重distinct,对应SQL:select distinct(username) from User
User.objects.values('username').distinct().count()
# filter多列、查询多列,对应SQL:select username,fullname from accounts_user
User.objects.values_list('username', 'fullname')
# filter单列、查询单列,正常values_list给出的结果是个列表,里边里边的每条数据对应一个元组,当只查询一列时,可以使用flat标签去掉元组,将每条数据的结果以字符串的形式存储在列表中,从而避免解析元组的麻烦
User.objects.values_list('username', flat=True)
# int字段取最大值、最小值、综合、平均数
from django.db.models import Sum,Count,Max,Min,Avg
User.objects.aggregate(Count(‘id’))
User.objects.aggregate(Sum(‘age’))
时间字段
# 匹配日期,date
User.objects.filter(create_time__date=datetime.date(2018, 8, 1))
User.objects.filter(create_time__date__gt=datetime.date(2018, 8, 2))
# 匹配年,year
User.objects.filter(create_time__year=2018)
User.objects.filter(create_time__year__gte=2018)
# 匹配月,month
User.objects.filter(create_time__month__gt=7)
User.objects.filter(create_time__month__gte=7)
# 匹配日,day
User.objects.filter(create_time__day=8)
User.objects.filter(create_time__day__gte=8)
# 匹配周,week_day
User.objects.filter(create_time__week_day=2)
User.objects.filter(create_time__week_day__gte=2)
# 匹配时,hour
User.objects.filter(create_time__hour=9)
User.objects.filter(create_time__hour__gte=9)
# 匹配分,minute
User.objects.filter(create_time__minute=15)
User.objects.filter(create_time__minute_gt=15)
# 匹配秒,second
User.objects.filter(create_time__second=15)
User.objects.filter(create_time__second__gte=15)
# 按天统计归档
today = datetime.date.today()
select = {'day': connection.ops.date_trunc_sql('day', 'create_time')}
deploy_date_count = Task.objects.filter(
create_time__range=(today - datetime.timedelta(days=7), today)
).extra(select=select).values('day').annotate(number=Count('id'))
Q 的使用
Q对象可以对关键字参数进行封装,从而更好的应用多个查询,可以组合&(and)、|(or)、~(not)操作符。
例如下边的语句
from django.db.models import Q
User.objects.filter(
Q(role__startswith='sre_'),
Q(name='公众号') | Q(name='运维咖啡吧')
)
转换成SQL语句如下:
select * from User where role like 'sre_%' and (name='公众号' or name='运维咖啡吧')
通常更多的时候我们用Q来做搜索逻辑,比如前台搜索框输入一个字符,后台去数据库中检索标题或内容中是否包含
_s = request.GET.get('search')
_t = Blog.objects.all()
if _s:
_t = _t.filter(
Q(title__icontains=_s) |
Q(content__icontains=_s)
)
return _t
外键:ForeignKey
• 表结构:
class Role(models.Model):
name = models.CharField(max_length=16, unique=True)
class User(models.Model):
username = models.EmailField(max_length=255, unique=True)
role = models.ForeignKey(Role, on_delete=models.CASCADE)
• 正向查询:
# 查询用户的角色名
_t = User.objects.get(username='运维咖啡吧')
_t.role.name
• 反向查询:
# 查询角色下包含的所有用户
_t = Role.objects.get(name='Role03')
_t.user_set.all()
• 另一种反向查询的方法:
_t = Role.objects.get(name='Role03')
# 这种方法比上一种_set的方法查询速度要快
User.objects.filter(role=_t)
• 第三种反向查询的方法:
如果外键字段有related_name属性,例如models如下:
class User(models.Model):
username = models.EmailField(max_length=255, unique=True)
role = models.ForeignKey(Role, on_delete=models.CASCADE,related_name='roleUsers')
那么可以直接用related_name属性取到某角色的所有用户
_t = Role.objects.get(name = 'Role03')
_t.roleUsers.all()
M2M:ManyToManyField
• 表结构:
class Group(models.Model):
name = models.CharField(max_length=16, unique=True)
class User(models.Model):
username = models.CharField(max_length=255, unique=True)
groups = models.ManyToManyField(Group, related_name='groupUsers')
• 正向查询:
# 查询用户隶属组
_t = User.objects.get(username = '运维咖啡吧')
_t.groups.all()
• 反向查询:
# 查询组包含用户
_t = Group.objects.get(name = 'groupC')
_t.user_set.all()
同样M2M字段如果有related_name属性,那么可以直接用下边的方式反查
_t = Group.objects.get(name = 'groupC')
_t.groupUsers.all()
get_object_or_404
正常如果我们要去数据库里搜索某一条数据时,通常使用下边的方法:
_t = User.objects.get(id=734)
但当id=724的数据不存在时,程序将会抛出一个错误
abcer.models.DoesNotExist: User matching query does not exist.
为了程序兼容和异常判断,我们可以使用下边两种方式:
• 方式一:get改为filter
_t = User.objects.filter(id=724)
# 取出_t之后再去判断_t是否存在
• 方式二:使用get_object_or_404
from django.shortcuts import get_object_or_404
_t = get_object_or_404(User, id=724)
# get_object_or_404方法,它会先调用django的get方法,如果查询的对象不存在的话,则抛出一个Http404的异常
实现方法类似于下边这样:
from django.http import Http404
try:
_t = User.objects.get(id=724)
except User.DoesNotExist:
raise Http404
get_or_create
顾名思义,查找一个对象如果不存在则创建,如下:
object, created = User.objects.get_or_create(username='运维咖啡吧')
返回一个由object和created组成的元组,其中object就是一个查询到的或者是被创建的对象,created是一个表示是否创建了新对象的布尔值
实现方式类似于下边这样:
try:
object = User.objects.get(username='运维咖啡吧')
created = False
exception User.DoesNoExist:
object = User(username='运维咖啡吧')
object.save()
created = True
returen object, created
执行原生SQL
Django中能用ORM的就用它ORM吧,不建议执行原生SQL,可能会有一些安全问题,如果实在是SQL太复杂ORM实现不了,那就看看下边执行原生SQL的方法,跟直接使用pymysql基本一致了
from django.db import connection
with connection.cursor() as cursor:
cursor.execute('select * from accounts_User')
row = cursor.fetchall()
return row