Django小例子 – 模型数据的模板呈现

Published: 2014-08-21

Tags: Django Python

本文总阅读量

首先假设一个简单的场景,数据库中存放着作者和书目的信息。这是一种多对多(ManyToMany)的结构,因为一个作者可以写多本书,一本书也可能由多个作者共同完成。我们如何使用Django来创建项目,配置数据库,创建视图,模板,配置URL路由,最后在浏览器访问我们动态创建的页面、

如下的部分算作是记录,也会简单的说明下Django的工作原理。入果是新手,估计看看也会有所收获,能对Django有个大概的了解。想系统的学习Django的小伙伴推荐你看《Django Book(中文版)》,这个文档有些年头,不过最近学习来看,原理和基本操作都没变,就是目录结构随着版本的升级发生变化,没啥大的影响,如英语可以,看Django官方文档当然是最好的。

假设你已经配置好了Django的环境。那么使用如下命令,创建我们的项目:

django-admin.py startproject project
cd project
python mamages.py startapp blog

这样我们就创建完成一个基本的项目了。来tree一下看看:

[root@Init-smile project]# tree

结果

.
├── blog
│   ├── admin.py
│   ├── __init__.py
│   ├── migrations
│   │   └── __init__.py
│   ├── models.py
│   ├── tests.py
│   └── views.py
├── manage.py
└── project
    ├── __init__.py
    ├── settings.py
    ├── urls.py
    └── wsgi.py

3 directories, 11 files

需要修改的文件是settings.py,在里面注册我们新建的APP,并且配置mysql数据库。找到

INSTALLED_APPS = (
    'django.contrib.admin',
    'django.contrib.auth',
    'django.contrib.contenttypes',
    'django.contrib.sessions',
    'django.contrib.messages',
    'django.contrib.staticfiles',
    'blog'
)

添加APP,按如下的事例配置数据库,NAME,USER,PASSWORD换成你的。

DATABASES = {
    'default': {
        'ENGINE': 'django.db.backends.mysql',
        #'NAME': os.path.join(BASE_DIR, 'db.sqlite3'),
        'NAME': 'AuthBooks',
        'USER': 'root',
        'PASSWORD': '123456',
    }
}

接下来,配置URL路由,修改urls.py,这个的作用就是匹配网址,提交给views.py进行处理

from django.conf.urls import patterns, include, url
from django.contrib import admin

urlpatterns = patterns('',
    # Examples:
    # url(r'^$', 'project.views.home', name='home'),
    # url(r'^blog/', include('blog.urls')),

    url(r'^admin/', include(admin.site.urls)),
    url(r'^author/$', 'blog.views.show_author'),
    url(r'^book/$', 'blog.views.show_book'),
)

这样,我们的网址如127.0.0.1/author和127.0.0.1/book就会对应进入不同的处理函数来对他们进行处理,接下来我们就编写views.py,实现相应功能。等等,在这之前,我们必须先了解下数据库,了解下如何建立数据,初始化表,获取数据。这样我们才能继续进行。在models.py模块中来定义我们的表如下,有Author,Book表,Author保存着作者名,Book保存着书名和作者名

from django.db import models

# Create your models here.

class Author(models.Model):
        name = models.CharField(max_length=30)

        def __unicode__(self):
                return self.name

class Book(models.Model):
        name = models.CharField(max_length=30)
        authors = models.ManyToManyField(Author)

        def __unicode__(self):
                return self.name

接下来,要初始化数据库。使用如下命令。

python manage.py syncdb
Operations to perform:
Apply all migrations: admin, contenttypes, auth, sessions
Running migrations:
Applying contenttypes.0001_initial… OK
Applying auth.0001_initial… OK
Applying admin.0001_initial… OK
Applying sessions.0001_initial… OK

You have installed Django’s auth system, and don’t have any superusers defined.
Would you like to create one now? (yes/no):

这里问我们是不是建立一个管理账户。我们选择Yes,然后根据提示创建完成。去项目根目录看看是不是有一个名为db.sqlite3的数据库了~

接下来,我们通过项目提供的shell练习一下添加作者,书籍等数据。然后再到views.py模块中进行处理。

python manage.py shell

这样,我们就进入了一个django为我们配置好的shell环境,我们可以方便的导入相关的模块而不必担心not found问题。

接下来运行如下一系列命令。来为数据库添加记录

from blog.models import Author, Book
Author.objects.create(name='sin')
Author.objects.create(name='sun')
Author.objects.create(name='lin')
b1 = Book()
b1.name = 'book1'
b1.save()
b2 = Book()
b2.name = 'book2'
b2.save()
b3 = Book()
b3.name = 'book3'
b3.save()
sin = Author.objects.get(name__exact='sin')
sun = Author.objects.get(name__exact='sun')
lin = Author.objects.get(name__exact='lin')
b1.authors.add(sin)
b1.authors.add(sun)
b2.authors.add(sun)
b3.authors.add(sun)
b3.authors.add(lin)

根据上面的命令就可以建立起如下图所示的Authors-Books对应关系

author-book.png

补充一些常用命令 (根据书本查作者) 查询每本书对应的作者:

>>> b1.authors.all()
[<Author: sin>, <Author: sun>]
>>> b2.authors.all()
[<Author: sun>]
>>> b3.authors.all()
[<Author: sun>, <Author: lin>]

查询书中的指定作者看是否存在

b1.authors.filter(name__exact='sin')

删除书的作者:

b1.authors.remove(sun)

(根据作者查询他出的书)

>>> sin.book_set.all()
[<Book: book1>]
>>> sun.book_set.all()
[<Book: book1>, <Book: book2>, <Book: book3>]
>>> lin.book_set.all()
[<Book: book3>]

事实上,book_set相当于前面使用的objects

>>> sin.book_set.add(b3)
>>> sin.book_set.remove(b3)
>>> sin.book_set.all()
[<Book: book1>]

为作者添加新的书目:

sin.book_set.create(name='book4')

如上的命令都是封装好的数据库操作指令,所做的所有改动都会保存在数据库中。下面,就可以进行view.py的配置,和模板的编写,来在html上直观的显示出作者和书目的对应关系 view.py内容如下,它就是用来处理对应的URL都做什么,在这里是返回处理过的模板

from django.shortcuts import render_to_response
from blog.models import Author, Book

# Create your views here.

def show_author(request):
        authors = Author.objects.all()
        return render_to_response('show_author.html', {'authors':authors})

def show_book(request):
        books = Book.objects.all()
        return render_to_response('show_book.html', {'books':books})

在blog的目录下新建templates文件夹,这是系统默认的模板搜索路径,所以直接在里面新建show_author.html 内容如下:

{% for author in authors %}
        <div>
                <h3>{{ author.name }}</h3>
                {% for book in author.book_set.all %}
                <li>{{ book.name }}</li>
                {% endfor %}
        </div>
{% endfor %}

再建立show_book.html,内容如下:

{% for book in books %}
        <h3>{{ book.name }}</h3>
        <div>
                {% for author in book.authors.all %}
                        <li>{{ author.name }}</li>
                {% endfor %}
        </div>
{% endfor %}

OK,如上就是构建django项目创建APP,配置数据库,添加数据,配置URL路由,编写视图,模板的所有内容了。 下面来运行我们的项目,并在浏览器端访问。

在project目录下运行 python manage.py runserver

这样,你在本地通过 127.0.0.1:8000/author127.0.0.1:8000/book 就可以看到效果了

如果你的虚拟机使用的是桥接上网方式,那么使用如下命令 python manage.py runserver 0.0.0.0:80 就可以在物理机访问虚拟机的IP了。你可能需要关闭iptables

好的,看看是不是和我的运行结果一样呢~