mirror of
https://github.com/LCTT/TranslateProject.git
synced 2025-01-25 23:11:02 +08:00
校对完成
校对：An introduction to the Django Python web app framework
This commit is contained in:
Bestony
GitHub
parent
e43db66963
commit
da09150162
@ -3,17 +3,17 @@ Python Web 应用程序 Django 框架简介
|
||||
|
||||
|
||||
|
||||
在本系列（由四部分组成）的前三篇文章中，我们讨论了 [Pyramid][1], [Flask][2] 和 [Tornado][3] 这 3 个 Web 框架。我们已经构建了三次相同的应用程序，最终我们遇到了 [Django][4]。总的来说，Django 是目前 Python 开发人员使用的主要 Web 框架，并且不难看出原因。它擅长隐藏大量的配置逻辑，让你专注于能过够快速构建大型应用程序。
|
||||
在本系列（由四部分组成）的前三篇文章中，我们讨论了 [Pyramid][1], [Flask][2] 和 [Tornado][3] 这 3 个 Web 框架。我们已经构建了三次相同的应用程序，最终我们遇到了 [Django][4]。总的来说，Django 是目前 Python 开发人员使用的主要 Web 框架，并且不难看出原因。它擅长隐藏大量的配置逻辑，让你专注于能够快速构建大型应用程序。
|
||||
|
||||
也就是说，当涉及到小型项目时，比如我们的待办事项列表应用程序，Django 可能有点像用消防水管来进行水枪大战。让我们来看看它们是如何结合在一起的。
|
||||
|
||||
### 关于 Django
|
||||
|
||||
Django 将自己定位为“一个高级的 Python Web 框架，它鼓励快速开发和干净，实用的设计。它由经验丰富的开发人员构建，解决了 Web 开发的很多麻烦，因此你可以专注于编写应用程序而无需重新发明轮子”。它真的做到了！这个庞大的 Web 框架附带了非常多的工具，通常在开发过程中，如何将所有内容组合在一起协同工作可能是个谜。
|
||||
Django 将自己定位为“一个鼓励快速开发、整洁、实用的设计、高级的 Python Web 框架。它由经验丰富的开发人员构建，解决了 Web 开发的很多麻烦，因此你可以专注于编写应用程序而无需重新发明轮子”。它真的做到了！这个庞大的 Web 框架附带了非常多的工具，以至于在开发过程中，如何将所有内容组合在一起协同工作可能是个谜。
|
||||
|
||||
除了框架本身很大，Django 社区也是非常庞大的。事实上，它非常庞大和活跃，以至于有[一个网站][5]致力于为人们收集第三方包，这些第三方包可集成进 Django 来做一大堆事情。包括从身份验证和授权到完全基于 Django 的内容管理系统，电子商务附加组件以及与 Stripe（译注：美版“支付宝”）集成的所有内容。关于不要重新发明轮子：如果你想用 Django 完成一些事情，有人可能已经做过了，你只需将它集成进你的项目就行。
|
||||
除了框架本身很大，Django 社区也是非常庞大的。事实上，它非常庞大和活跃，以至于有[一个网站][5]致力于为人们收集第三方包，这些第三方包可集成进 Django 来做一大堆事情。包括从身份验证和授权到完全基于 Django 的内容管理系统，电子商务附加组件以及与 Stripe（译注：美版“支付宝”）集成的所有内容。至于不要重新发明轮子：如果你想用 Django 完成一些事情，有人可能已经做过了，你只需将它集成进你的项目就行。
|
||||
|
||||
为此，我们希望使用 Django 构建 REST API，因此我们将利用流行的 [Django REST framework][6]。它的工作是将 Django 框架（Django 使用自己的模板引擎构建 HTML 页面）转换为专门用于有效地处理 REST 交互的系统。让我们开始吧。
|
||||
为此，我们希望使用 Django 构建 REST API，因此我们将使用流行的 [Django REST framework][6]。它的工作是将 Django 框架（Django 使用自己的模板引擎构建 HTML 页面）转换为专门用于有效地处理 REST 交互的系统。让我们开始吧。
|
||||
|
||||
### Django 启动和配置
|
||||
|
||||
@ -52,13 +52,13 @@ manage.py django_todo
|
||||
|
||||
```
|
||||
|
||||
`manage.py` 是一个可执行命令行 Python 文件，它最终成为 `django-admin` 的装饰器（to 校正：这里装饰器只是一个语义上的称呼，与 Python 的装饰器不同）。因此，它的工作与 `django-admin` 是一样的：帮助我们管理项目。因此得名 `manage.py`。
|
||||
`manage.py` 是一个可执行命令行 Python 文件，它最终成为 `django-admin` 的封装。因此，它的工作与 `django-admin` 是一样的：帮助我们管理项目。因此得名 `manage.py`。
|
||||
|
||||
它在 `django_todo` 目录里创建了一个新目录 `django_todo`，其代表了我们项目的配置根目录。现在让我们深入研究一下。
|
||||
|
||||
### 配置 Django
|
||||
|
||||
可以将 `django_todo` 目录称为“配置根”，我们的意思是这个目录包含了通常配置 Django 项目所需的文件。几乎所有这个目录之外的内容都只关注与项目模型，视图，路由等相关的“业务逻辑”。所有连接项目的点都将在这里出现。
|
||||
可以将 `django_todo` 目录称为“配置根目录”，我们的意思是这个目录包含了通常配置 Django 项目所需的文件。几乎所有这个目录之外的内容都只关注与项目模型，视图，路由等相关的“业务逻辑”。所有连接项目的点都将在这里出现。
|
||||
|
||||
在 `django_todo` 目录中调用 `ls` 会显示以下四个文件：
|
||||
```
|
||||
@ -88,7 +88,7 @@ __init__.py settings.py urls.py wsgi.py
|
||||
|
||||
* `DEBUG` 告诉 Django 是以开发模式还是生产模式运行项目。这是一个非常关键的区别。
|
||||
|
||||
* 在开发模式下，当弹出一个错误时，Django 将显示导致错误的完整堆栈跟踪，以及运行项目所涉及的所有设置和配置。如果在生产环境中将 `DEBUG` 设置为 `True`，这可能是一个巨大的安全问题。
|
||||
* 在开发模式下，当弹出一个错误时，Django 将显示导致错误的完整堆栈跟踪，以及运行项目所涉及的所有设置和配置。如果在生产环境中将 `DEBUG` 设置为 `True`，这可能成为一个巨大的安全问题。
|
||||
|
||||
* 在生产模式下，当出现问题时，Django 会显示一个简单的错误页面，即除错误代码外不提供任何信息。
|
||||
|
||||
@ -121,11 +121,11 @@ __init__.py settings.py urls.py wsgi.py
|
||||
|
||||
* `TIME_ZONE` 是我们 Django 项目后中自动生成的时间戳的时区。我强调坚持使用 UTC 并在其它地方执行任何特定于时区的处理，而不是尝试重新配置此设置。正如[这篇文章][12] 所述，UTC 是所有时区的共同点，因为不需要担心偏移。如果偏移很重要，我们可以根据需要使用与 UTC 的适当偏移来计算它们。
|
||||
|
||||
* `USE_I18N` 将让 Django 使用自己的翻译服务来为前端翻译字符串。I18N = 国际化（“i” 和 “n” 之间的 18 个字符）。
|
||||
* `USE_I18N` 将让 Django 使用自己的翻译服务来为前端翻译字符串。I18N = 国际化（internationalization，“i” 和 “n” 之间共 18 个字符）。
|
||||
|
||||
* `USE_L10N` (L10N = 本地化[在 "l" 和 "n" 之间有 10 个字符]) 如果设置为 `True`，那么将使用数据的公共本地格式。一个很好的例子是日期：在美国它是 MM-DD-YYYY。在欧洲，日期往往写成 DD-MM-YYYY。
|
||||
* `USE_L10N` (L10N = 本地化[localization，在 "l" 和 "n" 之间共 10 个字符]) 如果设置为 `True`，那么将使用数据的公共本地格式。一个很好的例子是日期：在美国它是 MM-DD-YYYY。在欧洲，日期往往写成 DD-MM-YYYY。
|
||||
|
||||
* `STATIC_URL` 是用于提供静态文件的大量设置的一部分。我们将构建一个 REST API，因此我们不需要担心静态文件。通常，这会为每个静态文件的域名设置根路径。所以，如果我们有一个徽标图像，那就是 `http://<domainname>/<STATIC_URL>/logo.gif`。
|
||||
* `STATIC_URL` 是用于提供静态文件的大量设置的一部分。我们将构建一个 REST API，因此我们不需要担心静态文件。通常，这会为每个静态文件的域名设置根路径。所以，如果我们有一个 Logo 图像，那就是 `http://<domainname>/<STATIC_URL>/logo.gif`。
|
||||
|
||||
默认情况下，这些设置已准备就绪。我们必须改变的一个选项是 `DATABASES` 设置。首先，我们创建将要使用的数据库：
|
||||
```
|
||||
@ -169,7 +169,7 @@ DATABASES = {
|
||||
|
||||
```
|
||||
|
||||
在继续之前，请确保设置环境变量或 Django 不起作用（to 校正：这里不清楚原文的意思，什么叫 django 不起作用）。此外，我们需要在此环境中安装 `psycopg2`，以便我们可以与数据库通信。
|
||||
在继续之前，请确保设置环境变量，否则 Django 将不起作用。此外，我们需要在此环境中安装 `psycopg2`，以便我们可以与数据库通信。
|
||||
|
||||
### Django 路由和视图
|
||||
|
||||
@ -313,17 +313,17 @@ Django REST Framework 希望我们在使用浏览器浏览时拥有一个人性
|
||||
|
||||
现在让我们来创建数据模型吧。
|
||||
|
||||
Django 项目的整个基础架构都是围绕数据模型构建的，它是这样编写的，因此每个数据模型够可以拥有自己的小天地，拥有自己的视图，自己与其资源相关的 URL 集合，甚至是自己的测试（如果我们需要（to 校正：这里？？？））。
|
||||
Django 项目的整个基础架构都是围绕数据模型构建的，它是这样编写的，因此每个数据模型够可以拥有自己的小天地，拥有自己的视图，自己与其资源相关的 URL 集合，甚至是自己的测试（如果我们如此想要）。
|
||||
|
||||
如果我们想构建一个简单的 Django 项目，我们可以通过在 `django_todo` 目录中编写我们自己的 `models.py` 文件并将其导入我们的视图来避免这种情况。但是，我们试图以“正确”的方式编写 Django 项目，因此我们应该尽可能地将模型分成 Django 方式的包（to 校正：这里 Django Way™ 有点懵）。
|
||||
如果我们想构建一个简单的 Django 项目，我们可以通过在 `django_todo` 目录中编写我们自己的 `models.py` 文件并将其导入我们的视图来避免这种情况。但是，我们试图以“正确”的方式编写 Django 项目，因此我们应该尽可能地将模型拆分成符合 Django Way™（Django 风格）的包。
|
||||
|
||||
Django Way 涉及创建所谓的 Django “apps”，它本身并不是单独的应用程序，它们没有自己的设置和诸如此类的东西（虽然它们也可以）。但是，它们可以拥有一个人们可能认为属于独立应用程序的东西：
|
||||
|
||||
* 一组自包含的 URL
|
||||
* 一组自包含的 HTML 模板（如果我们想要提供 HTML）
|
||||
* 一组自建的 URL
|
||||
* 一组自建的 HTML 模板（如果我们想要提供 HTML）
|
||||
* 一个或多个数据模型
|
||||
* 一套自包含的视图
|
||||
* 一套自包含的测试
|
||||
* 一套自建的视图
|
||||
* 一套自建的测试
|
||||
|
||||
它们是独立的，因此可以像独立应用程序一样轻松共享。实际上，Django REST Framework 是 Django app 的一个例子。它包含自己的视图和 HTML 模板，用于提供我们的 JSON。我们只是利用这个 Django app 将我们的项目变成一个全面的 RESTful API 而不用那么麻烦。
|
||||
|
||||
@ -353,11 +353,11 @@ __init__.py admin.py apps.py migrations models.py tests.py
|
||||
|
||||
* `__init__.py` 是空文件。它之所以存在是因为此目录可看作是模型，视图等的有效导入路径。
|
||||
|
||||
* `admin.py` 不是空文件。它用于在 Django admin 中格式化（to 校正：格式化可能欠妥）这个应用程序的模型，我们在本文中没有涉及到它。
|
||||
* `admin.py` 不是空文件。它用于在 Django admin 中规范化这个应用程序的模型，我们在本文中没有涉及到它。
|
||||
|
||||
* `apps.py` 这里基本不起作用。它有助于格式化 Django admin 的模型。
|
||||
* `apps.py` 这里基本不起作用。它有助于规范化 Django admin 的模型。
|
||||
|
||||
* `migrations` 是一个包含我们数据模型快照的目录。它用于更新数据库。这是内置数据库管理的少数几个框架之一，其中一部分允许我们更新数据库，而不必拆除它并重建它以更改模式。
|
||||
* `migrations` 是一个包含我们数据模型快照的目录。它用于更新数据库。这是内置数据库管理的少数几个框架之一，其中一部分允许我们更新数据库，而不必拆除它并重建它以更改 Schema。
|
||||
|
||||
* `models.py` 是数据模型所在。
|
||||
|
||||
@ -661,8 +661,7 @@ Please select a fix:
|
||||
2. 将一个默认值添加到 `Task` 对象的 `owner` 字段
|
||||
3. 允许任务为 `owner` 字段设置 `NULL` 值
|
||||
|
||||
方案 2 在这里没有多大意义。我们建议，任何创建的 `Task`，默认情况下都会对应到某个默认所有者，尽管不一定存在。（to 校正：后面这句发意义在哪里？既然它已经说了方案 2 没有意义）
|
||||
|
||||
方案 2 在这里没有多大意义。我们建议，默认情况下，任何创建的 `Task`都会对应到某个默认所有者，尽管默认所有者不一定存在。
|
||||
方案 1 要求我们销毁和重建我们的迁移，而我们应该把它们留下。
|
||||
|
||||
让我们考虑选项 3。在这种情况下，如果我们允许 `Task` 表为所有者提供空值，它不会很糟糕。从这一点开始创建的任何任务都必然拥有一个所有者。如果你的数据库表不是一个可重新架构的情况下，请删除迁移，删除表并重建迁移。
|
||||
@ -1180,7 +1179,7 @@ Django 作为一个框架是高度可定制的，每个人都有自己的方式
|
||||
|
||||
Django 旨在处理多种模型，这些模型涵盖了不同的项目领域，但它们可能有一些共同点。这个项目是一个小型的双模型项目，有一些路由。如果我们要构建更多，我们只有七条路由，但仍然是相同的两个模型。这还不足以证明一个完整的 Django 项目。
|
||||
|
||||
如果我们期望这个项目能够扩展，那将是一个很好的选择。这不是其中一个项目。这是选择一个点燃蜡烛的火焰喷射器。这是绝对的矫枉过正。（to 校正：这里有点迷糊）
|
||||
如果我们期望这个项目能够拓展，那么将会是一个很好的选择。如果不是其中一个项目，这就是使用火焰喷射器来点燃蜡烛，绝对是矫枉过正了。
|
||||
|
||||
尽管如此，Web 框架仍然是一个 Web 框架，无论你使用哪个框架。它都可以接收请求并做出任何响应，因此你可以按照自己的意愿进行操作。只需要注意你选择的框架所带来的开销。
|
||||
|
||||
@ -1194,7 +1193,7 @@ via: https://opensource.com/article/18/8/django-framework
|
||||
作者：[Nicholas Hunt-Walker][a]
|
||||
选题：[lujun9972](https://github.com/lujun9972)
|
||||
译者：[MjSeven](https://github.com/MjSeven)
|
||||
校对：[校对者ID](https://github.com/校对者ID)
|
||||
校对：[Bestony](https://github.com/bestony)
|
||||
|
||||
本文由 [LCTT](https://github.com/LCTT/TranslateProject) 原创编译，[Linux中国](https://linux.cn/) 荣誉推出
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user