一. 内置Admin
依赖APP：
django.contrib.auth
django.contrib.contenttypes
django.contrib.messages
django.contrib.sessions 模板的context_processors：
django.contrib.auth.context_processors.auth
django.contrib.messages.context_processors.messages 中间件：
django.contrib.auth.middleware.AuthenticationMiddleware
django.contrib.messages.middleware.MessageMiddleware
Django Admin内部依赖的
1.配置路由
urlpatterns = [
url(r'^admin/', admin.site.urls),
]
/admin/
/admin/login/
/admin/logout/
/admin/password_change/
/admin/password_change/done/ /admin/app名称/model名称/
/admin/app名称/model名称/add/
/admin/app名称/model名称/ID值/history/
/admin/app名称/model名称/ID值/change/
/admin/app名称/model名称/ID值/delete/
当前配置的路由可以创建一些路由映射关系
2.定制Admin
在admin.py中只需要将Model中的某个类注册, 即可在Admin中实现增删改查的功能,
admin.site.register(models.UserInfo)
但是，这种方式比较简单，如果想要进行更多的定制操作，需要利用ModelAdmin进行操作，如：
方式一：
class UserAdmin(admin.ModelAdmin):
list_display = ('user', 'pwd',)
admin.site.register(models.UserInfo, UserAdmin) # 第一个参数可以是列表
方式二：
@admin.register(models.UserInfo) # 第一个参数可以是列表
class UserAdmin(admin.ModelAdmin):
list_display = ('user', 'pwd',)
ModelAdmin中提供了大量的可定制功能，如
1. list_display，列表时，定制显示的列。
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
list_display = ('user', 'pwd', 'xxxxx')
def xxxxx(self, obj):
return "xxxxx"
2. list_display_links，列表时，定制列可以点击跳转。
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
list_display = ('user', 'pwd', 'xxxxx')
list_display_links = ('pwd',)
3. list_filter，列表时，定制右侧快速筛选。
from django.utils.translation import ugettext_lazy as _
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
list_display = ('user', 'pwd')
class Ugg(admin.SimpleListFilter):
title = _('decade born')
parameter_name = 'xxxxxx'
def lookups(self, request, model_admin):
"""
显示筛选选项
:param request:
:param model_admin:
:return:
"""
return models.UserGroup.objects.values_list('id', 'title')
def queryset(self, request, queryset):
"""
点击查询时，进行筛选
:param request:
:param queryset:
:return:
"""
v = self.value()
return queryset.filter(ug=v)
list_filter = ('user',Ugg,)
4. list_select_related，列表时，连表查询是否自动select_related
5. 分页相关
# 分页，每页显示条数
list_per_page = 100
# 分页，显示全部（真实数据<该值时，才会有显示全部）
list_max_show_all = 200
# 分页插件
paginator = Paginator
6. list_editable，列表时，可以编辑的列
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
list_display = ('user', 'pwd','ug',)
list_editable = ('ug',)
7. search_fields，列表时，模糊搜索的功能
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
search_fields = ('user', 'pwd')
8. date_hierarchy，列表时，对Date和DateTime类型进行搜索
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
date_hierarchy = 'ctime'
9. preserve_filters，详细页面，删除、修改，更新后跳转回列表后，是否保留原搜索条件
10. save_as = False，详细页面，按钮为“Sava as new” 或 “Sava and add another”
11. save_as_continue = True，点击保存并继续编辑
save_as_continue = True
# 如果 save_as=True，save_as_continue = True， 点击Sava as new 按钮后继续编辑。
# 如果 save_as=True，save_as_continue = False，点击Sava as new 按钮后返回列表。
New in Django 1.10.
12. save_on_top = False，详细页面，在页面上方是否也显示保存删除等按钮
13. inlines，详细页面，如果有其他表和当前表做FK，那么详细页面可以进行动态增加和删除
class UserInfoInline(admin.StackedInline): # TabularInline
extra = 0
model = models.UserInfo
class GroupAdminMode(admin.ModelAdmin):
list_display = ('id', 'title',)
inlines = [UserInfoInline, ]
14. action，列表时，定制action中的操作
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
# 定制Action行为具体方法
def func(self, request, queryset):
print(self, request, queryset)
print(request.POST.getlist('_selected_action'))
func.short_description = "中文显示自定义Actions"
actions = [func, ]
# Action选项都是在页面上方显示
actions_on_top = True
# Action选项都是在页面下方显示
actions_on_bottom = False
# 是否显示选择个数
actions_selection_counter = True
15. 定制HTML模板
add_form_template = None
change_form_template = None
change_list_template = None
delete_confirmation_template = None
delete_selected_confirmation_template = None
object_history_template = None
16. raw_id_fields，详细页面，针对FK和M2M字段变成以Input框形式
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
raw_id_fields = ('FK字段', 'M2M字段',)
17. fields，详细页面时，显示字段的字段
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
fields = ('user',)
18. exclude，详细页面时，排除的字段
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
exclude = ('user',)
19. readonly_fields，详细页面时，只读字段
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
readonly_fields = ('user',)
20. fieldsets，详细页面时，使用fieldsets标签对数据进行分割显示
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
fieldsets = (
('基本数据', {
'fields': ('user', 'pwd', 'ctime',)
}),
('其他', {
'classes': ('collapse', 'wide', 'extrapretty'), # 'collapse','wide', 'extrapretty'
'fields': ('user', 'pwd'),
}),
)
21. 详细页面时，M2M显示时，数据移动选择（方向：上下和左右）
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
filter_vertical = ("m2m字段",) # 或filter_horizontal = ("m2m字段",)
22. ordering，列表时，数据排序规则
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
ordering = ('-id',)
或
def get_ordering(self, request):
return ['-id', ]
23. view_on_site，编辑时，是否在页面上显示view on set
view_on_site = False
或
def view_on_site(self, obj):
return 'https://www.baidu.com'
24. radio_fields，详细页面时，使用radio显示选项（FK默认使用select）
radio_fields = {"ug": admin.VERTICAL} # 或admin.HORIZONTAL
25. show_full_result_count = True，列表时，模糊搜索后面显示的数据个数样式
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
# show_full_result_count = True # 1 result (12 total)
# show_full_result_count = False # 1 result (Show all)
search_fields = ('user',)
26. formfield_overrides = {}，详细页面时，指定现实插件
from django.forms import widgets
from django.utils.html import format_htm
class MyTextarea(widgets.Widget):
def __init__(self, attrs=None):
# Use slightly better defaults than HTML's 20x2 box
default_attrs = {'cols': '', 'rows': ''}
if attrs:
default_attrs.update(attrs)
super(MyTextarea, self).__init__(default_attrs)
def render(self, name, value, attrs=None):
if value is None:
value = ''
final_attrs = self.build_attrs(attrs, name=name)
return format_html('<textarea {}>\r\n{}</textarea>',final_attrs, value
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
formfield_overrides = {
models.models.CharField: {'widget': MyTextarea},
}
27. prepopulated_fields = {}，添加页面，当在某字段填入值后，自动会将值填充到指定字段。
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
prepopulated_fields = {"email": ("user","pwd",)}
PS: DjangoAdmin中使用js实现功能，页面email字段的值会在输入：user、pwd时自动填充
28. form = ModelForm，用于定制用户请求时候表单验证
from app01 import models
from django.forms import ModelForm
from django.forms import fields
class MyForm(ModelForm):
others = fields.CharField()
class Meta:
model = models = models.UserInfo
fields = "__all__"
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
form = MyForm
29. empty_value_display = "列数据为空时，显示默认值"
@admin.register(models.UserInfo)
class UserAdmin(admin.ModelAdmin):
empty_value_display = "列数据为空时，默认显示"
list_display = ('user','pwd','up')
def up(self,obj):
return obj.user
up.empty_value_display = "指定列数据为空时，默认显示"
ModelAdmin 可定制功能
二. 字段和字段的参数
常用的字段
from django.db import models
class Person(models.Model):
first_name = models.CharField(max_length=30)
last_name = models.CharField(max_length=30)
AutoField 自增的整形字段, 必填 primary_key=True, 则成为数据库的主键, 无该字段时, django自动创建, 一个model不能有两个AutoField字段
integerField 一个整数类型, 数值的范围是 -2147483648 ~ 2147483647
BooleanField 布尔值类型
CharField 字符类型, 必须提供max_length参数, max_length表示字符的长度
TextField 文本类型
DateTimeField 日期时间字段, 格式为 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ]，相当于Python中的datetime.datetime的实例。
DecimalField 十进制小数
AutoField(Field)
- int自增列，必须填入参数 primary_key=True BigAutoField(AutoField)
- bigint自增列，必须填入参数 primary_key=True 注：当model中如果没有自增列，则自动会创建一个列名为id的列
from django.db import models class UserInfo(models.Model):
# 自动创建一个列名为id的且为自增的整数列
username = models.CharField(max_length=32) class Group(models.Model):
# 自定义自增列
nid = models.AutoField(primary_key=True)
name = models.CharField(max_length=32) SmallIntegerField(IntegerField):
- 小整数 -32768 ～ 32767 PositiveSmallIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
- 正小整数 0 ～ 32767 IntegerField(Field)
- 整数列(有符号的) -2147483648 ～ 2147483647 PositiveIntegerField(PositiveIntegerRelDbTypeMixin, IntegerField)
- 正整数 0 ～ 2147483647 BigIntegerField(IntegerField):
- 长整型(有符号的) -9223372036854775808 ～ 9223372036854775807 BooleanField(Field)
- 布尔值类型 NullBooleanField(Field):
- 可以为空的布尔值 CharField(Field)
- 字符类型
- 必须提供max_length参数， max_length表示字符长度 TextField(Field)
- 文本类型 EmailField(CharField)：
- 字符串类型，Django Admin以及ModelForm中提供验证机制 IPAddressField(Field)
- 字符串类型，Django Admin以及ModelForm中提供验证 IPV4 机制 GenericIPAddressField(Field)
- 字符串类型，Django Admin以及ModelForm中提供验证 Ipv4和Ipv6
- 参数：
protocol，用于指定Ipv4或Ipv6， 'both',"ipv4","ipv6"
unpack_ipv4， 如果指定为True，则输入::ffff:192.0.2.1时候，可解析为192.0.2.1，开启此功能，需要protocol="both" URLField(CharField)
- 字符串类型，Django Admin以及ModelForm中提供验证 URL SlugField(CharField)
- 字符串类型，Django Admin以及ModelForm中提供验证支持 字母、数字、下划线、连接符（减号） CommaSeparatedIntegerField(CharField)
- 字符串类型，格式必须为逗号分割的数字 UUIDField(Field)
- 字符串类型，Django Admin以及ModelForm中提供对UUID格式的验证 FilePathField(Field)
- 字符串，Django Admin以及ModelForm中提供读取文件夹下文件的功能
- 参数：
path, 文件夹路径
match=None, 正则匹配
recursive=False, 递归下面的文件夹
allow_files=True, 允许文件
allow_folders=False, 允许文件夹 FileField(Field)
- 字符串，路径保存在数据库，文件上传到指定目录
- 参数：
upload_to = "" 上传文件的保存路径
storage = None 存储组件，默认django.core.files.storage.FileSystemStorage ImageField(FileField)
- 字符串，路径保存在数据库，文件上传到指定目录
- 参数：
upload_to = "" 上传文件的保存路径
storage = None 存储组件，默认django.core.files.storage.FileSystemStorage
width_field=None, 上传图片的高度保存的数据库字段名（字符串）
height_field=None 上传图片的宽度保存的数据库字段名（字符串） DateTimeField(DateField)
- 日期+时间格式 YYYY-MM-DD HH:MM[:ss[.uuuuuu]][TZ] DateField(DateTimeCheckMixin, Field)
- 日期格式 YYYY-MM-DD TimeField(DateTimeCheckMixin, Field)
- 时间格式 HH:MM[:ss[.uuuuuu]] DurationField(Field)
- 长整数，时间间隔，数据库中按照bigint存储，ORM中获取的值为datetime.timedelta类型 FloatField(Field)
- 浮点型 DecimalField(Field)
- 10进制小数
- 参数：
max_digits，小数总长度
decimal_places，小数位长度 BinaryField(Field)
- 二进制类型
更多字段类型
三. 查询的方法(13个)
返回对象是对象列表的: all(), filter(), exclude(), order_by(), reverse(), values(), values_list(), distinct()
返回结果是对象: get(), first(), last()
返回结果是布尔值: exists()
count(): 返回数字
import os
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "course_select.settings.py")
import django
django.setup()
from cou_sele import models models.Classes.objects.all() #获取所有的数据 对象列表
models.Classes.objects.filter(id=1) #获所有满足条件的所有对象
models.Classes.objects.get(id=1) #获取满足条件的一个对象,没有或者是多个报错
models.Classes.objects.exclude(id=1) #获所有不满足条件的所有对象
models.Classes.objects.values('name','id') #[{},{}]1.不指定字段名,获取对象的字段名和值名和值 2,指定字段名 获取指定字段的名和值
models.Classes.objects.values_list() #[{},{}] 1.不指定字段名,获取所有字段的值, 2.指定字段名,获取指定字段值
models.Classes.objects.all().order_by('age','-id') #order_by 排序 默认升序,加 - 降序 指定多个进行排序
models.Classes.objects.all().order_by('age','-id').reverse()#给已经排好序的结果倒叙排序, 翻转
models.Classes.objects.all().distinct()#去重
models.Classes.objects.all().count() #计数
models.Classes.objects.filter(id=100).first() #取第一个
models.Classes.objects.filter(id=1).last() #取最后一个
models.Classes.objects.filter(id=1).exists() #判断数据是否存在
四. 单表的双下划线
import os
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "orm_practice.settings")
import django
django.setup()
from app01 import models ret = models.Person.objects.filter(id=1)
ret = models.Person.objects.filter(id__gt=1) # greater than 大于
ret = models.Person.objects.filter(id__gte=1) # greater than equal 大于等于
ret = models.Person.objects.filter(id__lt=3) # less than 小于
ret = models.Person.objects.filter(id__lte=3) # less than equal 小于等于 ret = models.Person.objects.filter(id__gt=1, id__lt=3) 大于1,小于3
ret = models.Person.objects.filter(id__range=[1, 3]) # 范围 左右都包含
ret = models.Person.objects.filter(id__in=[1, 3]) # ret = models.Person.objects.filter(name__contains='alex') # 包含 like
ret = models.Person.objects.filter(name__icontains='alex') # 包含 like ret = models.Person.objects.filter(name__startswith='a') # 以什么开头
ret = models.Person.objects.filter(name__istartswith='a') # 以什么开头 忽略大小写 ret = models.Person.objects.filter(name__endswith='x') # 以什么结尾
ret = models.Person.objects.filter(name__iendswith='X') # 以什么结尾 忽略大小写 ret = models.Person.objects.filter(birth__year=2018)
ret = models.Person.objects.filter(birth__contains='2018-12')
五. 外键的操作
设置外键
from django.db import models class Classes(models.Model):
cid = models.AutoField(primary_key=True) #设置主键 不为空且唯一
name = models.CharField(max_length=32,unique=True) #唯一
def __str__(self):
return self.name
class Student(models.Model):
name = models.CharField(max_length=32, unique=True)
classes = models.ForeignKey('Classes', on_delete=models.CASCADE) #设置外键, 关联Classes
import os
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "orm_practice.settings")
import django
django.setup()
from cou_sele import models #基于对象的查询
#正向
book_obj = models.Book.objects.get(id=1)
book_obj.id #获取id
book_obj.publisher #关联的对象
book_obj.publisher.id #关联的对象的id
#反向查询
pub_obj = models.Publisher.objects.get(id=1)
pub_obj.book_set.all() #查询出出版社出版的所有书籍
#指定book表中, related_name='books'
pub_obj.books.all() # 基于字段的查询
ret = models.Book.objects.filter(publisher__name='xxx')
# 不指定related_name
ret = models.Publisher.objects.filter(book_title='XXX')
# 指定related_name
ret = models.Publisher.objects.filter(books_title='xxx') # 外键字段可以为null 才有remove和clear 只能写对象
pub_obj = models.Publisher.objects.get(id=1)
pub_obj.books.remove(models.Publisher.objects.get(id=1))
pub_obj.books.clrar()
六. 多对多的操作
models中创建多对多的关系
class Classes(models.Model):
cid = models.AutoField(primary_key=True) #设置主键 不为空且唯一
name = models.CharField(max_length=32,unique=True) #唯一
def __str__(self):
return self.name
class Student(models.Model):
name = models.CharField(max_length=32, unique=True)
classes = models.ForeignKey('Classes', on_delete=models.CASCADE) #设置外键, 关联Classes class Teacher(models.Model):
name = models.CharField(max_length=32, unique=True) # 唯一
Student = models.ManyToManyField('Student')
import os
os.environ.setdefault("DJANGO_SETTINGS_MODULE", "orm_practice.settings")
import django
django.setup()
from cou_sele import models #基于对象的查询
#正向
author_obj = models.Author.objects.get(id=2)
author_obj.books.all()
#反向
book_obj = models.Book.objects.get(id=1)
#不指定related_name='authors'
book_obj.author_set.all()
#指定related_name='authors'
book_obj.authors.all() #set 设置多对多关系
author_obj.books.set([])
author_obj.books.set([1,2,3]) #要关联对象的ID [ 对象的id，对象的id]
author_obj.books.set(models.Book.objects.all()) # 要关联对象 [ 对象，对象] # add 添加多对多的关系
author_obj.books.add(1) #要关联对象的ID
author_obj.books.add(models.Book.objects.get(id=2)) #要关联的对象 #remove() 删除多对多的关系
author_obj.books.remove(1) #关联对象的ID
author_obj.books.remove(models.Book.objects.get(id=2)) #关联的对象 # clear() 清空当前对象的多对多的关系
author_obj.books.clear() # create() 创建
author_obj.books.create(title='xxx')