一. 内置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
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': '40', 'rows': '10'} 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 {}> {}</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 = "指定列数据为空时，默认显示"
二. 字段和字段的参数
常用的字段
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')