标签:name expr price django filter 详解 filters class
过滤组件django-filter
官方文档:https://django-filter.readthedocs.io/en/main/
1 安装
pip install django-filter
在django配置文件中注册app
INSTALLED_APPS = [
...
'django_filters', # 需要注册应用,
]
环境需求:
- Python: 3.6, 3.7, 3.8
- Django: 2.2, 3.1, 3.2
- DRF: 3.10+
2 使用
给出一个模型表:
from django.db import models
class Product(models.Model):
name = models.CharField(max_length=255)
price = models.DecimalField(max_digits=5, decimal_places=2)
description = models.TextField()
release_date = models.DateField()
manufacturer = models.ForeignKey(Manufacturer, on_delete=models.CASCADE)
模型表有很多字段,我们想按照价格和日期排序,可以这样做
import django_filters # 导入模块
class ProductFilter(django_filters.FilterSet):
name = django_filters.CharFilter(lookup_expr='iexact')
class Meta:
model = Product
fields = ['price', 'release_date']
django-filter支持跨表操作,也可以使用双下划线查询,这样会使过滤类显得很冗长,但是保持了最大的自定义程度:
class ProductFilter(django_filters.FilterSet):
price = django_filters.NumberFilter()
price__gt = django_filters.NumberFilter(field_name='price', lookup_expr='gt')
price__lt = django_filters.NumberFilter(field_name='price', lookup_expr='lt')
release_year = django_filters.NumberFilter(field_name='release_date', lookup_expr='year')
release_year__gt = django_filters.NumberFilter(field_name='release_date', lookup_expr='year__gt')
release_year__lt = django_filters.NumberFilter(field_name='release_date', lookup_expr='year__lt')
manufacturer__name = django_filters.CharFilter(lookup_expr='icontains')
class Meta:
model = Product
fields = ['price', 'release_date', 'manufacturer']
过滤器有两个主要参数:
- field_name:字段名称,你可以使用django中的双下划线查询语法来使用
- lookup_expr:过滤时的过滤条件,支持双下划线语法
有关双下划线查询,详见这里
字段field_name和lookup_expr一起表示一个完整的Django查找表达式。比如price__gt = django_filters.NumberFilter(field_name='price', lookup_expr='gt')
定义之后,浏览器get请求携带参数price__gt=10
,就会根据price
字段过滤出符合条件价格大于10
的数据。
在Meta类中,model指定要过滤的模型表,fields指定通过哪些字段来过滤。此外,可以使用字典为每个字段指定多个查找表达式:
import django_filters
class ProductFilter(django_filters.FilterSet):
class Meta:
model = Product
fields = {
'price': ['lt', 'gt'],
'release_date': ['exact', 'year__gt'],
}
如果包含外键字段,同样可以使用双下划线语法:
class ProductFilter(django_filters.FilterSet):
class Meta:
model = Product
fields = ['manufacturer__country']
3 drf中使用
在drf中使用过滤:
from django_filters import rest_framework as filters
# 导入并继承FilterSet类
class ProductFilter(filters.FilterSet):
...
你的视图类还需要将DjangoFilterBackend添加到filter_backend中(局部配置)
from django_filters import rest_framework as filters
class ProductList(generics.ListAPIView):
queryset = Product.objects.all()
serializer_class = ProductSerializer
filter_backends = (filters.DjangoFilterBackend,) # 配置filter_backends
filterset_fields = ('category', 'in_stock')
全局配置:
REST_FRAMEWORK = { # 全局配置
...
'DEFAULT_FILTER_BACKENDS': (
'django_filters.rest_framework.DjangoFilterBackend',
),
}
要使用FilterSet过滤,需要将其添加到视图类的filterset_class参数中。
from rest_framework import generics
from django_filters import rest_framework as filters
from myapp import Product
# 定义过滤类
class ProductFilter(filters.FilterSet):
min_price = filters.NumberFilter(field_name="price", lookup_expr='gte')
max_price = filters.NumberFilter(field_name="price", lookup_expr='lte')
class Meta:
model = Product
fields = ['category', 'in_stock'] # 在Meta中指定过滤哪些字段
class ProductList(generics.ListAPIView):
queryset = Product.objects.all()
serializer_class = ProductSerializer
filter_backends = (filters.DjangoFilterBackend,)
filterset_class = ProductFilter # 在filterset_class中,指定要使用的过滤类
由于支持双下划线语法,就可以在过滤类中创建区间过滤。比如ProductFilter中可以定义min_price和max_price,前端传入最小价格和最大价格就可以过滤出相应字段。
标签:name,expr,price,django,filter,详解,filters,class 来源: https://www.cnblogs.com/yyyzyyyz/p/15533452.html
本站声明: 1. iCode9 技术分享网(下文简称本站)提供的所有内容,仅供技术学习、探讨和分享; 2. 关于本站的所有留言、评论、转载及引用,纯属内容发起人的个人观点,与本站观点和立场无关; 3. 关于本站的所有言论和文字,纯属内容发起人的个人观点,与本站观点和立场无关; 4. 本站文章均是网友提供,不完全保证技术分享内容的完整性、准确性、时效性、风险性和版权归属;如您发现该文章侵犯了您的权益,可联系我们第一时间进行删除; 5. 本站为非盈利性的个人网站,所有内容不会用来进行牟利,也不会利用任何形式的广告来间接获益,纯粹是为了广大技术爱好者提供技术内容和技术思想的分享性交流网站。