第三讲 使用Templ..
第五讲 session..

从Python到Django入门教程

Django Step by Step (四)

1 引言

经过前几节的学习，我想大家应该比较熟悉 Django 的大致开发流程：

  • 增加 view 方法
  • 增加模板
  • 修改 urls.py

就是这样。剩下的就是挖掘 Django 提供的其它的能力。在我们还没有进入模型(model)之前还是再看一看外围的东西，再更进一步体验 Django 吧。

在 Django 中我看到了一个生成 csv 格式的文档(Outputting CSV dynamically)，非常好，它没有数据库，正好用来做演示。

更进一步，现在我的需求就是提供 excel 格式文件的下载。

我们会在原来 list(表格) 例子基础上进行演示，步骤就是上面的流程。

2 修改 templates/list.html

在文件最后增加:

<p><a href="/xls/address/">Excel格式下载</a></p>

它将显示为一个链接，它所指向的链接将用来生成 Excel 文件。

3 在newtest下增加 xls_test.py

from django.http import HttpResponse
from django.template import loader, Context

address = [
    ('张三', '地址一'),
    ('李四', '地址二')
    ]

def output(request, filename):
    response = HttpResponse(content_type='application/ms-excel')
    response['Content-Disposition'] = 'attachment; filename=%s.xls' % filename

    t = loader.get_template('xls.html')
    c = Context({
        'data': address,
    })
    response.write(t.render(c))
    return response

这里使用的东西多了一些。这里没有 render_to_response 了，而是演示了一个完整的从头进行模板解析的处理过程。为什么需要这样，因为我们需要修改 response 对象的值，而 render_to_response 封装了它使得我们无法修改。从这里我们也可以看到，在调用一个方法时， Django 会传入一个 request 对象，在返回时，你需要将内容写入 response ，必要时修改它的某些属性。更详细的建议你参考 django 所带的 request_response 文档，里面详细描述了两个对象的内容，并且还可以在交互环境下进行测试，学习非常方便。

这里 address 不再是字典的列表，而是 tuple 的列表。让人高兴的是， Django 的模板除了可以处理字典，还可以处理序列，而且可以处理序列中的元素。一会在模板定义中我们会看到。

这里 output() 是我们希望 Django 调用的方法，不再是 index() 了。(不能老是一样的呀。)而且它与前面的 index() 不同，它带了一个参数。这里主要是想演示 url 的参数解析。因此你要注意，这个参数一定是放在 url 上的。它表示输出文件名。

response = HttpResponse(mimetype='application/ms-excel')
response['Content-Disposition'] = 'attachment; filename=%s.xls' % filename

这两行是用来处理输出类型和附件的，以前我也没有用过，这回也学到了。它表明返回的是一个Excel格式的文件。

t = loader.get_template('xls.html')
c = {
    'data': address,
}
response.write(t.render(c))

这几行就是最原始的模板使用方法。先通过 loader 来找到需要的模板，然后生成一个 template 对象，再生成一个 Context 对象，它就是一个字典集。然后 t.render(c) 这个用来对模板和提供的变量进行合并处理，生成最终的结果。最后调用 response.write() 将内容写入。

4 增加 templates/xls.html

<!DOCTYPE html>
<html lang="zh-cn">
  <head>
    <meta charset="utf-8">
  </head>
  <body>
      <table>
        {% for row in data %}
        <tr>
            <td>{{ row.0|addslashes}}</td>
            <td>{{ row.1|addslashes}}</td>
        </tr>
        {% endfor %}
  </body>
</html>

使用了一个 for 循环。这里 data 与上面的 Context 的 data 相对应。因为 data 是一个列表，它的每行是一个 tuple ，因此 row.0, row.1 就是取 tuple 的第一个和第二个元素。| 是一个过滤符，它表示将前一个的处理结果作为输入传入下一个处理。因此 Django 的模板很强大，使用起来也非常直观和方便。 addslashes 是 Django 模板内置的过滤 Tag ，它用来将结果中的特殊字符加上反斜线。

同时我们注意到，每个 {{}} 前后都有一个双引号，这样就保证每个字符串使用双引号引起来。然后在第一个与第二个元素之间还使用了逗号分隔。最后 endfor 在下一行，表示上面每行模板后有一个回车。

Django 还允许你自定义 Tag ，在 The Django template language: For Python programmers 文档中有描述，其实是很简单的。

5 修改 urls.py

from django.conf.urls import url
from django.contrib import admin
from . import helloworld, add, list, xls_test

urlpatterns = [
    url(r'^admin/', admin.site.urls),
    url(r'^$', helloworld.index),
    url(r'^add/$', add.index),
    url(r'^list/$', list.index),
    url(r'^xls/(?P<filename>\w+)/$', xls_test.output),
]

增加了 xls 的 url 映射。

上面的正则表达式有些复杂了，因为有参数的处理在里面。 (?P<filename>\w+) 这是一个将解析结果起名为 filename 的正则表达式，它完全符合 Python 正则表达式的用法。在最新的 Django 中，还可以简化一下： (\w+) 。但这样需要你的参数是按顺序传入的，在一个方法有多个参数时一定要注意顺序。

还记得吗？我们的链接是写成 /xls/address/ ，因此上面实际上会变成对 xls_test.output(filename='address') 的调用。

6 启动 server

看一下结果吧。点击链接，浏览器会提示你保存文件的。

很简单吧。但这里面的内容其实也不少，而且许多地方都有很大的扩展空间。

书籍推荐