如何将DataTables.js查询参数转换为Python/Django结构化对象？

直接上实现代码，这个函数可以把你收到的扁平请求字典转换成目标结构化数据，完全适配columns和order数量可变的场景：

def parse_datatables_request(request_data):
    # 提取基础变量，同步完成类型转换
    parsed_data = {
        'draw': int(request_data.get('draw', 0)),
        'start': int(request_data.get('start', 0)),
        'length': int(request_data.get('length', 10)),
        'search_value': request_data.get('search[value]', ''),
        'search_regex': request_data.get('search[regex]', 'false').lower() == 'true'
    }

    # 处理列对象数组
    columns = []
    # 先提取所有列的索引，避免遗漏
    column_indices = set()
    for key in request_data.keys():
        if key.startswith('columns[') and '][' in key:
            idx = key.split('[')[1].split(']')[0]
            column_indices.add(idx)
    # 按索引排序，保证列顺序和前端一致
    for idx in sorted(column_indices, key=int):
        column = {
            'data': request_data.get(f'columns[{idx}][data]', ''),
            'name': request_data.get(f'columns[{idx}][name]', ''),
            'searchable': request_data.get(f'columns[{idx}][searchable]', 'false').lower() == 'true',
            'orderable': request_data.get(f'columns[{idx}][orderable]', 'false').lower() == 'true',
            'search': {
                'value': request_data.get(f'columns[{idx}][search][value]', ''),
                'regex': request_data.get(f'columns[{idx}][search][regex]', 'false').lower() == 'true'
            }
        }
        columns.append(column)
    parsed_data['columns'] = columns

    # 处理排序对象数组
    orders = []
    order_indices = set()
    for key in request_data.keys():
        if key.startswith('order[') and '][' in key:
            idx = key.split('[')[1].split(']')[0]
            order_indices.add(idx)
    for idx in sorted(order_indices, key=int):
        order = {
            'column': int(request_data.get(f'order[{idx}][column]', 0)),
            'dir': request_data.get(f'order[{idx}][dir]', 'asc'),
            'name': request_data.get(f'order[{idx}][name]', '')
        }
        orders.append(order)
    parsed_data['orders'] = orders

    return parsed_data

实际使用示例 #

在你的Django视图中直接调用即可，适配GET/POST请求：

def datatable_server_view(request):
    # GET请求用request.GET，POST请求用request.POST，转成字典传入函数
    request_data = request.GET.dict() if request.method == 'GET' else request.POST.dict()
    parsed_data = parse_datatables_request(request_data)

    # 现在可以直接使用结构化后的变量：
    # parsed_data['draw']、parsed_data['start']、parsed_data['length']
    # parsed_data['search_value']、parsed_data['search_regex']
    # parsed_data['columns'] 列对象列表，parsed_data['orders'] 排序对象列表

    # 后续就可以用这些参数执行数据库查询，返回DataTables要求的格式
    # 示例：
    # total = Product.objects.count()
    # filtered_qs = Product.objects.filter(name__icontains=parsed_data['search_value'])
    # filtered_total = filtered_qs.count()
    # page_data = filtered_qs[parsed_data['start']:parsed_data['start']+parsed_data['length']]
    # return JsonResponse({
    #     'draw': parsed_data['draw'],
    #     'recordsTotal': total,
    #     'recordsFiltered': filtered_total,
    #     'data': [{'brand': p.brand, 'sku': p.sku, 'name': p.name} for p in page_data]
    # })

代码逻辑说明 #

1. 基础变量处理：直接提取键值，将字符串类型的数字转为整数，将true/false字符串转为布尔值（统一转小写判断，避免大小写问题）。
2. 列数组处理：先遍历所有键提取列索引，避免遗漏任意列；按索引排序保证顺序和前端一致；最后拼接键名构建完整的列对象。
3. 排序数组处理：逻辑和列数组一致，提取排序索引后按顺序构建排序对象，将列索引转为整数类型。

测试结果示例 #

用你提供的输入字典调用函数，会得到如下结构化结果：

{
    'draw': 1,
    'start': 0,
    'length': 10,
    'search_value': '',
    'search_regex': False,
    'columns': [
        {'data': '0', 'name': 'Brand', 'searchable': True, 'orderable': True, 'search': {'value': '', 'regex': False}},
        {'data': '1', 'name': 'Sku', 'searchable': True, 'orderable': True, 'search': {'value': '', 'regex': False}},
        {'data': '2', 'name': 'Name', 'searchable': True, 'orderable': True, 'search': {'value': '', 'regex': False}}
    ],
    'orders': [
        {'column': 0, 'dir': 'asc', 'name': 'Brand'}
    ]
}

内容的提问来源于stack exchange，提问作者D.G. Redd