从头开始
概要
Django 初探
由于django是在新闻编辑应用中快速发展起来的,所以他被设计的很适合web快速简易开发。这是个简单的概要,介绍如何通过Django编写web应用程序的数据库驱动。
这篇文档的目的是给予你足够的技术细节来理解Django是如何工作的,
但是这并不打算替代辅导资料(tutorial)和参考文档(reference),因为这两个都有了。当你准备开始一个项目,你可以从辅导资料开始或去看更多的文档细节 。
设计你的模型
当然你可以在使用django的时候不使用数据库,你可以用python代码描述数据库格局,绘制对象关系。
数据模型语法提供许多方法来描绘你的模型,到目前为止已经是应用了两年的数据库方案。
下面是一个例子
class Reporter(models.Model):
full_name = models.CharField(max_length=70)
def __unicode__(self):
return self.full_name
class Article(models.Model):
pub_date = models.DateTimeField()
headline = models.CharField(max_length=200)
content = models.TextField()
reporter = models.ForeignKey(Reporter)
def __unicode__(self):
return self.headline
安装
接下来,运行Django 命令行工具自动创建数据库表
manage.py syncdb
syncdb 命令会检查你所有可用的模型并创建目前数据库中还没有创建的表
享用免费的API
这样你已经获得了免费丰富的Python API存取你的数据,API 已经被快速建立,不需要在额外写代码
>>> from mysite.models import Reporter, Article
# No reporters are in the system yet.
>>> Reporter.objects.all()
[]
# Create a new Reporter.
>>> r = Reporter(full_name='John Smith')
# Save the object into the database. You have to call save() explicitly.
>>> r.save()
# Now it has an ID.
>>> r.id
1
# Now the new reporter is in the database.
>>> Reporter.objects.all()
[<Reporter: John Smith>]
# Fields are represented as attributes on the Python object.
>>> r.full_name
'John Smith'
# Django provides a rich database lookup API.
>>> Reporter.objects.get(id=1)
<Reporter: John Smith>
>>> Reporter.objects.get(full_name__startswith='John')
<Reporter: John Smith>
>>> Reporter.objects.get(full_name__contains='mith')
<Reporter: John Smith>
>>> Reporter.objects.get(id=2)
Traceback (most recent call last):
...
DoesNotExist: Reporter matching query does not exist.
# Create an article.
>>> from datetime import datetime
>>> a = Article(pub_date=datetime.now(), headline='Django is cool',
... content='Yeah.', reporter=r)
>>> a.save()
# Now the article is in the database.
>>> Article.objects.all()
[<Article: Django is cool>]
# Article objects get API access to related Reporter objects.
>>> r = a.reporter
>>> r.full_name
'John Smith'
# And vice versa: Reporter objects get API access to Article objects.
>>> r.article_set.all()
[<Article: Django is cool>]
# The API follows relationships as far as you need, performing efficient
# JOINs for you behind the scenes.
# This finds all articles by a reporter whose name starts with "John".
>>> Article.objects.filter(reporter__full_name__startswith="John")
[<Article: Django is cool>]
# Change an object by altering its attributes and calling save().
>>> r.full_name = 'Billy Goat'
>>> r.save()
# Delete an object with delete().
>>> r.delete()
一个动态的管理接口:它不是一个脚手架,而是一个完整的建筑 。
只要你定义好模型,django就能自动创建专业的完备的管理接口,一个让认证的用户修改和删除对象,将你定义的模型注册到管理系统非常简单。
# In models.py...
from django.db import models
class Article(models.Model):
pub_date = models.DateTimeField()
headline = models.CharField(max_length=200)
content = models.TextField()
reporter = models.ForeignKey(Reporter)
# In admin.py in the same directory...
import models
from django.contrib import admin
admin.site.register(models.Article)
这个观念就是 你的网站可以让工作人员,客户或你自己管理,而你不需要去创建后台接口,只是管理内容。
创建django应用的一个典型流程是,建立模型,开启管理系统,因此你的工作人员或客户可以先着手数据,然后将当前数据发布
设计你的 URLS
整齐,简介的URL方案在高质量的网络应用程序中是一个很重要的细节。django赞成设计漂亮的URL并且不使用后缀,像.php或.asp
为应用程序设计URLs,你创建一个Python模块URLconf,一个内容的目录,包含简单的URL规则和返回函数之间的映射,
URLconfs将URLs和python代码解耦。
这是个url为上面Reporter/Article例子的配置
from django.conf.urls.defaults import *
urlpatterns = patterns('',
(r'^articles/(\d)/$', 'mysite.views.year_archive'),
(r'^articles/(\d)/(\d)/$', 'mysite.views.month_archive'),
(r'^articles/(\d)/(\d)/(\d+)/$', 'mysite.views.article_detail'),
)
上面的代码以正则表达式的方式映射URLs到目标返回函数(视图)。
正则表达式用括号捕获URL上的数值,当用户请求一个页面,django遍历每个方式,按次序并停止在第一个匹配的请求URL,
(如果没有匹配,Django会调用404视图显示),这个速度是显著的,因为正则表达式在程序装载的时候编译。
只要一个正则匹配,django就会输入并调用给定的视图,一个简单的python函数。每个视图会传递一个request对象,包含请求的元数据。
和URL 上捕获的数据
例如,如果用户请求URL"/articles/2005/05/39323/", DJANGg会调用函数mysite.views.article_detail(request, '2005', '05', '39323').
编写你的视图
每个视图会回应两种情况中的一个,返回一个HttpResponse 对象包括请求的内容,或报异常想Http404.
通常,一个视图根据参数接受数据,加载一个末班并用数据渲染模板,这是一个year_archive视图的例子
def year_archive(request, year):
a_list = Article.objects.filter(pub_date__year=year)
return render_to_response('news/year_archive.html', {'year': year, 'article_list': a_list})
这个例子用到里django的模板系统,是个有些强大的功能但是力求简单可以让非程序员使用。
设计你的模板
上面的程序会加载这个 news/year_archive.html 模板.
django有一个模板路径,让你缩小范围。在你的django配置里,你可以指定一个模板的目录列表。
如果模板不存在第一个目录里,会继续检查第二个目录,以此类推。
让我们说下 news/article_detail.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 的标题行,
但是句点不只是用在查找属性,还可以用来查找字典的键,调用函数方法。
{{ article.pub_date|date:"F j, Y" }} 使用unix管道风格,字符“|”,
这个称为模板过滤,这是过滤变量的数值的方法。在这种情况下,python日期对象被格式化为
给定的日期格式(像php里的日期函数;确实在PHP里是个好方法)
你喜欢的话可以把好多个过滤器连接起来用,你可以自定义过滤器,写自己的模板标记,在这里
运行自己的python程序代码
最后,django使用 {% extends "base.html" %} 模板继承的构想,就是首先加载名字为base的模板,
base模板里定义好一连串的块(block),之后的块会填充到这个块,总之,那会让我们去掉模板多余的部分
每个模板只需要定义自己唯一的部分
下面是这个base.html模板
<html>
<head>
<title>{% block title %}{% endblock %}</title>
</head>
<body>
<img src="sitelogo.gif" alt="Logo" />
{% block content %}{% endblock %}
</body>
</html>