初识 Django
为了让您充分理解 Django 的工作原理,这份文档为您详细描述了相关的技术细节,不过这并不是一份入门教程或者是参考文档(我们当然也为您准备了这些)。如果您想要马上开始一个项目,可以从 实例教程 开始入手,或者直接开始阅读详细的 。
Django 无需数据库就可以使用,它提供了 对象关系映射器 通过此技术,你可以使用 Python 代码来描述数据库结构。
你可以使用强大的 来描述你的数据模型,这解决了数年以来在数据库模式中的难题。以下是一个简明的例子:
应用数据模型
然后,运行 Django 命令行工具来创建数据库表:
- $ python manage.py migrate
- ...\> py manage.py migrate
这个 命令查找你所有可用的模型并将在数据库中创建那些不存在的表,还可提供了可选的 。
接下来,你就可以使用一套便捷而丰富的 Python API 访问你的数据。这些 API 是即时创建的,而不用显式的生成代码:
一个动态管理接口:并非徒有其表
当你的模型完成定义,Django 就会自动生成一个专业的生产级 管理接口 ——一个允许认证用户添加、更改和删除对象的 Web 站点。你只需简单的在 admin 站点上注册你的模型即可:
mysite/news/models.py
- from django.db import models
- class Article(models.Model):
- pub_date = models.DateField()
- content = models.TextField()
- reporter = models.ForeignKey(Reporter, on_delete=models.CASCADE)
- from django.contrib import admin
- from . import models
- admin.site.register(models.Article)
这样设计所遵循的理念是,站点编辑人员可以是你的员工、你的客户、或者就是你自己——而你大概不会乐意去废半天劲创建一个只有内容管理功能的后台管理界面。
简洁优雅的 URL 规划对于一个高质量 Web 应用来说至关重要。Django 推崇优美的 URL 设计,所以不要把诸如 .php
和 .asp
之类的冗余的后缀放到 URL 里。
为了设计你自己的 ,你需要创建一个叫做 URLconf 的 Python 模块。这是网站的目录,它包含了一张 URL 和 Python 回调函数之间的映射表。URLconf 也有利于将 Python 代码与 URL 进行解耦(译注:使各个模块分离,独立)。
下面这个 URLconf 适用于前面 Reporter
/Article
的例子:
上述代码将 URL 路径映射到了 Python 回调函数(“视图”)。路径字符串使用参数标签从URL中“捕获”相应值。当用户请求页面时,Django 依次遍历路径,直至初次匹配到了请求的 URL。(如果无匹配项,Django 会调用 404 视图。) 这个过程非常快,因为路径在加载时就编译成了正则表达式。
一旦有 URL 路径匹配成功,Django 会调用相应的视图函数。每个视图函数会接受一个请求对象——包含请求元信息——以及在匹配式中获取的参数值。
例如,当用户请求了这样的 URL "/articles/2005/05/39323/",Django 会调用 。
编写视图
视图函数的执行结果只可能有两种:返回一个包含请求页面元素的 HttpResponse
对象,或者是抛出 这类异常。至于执行过程中的其它的动作则由你决定。
通常来说,一个视图的工作就是:从参数获取数据,装载一个模板,然后将根据获取的数据对模板进行渲染。下面是一个 year_archive
的视图样例:
- from django.shortcuts import render
- from .models import Article
- def year_archive(request, year):
- a_list = Article.objects.filter(pub_date__year=year)
- context = {'year': year, 'article_list': a_list}
这个例子使用了 Django ,它有着很多强大的功能,而且使用起来足够简单,即使不是程序员也可轻松使用。
Django 允许设置搜索模板路径,这样可以最小化模板之间的冗余。在 Django 设置中,你可以通过 参数指定一个路径列表用于检索模板。如果第一个路径中不包含任何模板,就继续检查第二个,以此类推。
让我们假设 news/year_archive.html
模板已经找到。它看起来可能是下面这个样子:
mysite/news/templates/news/year_archive.html
- {% extends "base.html" %}
- {% block title %}Articles for {{ year }}{% endblock %}
- {% block content %}
- <h1>Articles for {{ year }}</h1>
- {% for article in article_list %}
- <p>{{ article.headline }}</p>
- <p>By {{ article.reporter.full_name }}</p>
- <p>Published {{ article.pub_date|date:"F j, Y" }}</p>
- {% endfor %}
- {% endblock %}
我们看到变量都被双大括号括起来了。 {{ article.headline }}
的意思是“输出 article 的 headline 属性值”。这个“点”还有更多的用途,比如查找字典键值、查找索引和函数调用。
我们注意到 {{ article.pub_date|date:"F j, Y" }}
使用了 Unix 风格的“管道符”(“|”字符)。这是一个模板过滤器,用于过滤变量值。在这里过滤器将一个 Python datetime 对象转化为指定的格式(就像 PHP 中的日期函数那样)。
你可以将多个过滤器连在一起使用。你还可以使用你 自定义的模板过滤器 。你甚至可以自己编写 ,相关的 Python 代码会在使用标签时在后台运行。
Django 使用了 ''模板继承'' 的概念。这就是 {% extends "base.html" %}
的作用。它的含义是''先加载名为 base 的模板,并且用下面的标记块对模板中定义的标记块进行填充''。简而言之,模板继承可以使模板间的冗余内容最小化:每个模板只需包含与其它文档有区别的内容。
下面是 base.html 可能的样子,它使用了 静态文件 :
mysite/templates/base.html
简而言之,它定义了这个网站的外观(利用网站的 logo),并且给子模板们挖好了可以填的”坑“。这也让网站的改版变得简单无比——你只需更改这个根模板文件即可。
它还可以让你利用不同的基础模板并重用子模板创建一个网站的多个版本。Django 的创建者已经利用这一技术来创造了明显不同的手机版本的网站——只需创建一个新的基础模板。
这仅是基本入门知识
以上只是 Django 的功能性概述。Django 还有更多实用的特性: