django常用组件学习1——django-filter
标签：django我们平常用django做的列表页面都会有很多查询条件。在提交查询时，views里会接收查询表单传递过来的参数，然后在queryset中根据查询条件进行过滤，最后要把过滤结果和本次查询参数在传到模板页面进行显示。django-filter组件把以上操作进行了封装，简化代码量。
基本使用方式：
我对我们ERP项目的车辆管理列表用django-filter重写一下，进行学习。
class Cars(models.Model):
STATU_CHOICE = (
(0, '空闲中'),
(1, '使用中'),
)
un_id = models.IntegerField(u'机构编号', db_column='un_id', blank=True, null=True)
car = models.CharField(u'车牌号', max_length=10)
brand = models.CharField(u'车辆品牌',max_length=20, blank=True, null=True)
site = models.IntegerField(u'座位数', max_length=2, blank=True, null=True)
path = models.ImageField(u'车辆图片',upload_to='/', blank=True, null=True)
company = models.CharField(u'保险公司', max_length=30, blank=True, null=True)
time = models.DateTimeField(u'投保时间', blank=True, null=True)
person = models.CharField(u'经办人', max_length=5, blank=True, null=True)
statu = models.IntegerField(u'使用状态',choices=STATU_CHOICE, blank=True, null=True)
adder = models.CharField(u'添加人', max_length = 100)
addtime = models.DateTimeField(auto_now_add = True)
adderip = models.IPAddressField(default = u'0.0.0.0')
status = models.IntegerField(choices = utils.CHOICES_STATUS, default = 200)
class Meta:
db_table = 'office_cars'
新建一个FilterSet
class CarsFilter(django_filters.FilterSet):
class Meta:
model = Cars
fields = ['car', 'site']
views中修改如下：
querys = Cars.objects.filter(un_id=Mine.Unit.id, status=200)
f = CarsFilter(request.GET, queryset=querys)
context = {
'request': request,
'opera':opera,
'filter':f,
}
return render_to_response('cars_list.html', context)
模板cars_list.html的代码：
{% block body_search %}
<section id="serach-console">
<hgroup>
<form action="?method=search" method="get">
查找:
{{ filter.form }}
<input class="button" type="submit" value="搜索" />
</form>
</hgroup>
</section>
{% endblock %}
{% block body_contents %}
<section id="editor-console">
{% load pagination_tags %}
<table class="data-list" width="100%" border="0" cellspacing="0" cellpadding="0">
<tr>
<th width="2%"><input type="checkbox" id="check-console" value="-1"></th>
<th width="10%">车牌号</th>
<th width="10%">品牌</th>
<th width="10%">座位数</th>
<th width="10%">图片</th>
<th width="10%">保险公司</th>
<th width="10%">投保时间</th>
<th width="10%">经办人</th>
<th width="10%">使用状态</th>
</tr>
{% if filter %}
{% autopaginate filter 30 %}
{% for q in filter %}
<tr>
<td><input type="checkbox" name="id" id="{{q.id}}" value="{{ q.id }}"></td>
<td align="center">{{q.car}}</td>
<td align="center">{{q.brand}}</td>
<td align="center">{{q.site}}</td>
<td align="center">
{% if q.path != '' %}
<a href="{{ q.path }}" target="_blank"><img src="{{ q.path }}" width="40px" height="30px"></a>
{% endif %}
</td>
<td align="center">{{q.company}}</td>
<td align="center">{{q.time|date:'Y-m-d'}}</td>
<td align="center">{{q.person}}</td>
<td align="center">{{q.get_statu_display}}</td>
</tr>
{% endfor %}
{% else %}
<tr>
<td colspan="9" style="color:#e00">空记录！</td>
</tr>
{% endif %}
</table>
<div >{% paginate %}</div>
<br/>
</section>
{% endblock %}
上面例子只是通过车牌号和座位数进行直等的查询，我们一般情况下都需要实现按车牌号的模糊查询和座位数的范围查询。这需要我们把fields参数定义为字典形式，如下：
class CarsFilter(django_filters.FilterSet):
class Meta:
model = Cars
fields = {'car': [ 'icontains'],
'site': [ 'gte', 'lte'],
}order_by排序参数，可以让用户选择排序方式：
class CarsFilter(django_filters.FilterSet):
class Meta:
model = Cars
fields = ['car', 'site']
order_by = ['car', 'site']高级用法：
如果要在下拉列表中显示排序字段名称，需要定义为元组，如下：
class CarsFilter(django_filters.FilterSet):
class Meta:
model = Cars
fields = ['car', 'site']
order_by = (
('car','车牌号'),
('site','座位数')
)RangeFilter
如果想要查询座位数在一定范围内的车辆，除了可以使用’site’: [ ‘gte’, ‘lte’]，还可以使用RangeFilter：
class CarsFilter(django_filters.FilterSet):
site = RangeFilter()
class Meta:
model = Cars
fields = ['car', 'site']
order_by = (
('car','车牌号'),
('site','座位数')
)ChoiceFilter
如果想要按车辆使用状态进行查询，需要使用ChoiceFilter：
class CarsFilter(django_filters.FilterSet):
site = RangeFilter()
statu = ChoiceFilter(choices=Cars.STATU_CHOICE)
class Meta:
model = Cars
fields = ['car', 'site', 'statu']
order_by = (
('car','车牌号'),
('site','座位数')
)通用视图
# urls.py
from django.conf.urls import patterns, url
from django_filters.views import FilterView
from apps.office.cars.models import Cars
urlpatterns = patterns('',
(r'^list/$', FilterView.as_view(model=Cars,template_name='cars_list.html')),
)
Written on 2015-05-13