Django中django-filter插件与普通查询对比及实现
发布时间：2026-10-13| 4人浏览过
本文对比了Django中直接使用Q对象进行条件查询与使用django-filter插件生成动态查询界面的两种方法。通过展示filter.py配置、widget样式设置及前端form渲染，详解如何利用django-filter自动生成文本框、下拉框等查询控件，提升开发效率。
Django数据查询方法概述
在Python开发中，尤其是Django框架的数据查询环节，可用的插件资源十分丰富。近期发现一个名为django-filter的插件，其功能实用且易于集成。
基础直接查询方式
首先介绍最基础的方式：直接根据指定条件执行数据库查询。
def search(request):
request.encoding = 'utf-8'
if 'platform_order_code' in request.POST:
code = request.POST['platform_order_code']
q1 = Q(code__contain=code)
sale_orders = SaleOrder.objects.filter(q1)
response = TemplateResponse(request, 'ofc/saleorder_manage.html',
{
"savorier": sale_orders,
})
return response
django-filter插件应用
其次，使用django-filter插件可以根据filter中定义的查询条件，自动在前端生成对应的查询对话框、文本输入框以及下拉选择框等交互组件。
相关安装指南可参考官方文档：https://django-filter.readthedocs.io/en/master/guide/install.html
def query_saleorder(request):
today = datetime.datetime.now()
start_today = datetime.datetime(today.year, today.month, today.day, 0, 0, 0)
sale_orders = SaleOrder.objects.filter(create_time__gt=start_today)
my_param = request.GET.get('status')
# 如果有参数，则从所有订单中筛选
if(my_param):
filter = SaleOrderFilter(request.GET, queryset=SaleOrder.objects.all())
# 如果没有参数的，则默认查询今天的
else:
filter = SaleOrderFilter(request.GET, queryset=sale_orders)
# filter = SaleOrderFilter(request.GET, queryset=SaleOrder.objects.all())
menus = SysPermission.objects.using("DB2").filter(level=1)[0:5]
return render(request, 'ofc/list.html', {'filter': filter, "menus": menus})Filter配置与前端交互
接下来处理filter.py文件中的具体逻辑配置。
可以通过widget参数为生成的各个查询控件添加CSS类名或其他样式属性。
import django_filters
from django import forms
from django.db.models import Q
from ofc.enum import STATUS_ENUM
from ofc.models import SaleOrder
from ofc.utils import code_select, date_divide
class SaleOrderFilter(django_filters.FilterSet):
def select_code(queryset, name, value):
print(name)
return code_select(value)
def select_date(queryset, name, value):
create_time = date_divide(value)
date_start = create_time['start_time']
date_end = create_time['end_time']
# 在已经查出来的其他参数的基础上增加查询条件
return queryset.filter(create_time__gt=date_start, create_time__lt=date_end)
class Meta:
model = SaleOrder
fields = {'status': ['exact'],
'code': [],
'create_time': [],
}
create_time = django_filters.CharFilter(method='select_date',
widget=forms.TextInput(attrs={'class': 'form-control daterange-time',
'name': 'date',
}))
status = django_filters.ChoiceFilter(choices=STATUS_ENUM,
widget=forms.Select(attrs={'class': 'select',
'name': 'status',
'data-width': '100%'}))
code = django_filters.CharFilter(method='select_code', name='code',
widget=forms.TextInput(attrs={'name': 'platform_order_code',
'class': 'form-control',
'placeholder': '订单号'}))
以下是前端页面接收并展示查询结果集的相关代码。
{% csrf_token %}
{% for foo in filter.qs %}
<tr>
<td>{{ foo.platform_order_code }}</td>
<td>{{ foo.code }}</td>
</tr>
{% endfor %}django-filter在前端生成的对应form表单结构如下。
{{ filter.form.as_p }}以上关于Django中普通查询与django-filter插件应用的示例分享完毕，希望能为读者提供有价值的参考，也欢迎继续支持本站内容。
免责声明：本文内容仅供参考，不代表本站观点。转载或引用请注明出处。
