程序師世界是廣大編程愛好者互助、分享、學習的平台,程序師世界有你更精彩!
首頁
編程語言
C語言|JAVA編程
Python編程
網頁編程
ASP編程|PHP編程
JSP編程
數據庫知識
MYSQL數據庫|SqlServer數據庫
Oracle數據庫|DB2數據庫
您现在的位置: 程式師世界 >> 編程語言 >  >> 更多編程語言 >> Python

django-rest-framework——過濾、搜索、排序、分頁

編輯:Python

一、過濾 filter

django-filter庫包括一個DjangoFilterBackend類,它支持REST框架的高度可定制的字段過濾。
首先安裝django-filter, 然後將django_filters添加到Django的INSTALLED_APPS。
可以設置默認返回,在settings.py加上如下配置:

REST_FRAMEWORK = {
'DEFAULT_FILTER_BACKENDS': ('django_filters.rest_framework.DjangoFilterBackend',)
}

或者將過濾器加到單個View或ViewSet中(一般使用這種):

from django_filters.rest_framework import DjangoFilterBackend
from rest_framework.viewsets import ModelViewSet
class UserListView(ModelViewSet):
...
filter_backends = (DjangoFilterBackend,)

如果要允許對某些字段進行過濾,可以使用filter_fields屬性

from rest_framework.viewsets import ModelViewSet
from django_filters.rest_framework import DjangoFilterBackend
from myapp.models import Product
from myapp.serializers impoert ProductSerializer
class ProductList(ModelViewSet):
queryset = Product.objects.all()
serializer_class = ProductSerializer
filter_backends = (DjangoFilterBackend,)
filter_fields = ('category', 'in_stock')
# filter_class = ProductFilter (指定過濾集合類)

還可以自定義過濾類,再用filter_class指定過濾集合類

import django_filters
from myapp.models import Product
from rest_framework import filters
class ProductFilter(filters.FilterSet):
min_price = django_filters.NumberFilter(name=’price’, lookup_type=”gte”)
max_price = django_filters.NumberFilter(name=’price’, lookup_type=”lte”)
# 行為: 名稱中包含某字符,且字符不區分大小寫
name = filters.CharFilter(name='name', lookup_expr='icontains')
class Meta:
model = Product
fields = [‘category’, ‘in_stock’, ‘min_price’, ‘max_price’]

二、搜索 search

如果要明確指定可以對哪些字段進行搜索,可以使用search_fields屬性,默認為可以對serializer_class屬性指定的串行器上的任何可讀字段進行搜索:

from django.contrib.auth.models import User
from rest_framework import viewsets
from core.serializers import UserSerializer
from rest_framework import filters
class UserListView(viewsets.ModelViewSet):
queryset = User.objects.all()
serializer_class = UserSerializer
filter_backends = (filters.SearchFilter,)
search_fields = ('username', 'email')

也可以使用雙下劃線在Foreign Key或ManyToManyField上執行相關查找:

search_fields = ('username', 'email', 'profile__profession')

三,排序 order

OrderingFilter類支持簡單的查詢參數控制結果排序。
默認情況下,查詢參數被命名為“ordering”,但這可能會被ORDERING_PARAM設置覆蓋。
可以使用ordering_fields屬性明確指定可以對哪些字段執行排序,這有助於防止意外的數據洩露,例如允許用戶對密碼散列字段或其他敏感數據進行排序。
如果不指定ordering_fields屬性,則默認為可以對serializer_class屬性指定的串行器上的任何可讀字段進行過濾。

from django.contrib.auth.models import User
from rest_framework import viewsets
from core.serializers import UserSerializer
from rest_framework import filters
class UserListView(viewsets.ModelViewSet):
queryset = User.objects.all()
serializer_class = UserSerializer
filter_backends = (filters.OrderingFilter,)
ordering_fields = ('username', 'email')

使用ordering屬性設置默認排序(加"-"減號可以倒敘):
ordering = (’-id’,)

四、分頁 pagination

可以直接在view.py中自定義分頁規則

from rest_framework.pagination import PageNumberPagination
class StandardResultsSetPagination(PageNumberPagination):
"""
配置分頁規則
"""
page_size = 12
page__size_query_param = 'page_size'
page_query_param = 'page'
max_page_size = 100

應用到視圖函數中:

class UserListView(viewsets.ModelViewSet):
....
pagination_class = StandardResultsSetPagination
....

可以setting全局設置:

REST_FRAMEWORK = {
'DEFAULT_PAGINATION_CLASS': 'rest_framework.pagination.PageNumberPagination'
}
  • PageNumberPagination類包括可以覆蓋以修改分頁樣式的許多屬性,要設置這些屬性,應覆蓋PageNumberPagination類,然後如上所示啟用自定義分頁類。

  • django_paginator_class:使用的Django
    Paginator類,默認是django.core.paginator.Paginator,對大部分用例是適用的。

  • page_size:數值,頁面大小,默認是全局PAGE_SIZE的值。

  • page_query_param:字符串,查詢參數的名稱,默認是’page’

  • page_size_query_param:字符串,請求設置頁面大小的參數名稱,默- 認是None,表示客戶端可能無法控制請求的頁面大小。

  • max_page_size:字符串,最大允許請求的頁面大小, 此屬性僅在page_size_query_param也被設置時有效。

  • last_page_strings:字符串列表或者元組,默認是(‘last’,)

  • template:分頁控件使用的模板的名稱,可以覆蓋或設置為None,默認為"rest_framework/pagination/numbers.html"


  1. 上一篇文章:
  2. 下一篇文章:
Copyright © 程式師世界 All Rights Reserved