djangp-filter的使用

目录

• Filter定义
  • • • 这个类解释如下：
      • 值得注意的是django_filters如何只指定fields，不指定特定fields的过滤方法， 那么默认会使用exact的过滤条件进行查询。
      • 在view中的使用
      • 多表查询
      • model定义
      • 问题： 如何使用书本的书名和isbn信息来查询本地图书馆的藏书信息？
      • Fileter定义
      • View使用
      • POST 数据定义

Filter定义

定义如下Filter类

class BookFilter(django_filters.FilterSet):
    name = django_filters.CharFilter(lookup_expr='icontains')
    author = django_filters.CharFilter(lookup_expr='icontains')
    isbn = django_filters.NumberFilter(lookup_expr='icontains')
    press = django_filters.CharFilter(lookup_expr='icontains')

    class Meta:
        model = Book
        fields = {'name', 'author', 'isbn', 'press'}

这个类解释如下：

model 该类是为Model Book定义的过滤类
fields 该过滤类可以处理Book model中字段name，author，isbn，press的查询
name = django_filters.CharFilter(lookup_expr='icontains') 指定name字段的过滤条件为icontains

值得注意的是django_filters如何只指定fields，不指定特定fields的过滤方法， 那么默认会使用exact的过滤条件进行查询。

在view中的使用

# filter objects according to user inputs
objects = BookFilter(request.POST, queryset=objects)

recordsFiltered = objects.qs.count()
objects = objects.qs[start:(start + length)]

在官网的介绍当中，使用的比较多场景是使用过滤器的返回值作为参数去渲染模板文件。那如果需要后端进行分页处理， 就需要使用返回值的qs属性呢
比如示例当中的 recordsFiltered = objects.qs.count()， 将查询得到的query set的记录个数返回给前端Datatable插件。

多表查询

单表查询比较容易理解， 那么当我们需要使用多表查询的时候， 该怎么做呢？

model定义

class Book(models.Model):
    name = models.CharField(max_length=48)
    isbn = models.IntegerField(primary_key=True, unique=True)
    author = models.CharField(max_length=24)
    press = models.CharField(max_length=48)
    price = models.PositiveIntegerField(default=0)

class LibBook(models.Model):
    # Relations
    book = models.ForeignKey(Book, on_delete=models.PROTECT,null=False)
    # Attributes
   
    uuid = models.UUIDField(default=uuid.uuid4, null=False)
    inDate = models.DateField(auto_now_add=True)
    dueDate = models.DateField(blank=True, null=True)
    overDays = models.PositiveIntegerField(default=0)
    LendAmount = models.PositiveIntegerField(default=0)

在这个例子当中，书本信息和馆藏图书是一对多的关系，我们在LibBook当中使用ForeignKey来指定LibBook和Book之间的关系。

问题： 如何使用书本的书名和isbn信息来查询本地图书馆的藏书信息？

Fileter定义

class LibBookFilter(django_filters.FilterSet):
    book__name = django_filters.CharFilter(lookup_expr='icontains')
    book__isbn = django_filters.NumberFilter(lookup_expr='icontains')

    class Meta:
        model = LibBook
        fields = {'book__name', 'book__isbn'}

值得注意的是fields的定义， 要使用Django中规定的双下划线符号__来指定查询的字段。
在本例中， 我们同样指定查询的条件是icontains

View使用

# filter objects according to user inputs
objects = LibBookFilter(request.POST, queryset=objects)
recordsFiltered = objects.qs.count()
objects = objects.qs[start:(start + length)]

看到这里，感觉和单表查询也差不了太多啊。 在笔者使用django_filters的过程中，最大的坑就是在这里呢， 怎么设置都不好使。后来发现问题是：

POST 数据定义

前端同样使用ajax将查询数据通过POST传到后台。 ajax的data必须如下定义，django_filters才能正常工作。

"ajax": {
    "url": "#",
    "type": "POST",
    "data": function(d){
        return $.extend( {}, d, {
            "book__isbn"  : document.getElementById('isbn').value,
            "book__name"  : document.getElementById('book').value,
            });
    }
},

注意POST数据的数据名字必须和Filter中保持一致才行

注意需在settings中添加配置：

INSTALLED_APPS = [ 
‘django_filters’ 
]

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