编写第一个django app，第二部分

紧接着上一个教程，我们接下来将配置数据库，创建你的第一个model，并快速介绍Django自动生成的管理站点。

数据库设置
现在，打开mysite/settings.py。这是一个普通的Python模块，模块级变量表示Django设置。

默认的配置是是使用SQLite。如果你刚开始接触数据库， 或者你只对Django感兴趣，这是最简单的选择。Python内置SQLite，所以你不需要在安装任何东西来支持你的数据库了。然而，在启动第一个真实项目时，你可能希望使用PostgreSQL等更为可扩展的数据库，以避免数据库切换头痛。

如果你想使用其他的数据库，安装恰当的数据库绑定,并在DATABASES的default项中更改一下密钥以匹配数据库连接设置：

• ENGINE - 要么是'django.db.backends.sqlite3','django.db.backends.postgresql','django.db.backends.mysql',或'django.db.backends.oracle'。其他的后端也是可以的。

• NAME - 数据库的名称。如果你使用SQLite,数据库会是你计算机上的一个文件；这种情况下，NAME应该是该文件的完整绝对路径，包括文件名。默认值，os.path.join(BASE_DIR,'db.sqlite3'),会被保存在你的项目的目录中。

如果你不打算使用SQLite作为你的数据库，需要增加额外的设置，诸如USER,PASSWORD,HOST.更多细节,请参阅数据库的参考文档。

对于SQLite以外的数据库
如果你使用除SQLite之外的数据库，请确保你已经创建了一个数据库。 在数据库的交互式提示符中使用“CREATE DATABASE database_name;”进行操作。

而且要确保mysite/settings.py中提供的数据库用户具有"创建数据库"的权限。这样可以自动创建一个可以在后面的教程中使用的测试数据库。

如果你使用Sqlite，则不需要事先创建任何内容-数据库文件将在需要时自动创建。

编辑mysite/settings.py的时候，设置TIME_ZONE和你的时区一致。

而且，注意在文件顶部的INSTALLED_APPS。它包含了在Django实例中激活的所有Django应用的名称。Apps可以使用在多个Project中，并且你可以打包并分发他们给其他人在他们的项目中使用。

默认情况，INSTALLED_APPS包含以下apps，都是Django附加的：

• django.contrib.admin - 管理网站。你很快就会使用它。
• django.contrib.auth - 认证系统
• django.contrib.contenttypes - 内容类型的框架
• django.contrib.sessions - 回话框架
• django.contrib.messages -消息框架
• django.contrib.staticfiles -管理静态文件的框架

一般的实例都包含这些应用。

其中一些应用程序使用至少一个数据库表，因此我们需要在数据库中创建表，然后才能使用它们。我们是用以下命令：

python manage.py migrate

migrate命令查看INSTALLED_APPS设置，并根据mysite / settings.py文件中的数据库设置和应用程序随附的数据库migration创建任何必需的数据库表（稍后将介绍）。 您会看到适用于每个migration的消息。 如果您有兴趣，请为数据库运行命令行客户端，然后键入\ dt（PostgreSQL），SHOW TABLES; （MySQL），.schema（SQLite）或**SELECT TABLE_NAME FROM USER_TABLES; **（Oracle）来显示Django创建的表。

就像我们上面所说的那样，默认的应用程序包含在常见的实例下，但不是每个人都需要它们。 如果您不需要任何或所有这些，请在运行迁migrate之前，从INSTALLED_APPS中注释或删除相应的行。 migrate命令只能在INSTALLED_APPS中运行应用的迁移。

创建models
现在我们将使用额外的元数据来定义你的models - 本质上是你的数据库的布局。
model很简单，是关于你的数据的唯一真实来源。 它包含你正在存储的数据的基本字段和行为。 Django遵循DRY原则。 目的是把你的数据模型定义在一个地方，并自动从中获取数据。

这包括迁移 - 例如，与Ruby On Rails不同，迁移完全是从你的模型文件导出的，并且本质上只是Django可以滚动以更新你的数据库结构纲目来匹配当前模型的历史。

在我们简单的投票app里，我们创建了两个模型：Question和Choice。一个Question由一个问题和出版日期。一个Choice由两个字段：选择权的文本内容和投票的计数器。每一个Choice与一个Qeustion相关联。

这些概念用Python的class来描述。编辑polls/models.py文件，看起来像这样：

from django.db import models

class Question(models.Model):
    question_text = models.CharField(max_length=200)
    pub_date = models.DateTimeField('date published')

class Choice(models.Model):
    question = models.ForeignKey(Question,on_delete = models.CASCADE)
    choice_test = models.CharField(max_length = 200)
    votes = models.IntegerField(default = 0)

代码很简单。每一个model都用一个父类是django.db.models.Model的类描述的。每个model都有一些类变量，每个变量都表示模型中的数据库字段。

每一个字段都用Field类的实例来表示 - 例如，CharField代表字符字段，DateTimeField代表时间字段。这告诉Django每个字段的数据类型。

每个Field实例的命名（例如question_text和pub_date）是以机器友好格式的命名这个字段的。你可以在Python代码中使用它，也可以把它作为数据库字段名。

你可以使用字段的可选的第一位置参数来指定可读的名称。 这在Django的几个内省部分使用，它可以作为文档。 如果未提供此字段，Django将使用机器可读的名称。 在这个例子中，我们只为Question.pub_date定义了一个可读的名字。 对于此模型中的所有其他字段，该字段的机读名称将足以作为其可读的名称。

一些Field类有必要的参数。 例如，CharField要求给它一个max_length。 这不仅在数据库schema中使用，而且还用于验证，我们即将看到。

一个Field还可以有各种各样的可选参数;在这种情况下,我们设置votes的默认值为0。

最后注意一下用ForeignKey定义的关系。 这告诉Django每个Choice都与一个Question有关。 Django支持所有常见的数据库关系：多对一，多对多和一一对应。

激活models
一小部分模型的代码就可以告诉Django很多信息。通过它们，Django可以做：

• 为此应用创建数据库的schema(建表语句)
• 创建用于访问Question和Choice对象的Python数据库访问API 。

但首先我们需要告诉我们的项目该polls应用是安装的。

Django应用程序是“可插拔”：您可以在多个项目中使用app，您可以分发app，因为它们不必与给定的Django安装绑定。

要将该应用程序包括在我们的项目中，我们需要在INSTALLED_APPS中添加对其配置类的引用。PollsConfig类在polls/apps.py文件中，所以它的虚拟路径是'polls.apps.PollsConfig'。编辑mysite/settings.py文件，并将该虚拟路径添加到该
INSTALLED_APPS设置中。
看起来像这样：

INSTALLED_APPS = [
    'polls.apps.PollsConfig',
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
]

现在Django知道已经包含polls app了，让我们运行以下命令：

python manage.py makemigrations polls

你应该看到类似于以下内容：

Migrations for 'polls':
  polls/migrations/0001_initial.py:
    - Create model Choice
    - Create model Question
    - Add field question to choice

通过运行makemigrations，您告诉Django，您已经对模型进行了一些更改（在这种情况下，您已经创建了新的模型），并希望将更改存储为migration。

Migrations是Django如何存储你的模型（以及数据库schema）的更改 - 它们只是磁盘上的文件。
如果你喜欢，您可以阅读新model的migration; 就是这个polls/migrations/0001_initial.py。别担心，Django不会每次都读取它们，但是他们是被设计可以编辑的，万一你想手动调整Django如何更改内容。

有一个命令可以为你运行migrations并自动管理数据库schema-这叫做migrate，我们稍后会介绍 - 首先，我们来看看migration命令将运行什么SQL。sqlmigrate命令接受迁移名称并返回其SQL：

python manage.py sqlmigrate polls 0001

您应该看到类似于以下内容（我们已将其重新格式化为可读性）：

BEGIN;
--
-- Create model Choice
--
CREATE TABLE "polls_choice" (
    "id" serial NOT NULL PRIMARY KEY,
    "choice_text" varchar(200) NOT NULL,
    "votes" integer NOT NULL
);
--
-- Create model Question
--
CREATE TABLE "polls_question" (
    "id" serial NOT NULL PRIMARY KEY,
    "question_text" varchar(200) NOT NULL,
    "pub_date" timestamp with time zone NOT NULL
);
--
-- Add field question to choice
--
ALTER TABLE "polls_choice" ADD COLUMN "question_id" integer NOT NULL;
ALTER TABLE "polls_choice" ALTER COLUMN "question_id" DROP DEFAULT;
CREATE INDEX "polls_choice_7aa0f6ee" ON "polls_choice" ("question_id");
ALTER TABLE "polls_choice"
  ADD CONSTRAINT "polls_choice_question_id_246c99a640fbbd72_fk_polls_question_id"
    FOREIGN KEY ("question_id")
    REFERENCES "polls_question" ("id")
    DEFERRABLE INITIALLY DEFERRED;

COMMIT;

请注意以下事项：

• 具体的输出将取决于你正在使用的数据库。以上示例为PostgreSQL生成。

• 表名是通过组合app（polls）的名称自动生成的和模型的小写名字- question和 choice。（您可以覆盖此行为。）

• 主键（ID）将自动添加。（你也可以重写这个。）

• 按照惯例，Django附加"_id"到外键字段名称。（是的，你也可以覆盖这个。）

• 外键关系是通过FOREIGN KEY约束来明确的 。不要担心DEFERRABLE部分; 这只是告诉PostgreSQL不执行外键直到事务结束。FOREIGN KEYDEFERRABLE

• 它适合你使用的数据库，因此数据库特定的字段类型如auto_increment（MySQL）,serial（PostgreSQL）或integer primary key autoincrement（SQLite）会自动为你处理。引用字段名称也是如此，例如使用双引号或单引号。

• sqlmigrate命令实际上不会在数据库上运行migration - 它只是打印到屏幕上，以便你可以看到Django认为需要什么SQL 。检查Django要执行的操作或者是否有需要进行更改SQL脚本的数据库管理员很有用。

如果你有兴趣，你也可以运行**python manage.py check **; 这将检查项目中的任何问题，而不进行迁移或修改数据库。

现在，再次运行migrate以在数据库中创建这些模型表：

$ python manage.py migrate
Operations to perform:
  Apply all migrations: admin, auth, contenttypes, polls, sessions
Running migrations:
  Rendering model states... DONE
  Applying polls.0001_initial... OK

migrate命令找到所有尚未应用的migrations（Django通过在你数据库中的一张特殊的表django_migrations追踪哪些被应用了），并根据数据库运行它们 - 本质上是将你对模型所做的更改同步到数据库的schema上。

在你开发项目时，随着时间的推移，migration非常强大，你可以随时更改模型，而无需删除数据库或表，或创建新的- 它专门用于实时升级数据库，而不会丢失数据。我们将在本教程的后续部分中更深入地介绍它们，但是现在，请记住进行模型更改的三步指南：

• 改变你的模型（在 models.py）。
• 运行python manage.py makemigrations以创建这些更改的迁移
• 运行python manage.py migrate以将这些更改应用于数据库。

有单独的命令来制作和应用migrations的原因是因为你将提交migrations到版本控制系统并将其发送到你的应用程序; 它们不仅可以使你的开发更容易，而且还可以被其他开发人员和生产中使用。

请阅读django-admin文档，了解有关manage.py实际作用的完整信息。

使用API
现在，让我们进入交互式的Python shell，并使用Django提供的免费API。
要调用Python shell，请使用以下命令：

python manage.py shell

我们使用这个，而不是简单地输入“python”，因为
manage.py设置了DJANGO_SETTINGS_MODULE
环境变量，这给Django提供了你的mysite/settings.py文件的Python导入路径。

绕过manage.py
如果你不想使用manage.py，没问题。只要设置 DJANGO_SETTINGS_MODULE环境变量
mysite.settings
，启动一个简单的Python shell，并设置Django：

>>> import django
>>> django.setup()

如果这引发了一个问题AttributeError，你可能会使用一个与本教程版本不符的Django版本。
你将需要切换到较旧的教程或较新的Django版本。
你必须从manage.py的目录运行python
，或者确保该目录位于Python路径上，这样import mysite才能 正常工作。

有关所有这些的更多信息，请参阅django-admin文档。

一旦你进入到shell中，那就探索数据库的API吧：

>>> from polls.models import Question, Choice   # 导入我们刚写的模型类

# 系统中还没有问题
>>> Question.objects.all()
<QuerySet []>

# 创建一个新的问题
# 在默认设置文件中启用对时区的支持，所以
# Django 需要一个tzinfo的datetime为pub_date。使用timezone.now()
# 而不是datetime.datetime.now()，它会做正确的事
>>> from django.utils import timezone
>>> q = Question(question_text="What's new?", pub_date=timezone.now())

# 将对象保存到数据库. 你需要明确的调用save()方法
>>> q.save()

#现在它有id了. 需要注意的是可能是"1L"而不是"1"，这要看你使用的是哪一个数据库了。这不能说明它蠢，这只是意味着你的数据库后台更喜欢返回整数作为Python的长整数对象。
>>> q.id
1

# 通过Python属性访问模型的字段值。
>>> q.question_text
"What's new?"
>>> q.pub_date
datetime.datetime(2012, 2, 26, 13, 0, 0, 775217, tzinfo=<UTC>)

# 通过改变属性改变字段值，然后调用save()方法
>>> q.question_text = "What's up?"
>>> q.save()

# objects.all() 方法展示数据库中所有的问题
>>> Question.objects.all()
<QuerySet [<Question: Question object>]>

等一下。<Question: Question object>完全是这个对象的无益表示。让我们通过编辑Questionmodel(在 polls/models.py中)并且对Question和Choice添加str()方法来修复它。

from django.db import models
from django.utils.encoding import python_2_unicode_compatible

@python_2_unicode_compatible  # only if you need to support Python 2
class Question(models.Model):
    # ...
    def __str__(self):
        return self.question_text

@python_2_unicode_compatible  # only if you need to support Python 2
class Choice(models.Model):
    # ...
    def __str__(self):
        return self.choice_text

为模型
添加str()方法非常重要，这不仅在处理交互式提示时方便你使用，还因为Django自动生成的管理员中使用了对象的表示。

注意有些普通的Python方法。我们添加一个自定义的方法，只是为了演示：

import datetime

from django.db import models
from django.utils import timezone


class Question(models.Model):
    # ...
    def was_published_recently(self):
        return self.pub_date >= timezone.now() - datetime.timedelta(days=1)

请注意import datetime和from django.utils import timezone的添加
，分别参考Python的标准
datetime模块和Django的时区相关的公共程序（django.utils.timezone）。
如果您不熟悉Python中的时区处理，您可以在
时区支持文档中了解更多信息。

保存这些更改并通过运行python manage.py shell重新启动一个新的Python交互式shell ：

>>> from polls.models import Question, Choice

# 确保我们添加的 __str__() 方法有效
>>> Question.objects.all()
<QuerySet [<Question: What's up?>]>

# Django 提供了一个完全由关键字参数驱动的丰富的数据库查找API 
>>> Question.objects.filter(id=1)
<QuerySet [<Question: What's up?>]>
>>> Question.objects.filter(question_text__startswith='What')
<QuerySet [<Question: What's up?>]>

# 查找今年发布的问题
>>> from django.utils import timezone
>>> current_year = timezone.now().year
>>> Question.objects.get(pub_date__year=current_year)
<Question: What's up?>

# 请求一个不存在的ID,会导致异常
>>> Question.objects.get(id=2)
Traceback (most recent call last):
    ...
DoesNotExist: Question matching query does not exist.

# 根据关键字查找是很普遍的情况, 所以Django提供了一种主键精确查找的快捷方式
# 以下和Question.objects.get(id=1)相同
>>> Question.objects.get(pk=1)
<Question: What's up?>

# 确保我们的自定义方法有效
>>> q = Question.objects.get(pk=1)
>>> q.was_published_recently()
True

# 给Question几个Choice. INSERT语句创建调用构造一个新的Choice 
对象，将Choice添加到可用choice的集合
中，并返回新的“Choice”对象。Django创建
一个集合来保存ForeignKey关系的“另一面” 
（例如一个question的choice），可以通过API访问它。
>>> q = Question.objects.get(pk=1)

# 显示相关对象集中的任何choice - 至今没有。
>>> q.choice_set.all()
<QuerySet []>

# 创建3个choices.
>>> q.choice_set.create(choice_text='Not much', votes=0)
<Choice: Not much>
>>> q.choice_set.create(choice_text='The sky', votes=0)
<Choice: The sky>
>>> c = q.choice_set.create(choice_text='Just hacking again', votes=0)

# Choice 对象可以访问其相关的 Question 对象.
>>> c.question
<Question: What's up?>

# 反之亦然：Qestion对象可以访问Choice对象。
>>> q.choice_set.all()
<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>
>>> q.choice_set.count()
3

＃API根据需要自动遵循关系。
＃使用双重下划线来分隔关系。
＃这样可以像你想要的那样深层次的工作; 没有限制 
＃查找pub_date在今年的任何问题的所有选项
＃（重复使用上面创建的'current_year'变量）。
>>> Choice.objects.filter(question__pub_date__year=current_year)
<QuerySet [<Choice: Not much>, <Choice: The sky>, <Choice: Just hacking again>]>

# 使用delete()方法删除其中之一个choice
>>> c = q.choice_set.filter(choice_text__startswith='Just hacking')
>>> c.delete()

介绍Django的admin

为您的员工或客户生成添加，更改和删除内容的管理网站是繁琐的工作，不需要太多的创造力。为此，Django完全自动创建模型的管理界面。

Django被写在新闻编辑室环境中，“内容发布者”和“公共”网站之间的界限非常明确。网站管理人员使用该系统添加新闻故事，事件，体育比分等，该内容显示在公共站点上。Django解决了为站点管理员创建统一界面来编辑内容的问题。

管理员不打算由网站访问者使用。是为了网站管理人员使用的。

创建管理员
我们首先需要创建一个可以登陆管理网站的角色。我们执行以下命令：

python manage.py createsuperuser

输入你想要的并敲回车键

Username: admin

然后输入你的email地址：

Email address: admin@exmple.com

最后一步是输入你的密码，你会被要求输入两次密码，第二次是确认你的密码。

Password: **********
Password: **********
Superuser created successfully.

开始开发服务器
Django的管理网站是默认激活的。让我们开始开发并探索服务器吧。
如果服务器不在运行，想这样运行它：

python manage.py runserver

现在，打开一个Web浏览器，然后转到本地域的“/admin /” - 例如 http://127.0.0.1:8000/admin/。您应该看到管理员的登录屏幕：

avatar

由于翻译是默认开启的，登录屏幕可以用你自己的语言显示，这取决于你的浏览器的设置，如果Django有这门语言的翻译。

进入管理网站
现在尝试使用你在前一步创建的管理员账户登录网站。你将会看到Django管理网站的首页：

avatar

你应该看到几种类型的可编辑内容：groups和users。
它们由Django 提供的认证框架django.contrib.auth提供的。

使poll应用在管理网站可编辑*
但是我们的poll应用呢？它没有展示在admin模块的首页。

只需要做一件事：我们需要告诉admin模块,Question对象是有界面的。为了这么做，打开polls/admin.py文件，像这样修改它：

from django.contrib import admin
from .models import Question

admin.sit.register(Question)

探索免费的管理功能

既然我们注册了Question，Django就知道它应该在首页展示了：

avatar

点击"Question"。现在你在questions的"change list"页面。这个页面展示了数据库中所有的问题，并且你可以选择其中一个并修改它。这是我们早先创建的"What's up?"问题：

avatar

点击"What's up?问题去修改它：

avatar

注意事项：

• 表单是从Question模型自动生成的。

• 不同的模型字段类型（DateTimeField， CharField）对应于适当的HTML输入控件。每种类型的字段知道如何在Django管理模块中显示自己。

• 每个DateTimeField都有免费的JavaScript快捷方式。日期有“Today”快捷方式和日历弹出窗口，并且时间获取“Now”快捷方式和一个方便的弹出窗口，列出常用的时间。

页面底部提供了几个选项：

• 保存 - 保存更改并返回到此类型对象的更改列表页面。

• 保存并继续编辑 - 保存更改并重新加载此对象的管理页面。

• 保存并添加另一个 - 保存更改并加载此类型对象的新的空白表单。

• 删除 - 显示删除确认页面。

如果“Date published”的值与教程1中创建问题的时间不匹配，则可能意味着您忘记了设置TIME_ZONE的正确值。更改它，重新加载页面，并检查是否显示正确的值。

点击“Today”和“Noew”快捷方式来更改“Date published”。然后点击“Save and continue editing”，然后点击右上角的“History”。
您将看到一个页面，其中列出了通过Django管理员对此对象所做的所有更改，以及进行更改的人员的时间戳和用户名：

avatar

当您对模型API感到满意并熟悉管理员网站时，请阅读本教程的第3部分，了解如何向我们的投票应用添加更多视图。