{% raw %}

使用Django输出CSV

这篇文档阐述了如何通过使用Django视图动态输出CSV (Comma Separated Values)。 你可以使用Python CSV 库或者Django的模板系统来达到目的。

使用Python CSV库

Python自带了CSV库,csv。在Django中使用它的关键是,csv模块的CSV创建功能作用于类似于文件的对象,并且Django的HttpResponse对象就是类似于文件的对象。

这里是个例子:

  1. import csv
  2. from django.http import HttpResponse
  3. def some_view(request):
  4. # Create the HttpResponse object with the appropriate CSV header.
  5. response = HttpResponse(content_type='text/csv')
  6. response['Content-Disposition'] = 'attachment; filename="somefilename.csv"'
  7. writer = csv.writer(response)
  8. writer.writerow(['First row', 'Foo', 'Bar', 'Baz'])
  9. writer.writerow(['Second row', 'A', 'B', 'C', '"Testing"', "Here's a quote"])
  10. return response

代码和注释是不用多说的,但是一些事情需要提醒一下:

  • 响应对象获得了一个特殊的MIME类型,text/csv。这会告诉浏览器,文档是个CSV文件而不是HTML文件。如果你把它去掉,浏览器可能会把输出解释为HTML,会在浏览器窗口中显示一篇丑陋的、可怕的官样文章。
  • 响应对象获取了附加的Content-Disposition协议头,它含有CSV文件的名称。文件名可以是任意的;你想把它叫做什么都可以。浏览器会在”另存为“对话框中使用它,或者其它。
  • 钩住CSV生成API非常简单:只需要把response作为第一个参数传递给csv.writercsv.writer 函数接受一个类似于文件的对象,而HttpResponse 对象正好合适。
  • 对于你CSV文件的每一行,调用writer.writerow,向它传递一个可迭代的对象比如列表或者元组。
  • CSV模板会为你处理引用,所以你不用担心没有转义字符串中的引号或者逗号。只需要向writerow()传递你的原始字符串,它就会执行正确的操作。

在Python 2中处理Unicode

Python2的csv模块不支持Unicode输入。由于Django在内部使用Unicode,这意味着从一些来源比如HttpRequest读出来的字符串可能导致潜在的问题。有一些选项用于处理它:

  • 手动将所有Unicode对象编码为兼容的编码。
  • 使用csv模块示例章节中提供的UnicodeWriter类。
  • 使用python-unicodecsv 模块,它作为csv模块随时可用的替代方案,能够优雅地处理Unicode。

更多信息请见csv模块的Python文档。

流式传输大尺寸CSV文件

当处理生成大尺寸响应的视图时,你可能想要使用Django的StreamingHttpResponse类。例如,通过流式传输需要长时间来生成的文件,可以避免负载均衡器在服务器生成响应的时候断掉连接。

在这个例子中,我们利用Python的生成器来有效处理大尺寸CSV文件的拼接和传输:

  1. import csv
  2. from django.utils.six.moves import range
  3. from django.http import StreamingHttpResponse
  4. class Echo(object):
  5. """An object that implements just the write method of the file-like
  6. interface.
  7. """
  8. def write(self, value):
  9. """Write the value by returning it, instead of storing in a buffer."""
  10. return value
  11. def some_streaming_csv_view(request):
  12. """A view that streams a large CSV file."""
  13. # Generate a sequence of rows. The range is based on the maximum number of
  14. # rows that can be handled by a single sheet in most spreadsheet
  15. # applications.
  16. rows = (["Row {}".format(idx), str(idx)] for idx in range(65536))
  17. pseudo_buffer = Echo()
  18. writer = csv.writer(pseudo_buffer)
  19. response = StreamingHttpResponse((writer.writerow(row) for row in rows),
  20. content_type="text/csv")
  21. response['Content-Disposition'] = 'attachment; filename="somefilename.csv"'
  22. return response

使用模板系统

或者,你可以使用Django模板系统来生成CSV。比起便捷的Python csv模板来说,这样比较低级,但是为了完整性,这个解决方案还是在这里展示一下。

它的想法是,传递一个项目的列表给你的模板,并且让模板在for循环中输出逗号。

这里是一个例子,它像上面一样生成相同的CSV文件:

  1. from django.http import HttpResponse
  2. from django.template import loader, Context
  3. def some_view(request):
  4. # Create the HttpResponse object with the appropriate CSV header.
  5. response = HttpResponse(content_type='text/csv')
  6. response['Content-Disposition'] = 'attachment; filename="somefilename.csv"'
  7. # The data is hard-coded here, but you could load it from a database or
  8. # some other source.
  9. csv_data = (
  10. ('First row', 'Foo', 'Bar', 'Baz'),
  11. ('Second row', 'A', 'B', 'C', '"Testing"', "Here's a quote"),
  12. )
  13. t = loader.get_template('my_template_name.txt')
  14. c = Context({
  15. 'data': csv_data,
  16. })
  17. response.write(t.render(c))
  18. return response

这个例子和上一个例子之间唯一的不同就是,这个例子使用模板来加载,而不是CSV模块。代码的结果 — 比如content_type='text/csv' — 都是相同的。

然后,创建模板my_template_name.txt,带有以下模板代码:

  1. {% for row in data %}"{{ row.0|addslashes }}", "{{ row.1|addslashes }}", "{{ row.2|addslashes }}", "{{ row.3|addslashes }}", "{{ row.4|addslashes }}"
  2. {% endfor %}

这个模板十分基础。它仅仅遍历了提供的数据,并且对于每一行都展示了一行CSV。它使用了addslashes模板过滤器来确保没有任何引用上的问题。

其它基于文本的格式

要注意对于 CSV来说,这里并没有什么特别之处 — 只是特定了输出格式。你可以使用这些技巧中的任何一个,来输出任何你想要的,基于文本的格式。你也可以使用相似的技巧来生成任意的二进制数据。例子请参见在Django中输出PDF

译者:Django 文档协作翻译小组,原文:Generating CSV

本文以 CC BY-NC-SA 3.0 协议发布,转载请保留作者署名和文章出处。

Django 文档协作翻译小组人手紧缺,有兴趣的朋友可以加入我们,完全公益性质。交流群:467338606。

{% endraw %}