Django 1.1 版本发行说明Link to this heading#

约束名称的更改Link to this heading#

Django 1.1 修改了生成数据库约束名称的方法，使得名称在不同机器字长下保持一致。这个改变对一些用户来说是不兼容的。

如果你使用的是 32 位平台，你就不用担心了；你不会因为这个改变而观察到任何差异。

然而，在 64 位平台上的用户可能会在使用 ``reset`` 管理命令时遇到一些问题。在这个更改之前，64 位平台会生成一个 64 位、16 个字符的约束名称；例如：

ALTER TABLE myapp_sometable ADD CONSTRAINT object_id_refs_id_5e8f10c132091d1e FOREIGN KEY ...

在这个改变之后，所有平台（无论字长如何）都将在约束名称中生成一个 32 位、8 个字符的摘要；例如：

ALTER TABLE myapp_sometable ADD CONSTRAINT object_id_refs_id_32091d1e FOREIGN KEY ...

由于这个更改，你将无法在由 64 位机器创建的任何表上使用 reset 管理命令。这是因为新生成的名称将不匹配历史生成的名称；因此，reset 命令构建的 SQL 将无效。

如果你需要重置一个使用 64 位约束创建的应用程序，你需要在调用 reset 命令之前手动删除旧的约束。

现在测试用例在一个事务中运行Link to this heading#

Django 1.1 在事务内运行测试，从而提高了测试性能（详细信息请参见 测试性能改进）。

如果现有的测试需要测试事务行为，如果它们依赖于对测试环境的无效假设，或者如果它们需要特定的测试用例顺序，那么这个改变在某种程度上是不兼容的。

对于这些情况，可以使用 TransactionTestCase。这只是一个快速的修复方法，用来解决新的回滚方式暴露出的测试用例错误；从长远来看，应该重新编写测试用例以纠正问题。

移除了 SetRemoteAddrFromForwardedFor 中间件Link to this heading#

为了方便，Django 1.0 包括了一个可选的中间件类 -- django.middleware.http.SetRemoteAddrFromForwardedFor -- 该类基于一些代理配置常常设置的 HTTP X-Forwarded-For 头部更新了 REMOTE_ADDR 的值。

已经证明这个机制不能够可靠到足以用于通用用途，并且（尽管文档中有不同的说明）它包含在 Django 中可能会导致应用程序开发者假设 REMOTE_ADDR 的值是“安全的”或以某种方式可靠作为身份验证的来源。

尽管这不是一个直接的安全问题，但我们决定在 Django 1.1 版本中删除这个中间件。它已被替换为一个什么都不做，只会引发 DeprecationWarning 的类。

如果你一直依赖这个中间件，最简单的升级路径是：

• 检查 在被移除之前的代码。

• 验证它是否与你的上游代理正确工作，并根据需要修改以支持你的特定代理。

• 在你自己的项目中将我修改过的版本的 SetRemoteAddrFromForwardedFor 作为中间件引入。

上传文件的名称稍后可用Link to this heading#

在 Django 1.0 中，上传并存储在模型的 FileField 中的文件在模型保存到数据库之前会被保存到磁盘。这意味着在保存之前可以获取分配给文件的实际文件名。例如，在模型的预保存信号处理程序中可以获取到它。

在 Django 1.1 中，文件会作为保存模型到数据库的一部分而被保存，因此在模型被保存之前不能依赖于磁盘上使用的实际文件名。

模型表单集的保存方式的变更Link to this heading#

在Django 1.1中，save()。

如果你在模型表单集的 __init__ 中修改了 self.initial，或者依赖于 BaseFormSet 的内部属性 _total_form_count 或 _initial_form_count，这是不兼容的。现在这些属性已经变成了公共方法。

修复了"join"过滤器的转义行为Link to this heading#

join 过滤器不再转义传递给连接器的字面量。

这对于包含五个特殊 HTML 字符之一的文字字符串的特殊情况是不兼容的。因此，如果你之前写的是 {{ foo|join:"&" }}，现在你必须写成 {{ foo|join:"&" }}。

先前的行为是一个错误，并且与所记录和预期的不符。

永久重定向和`redirect_to()`通用视图Link to this heading#

Django 1.1 在 django.views.generic.simple.redirect_to() 视图中添加了一个 permanent 参数。如果你使用 redirect_to 视图并将格式字符串键命名为 'permanent'，这在技术上是向后不兼容的，这是极不可能的。

ORM 改进Link to this heading#

Django 的对象关系映射器（ORM）已经增加了两个重要的增强功能：聚合支持和查询表达式。

模型改进Link to this heading#

Django 的模型层已添加了多项功能：

测试改进Link to this heading#

测试框架 中已经进行了一些显著的改进。

测试客户端改进Link to this heading#

测试客户端进行了几项小而非常有用的改进：

• 测试中的 Client 现在可以通过 Client.get() 和 Client.post() 的 follow 参数自动跟随重定向。这使得测试发出重定向的视图更加简单。

• 现在更容易获取测试客户端返回的响应中的模板上下文：你只需将上下文作为 request.context[key] 来访问。如果需要，仍然可以使用旧方式，该方式将 request.context 视为继承链中每个渲染模板的上下文列表。

新的管理功能Link to this heading#

Django 1.1 在 Django 的管理界面中增加了几个很棒的新功能：

条件视图处理Link to this heading#

Django 现在对使用标准的 ETag 和 Last-Modified HTTP 头部的 条件视图处理 提供了更好的支持。这意味着你现在可以通过测试成本较低的条件来轻松地中断视图处理。对于许多视图来说，这可以大大提高速度并减少带宽消耗。

URL 命名空间Link to this heading#

Django 1.1 引入了 URL "命名空间"，提升了 命名的 URL 模式。

简而言之，这个功能允许相同的应用程序中的同一组 URL 在 Django 的 URLConf 中多次包含，使用不同（且可能嵌套）的命名前缀进行反向解析。换句话说，像 Django 的管理界面这样的可重用应用程序可以多次注册而不会出现 URL 冲突。

详细信息，请参阅 关于定义 URL 命名空间的文档。

GeoDjangoLink to this heading#

在 Django 1.1 中，GeoDjango （即 django.contrib.gis）引入了一些新功能：

• 支持将 SpatiaLite （SQLite 的空间数据库）作为空间后端。

• 地理聚合函数（Collect、Extent、MakeLine、Union）和 F 表达式。

• 新的 GeoQuerySet 方法：collect、geojson 和 snap_to_grid。

• GEOSGeometry 对象的新列表接口方法。

要了解更多详细信息，请参阅 GeoDjango 文档。

其他改进Link to this heading#

自 Django 1.0 以来引入的其他新功能和更改包括：

• CSRF 保护中间件 现在分成了两个类 -- CsrfViewMiddleware 用于检查传入请求，而 CsrfResponseMiddleware 用于处理传出响应。合并的 CsrfMiddleware 类（同时处理两者）仍然存在以保持向后兼容性，但现在建议使用拆分的类来允许精细控制 CSRF 处理发生的时间和地点。

• reverse() 和使用它的代码（例如，{% url %} 模板标签）现在可以在 Django 的管理站点中使用，前提是通过 include(admin.site.urls) 设置了管理站点的 URL（仍然可以通过将管理请求发送到 admin.site.root 视图来工作，但以这种方式配置时，管理站点中的 URL 将无法“反向生成”）。

• Django URLconf 模块中的 include() 函数现在可以接受 URL 模式的序列（由 patterns() 生成）以及模块名称。

• Django 表单的实例（参见 表单概述）现在具有两个额外的方法，hidden_fields() 和 visible_fields()，分别返回表单中隐藏字段（即 <input type="hidden">）和可见字段的列表。

• redirect_to 通用视图现在接受一个额外的关键字参数 permanent。如果 permanent 为 True，视图将发出 HTTP 永久重定向（状态码 301）。如果为 False，视图将发出 HTTP 临时重定向（状态码 302）。

• 已经为 DateField 和 DateTimeField 添加了一个新的数据库查找类型 -- week_day。这种查找类型接受一个介于 1（星期日）和 7（星期六）之间的数字，并返回字段值匹配该周的对象。有关详细信息，请参阅 查找类型的完整列表。

• Django 模板语言中的 {% for %} 标签现在接受一个可选的 {% empty %} 子句，当 {% for %} 被要求循环遍历一个空序列时，可以显示该子句。有关示例，请参阅 内置模板标签列表。

• dumpdata 管理命令现在接受单个模型名称作为参数，允许你仅导出特定模型的数据。

• 新增了一个 safeseq 模板过滤器，与 safe 类似，但用于列表，将列表中的每个项目标记为安全。

• 缓存后端 现在支持 incr() 和 decr() 命令，用于增加和减少缓存键的值。在支持原子增加/减少的缓存后端上，尤其是 memcached 后端，这些操作将是原子的，而且非常快。

• Django 现在可以通过一个新的身份验证后端轻松地将身份验证委托给 Web 服务器，该后端支持用于此目的的标准 REMOTE_USER 环境变量。请参阅 如何将身份验证委托给 Web 服务器 以获取详细信息。

• 新增了一个 django.shortcuts.redirect() 函数，使得根据对象、视图名称或 URL 发出重定向变得更加容易。

• postgresql_psycopg2 后端现在支持 本地 PostgreSQL 自动提交。这是一个高级的、特定于 PostgreSQL 的功能，可以使某些读密集型应用程序变得更加快速。