玩转Django开发，你需要的一个插件

原创

qq57bc69vq20h372 2021-07-22 11:14:16 ©著作权

文章标签 编程 文章分类 代码人生

©著作权归作者所有：来自51CTO博客作者qq57bc69vq20h372的原创作品，请联系作者获取转载授权，否则将追究法律责任

玩转Django开发，你需要的一个插件_编程

看朋友圈今天算是所有的小伙伴都回来工作了，我们从今天开始回到Python开发技术的正题，毕竟这才是我们吃饭的家伙。

今天我们聊一个我日常开发常用到的一个包名叫Django-filter，这个包对于我们日常Django开发工作的筛选开发非常方便，只需要配置几行代码就能完成我们复杂的筛选。

我在前面介绍Swagger一文「超好用的API工具-Swagger」的时候提到过它，尤其是对于XXX系统管理页面处理起来简直不要太方便，下面且听我细细道来。

安装配置

这个工具安装很简单通过pip就进行

pip install django-filter

这里要说明下这里安装的最新的django-filter，默认新版本是要求Python3的，如果我们环境是Python2.7的需要安装django-filter 1.1.0版本的，另外这个包依赖djangorestframework框架，下面我简称DRF。

安装完，我们添加进INSTALLED_APPS

# settings.py
INSTALLED_APPS = [
    ...
    'rest_framework',
    'django_filters',
]

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

这里把django-filter作为默认的backends，也可以在viewset里面写，见下文。

使用

使用的时候我们需要创建一个FilterSet类来进行过滤筛选，废话不多说，我们看一个代码。

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', 'min_price', 'max_price']

上面这个代码展示了我们价格范围过滤，实际中我们还可以有更多筛选展示方式，

class ProductFilter(django_filters.rest_framework.FilterSet):

    class Meta:
        model = Product
        fields = {
            'order_id': ['exact'],
            'status': ['in'],
            'created_at': ['range'],
            'card__company_name': ['contains'],
            'card__email': ['exact'],
        }


class ProductList(generics.ListAPIView):
    queryset = Product.objects.all()
    serializer_class = ProductSerializer
    filter_backends = (filters.DjangoFilterBackend,) # 这儿我们settings配置了就不需要配置了
    # filterset_class = ProductFilter # django-filter 2.1，python3
    filter_class = ProductFilter # django-filter 1.1， python2.7

上面我从时间范围选择，精确筛选，包含等几个维度展示了django-filter筛选的情况，满足绝大多数筛选情况了，另外我标注了filterset_class写法是在Django-filter 1.1之后，filter_class写法是在1.1之前版本，这里大家需要注意一下。