django book多站点学习

情景1：多站点间复用数据

正如我们在第一章里所讲，Django 构建的网站 LJWorld.com 和 Lawrance.com 是用由同一个新闻组织控制的： 肯萨斯州劳伦斯市的 劳伦斯日报世界 报纸。 LJWorld.com 主要做新闻，而 Lawrence.com 关注本地娱乐。 然而有时，编辑可能需要把一篇文章发布到 两个 网站上。

解决此问题的死脑筋方法可能是使用每个站点分别使用不同的数据库，然后要求站点维护者把同一篇文章发布两次： 一次为 LJWorld.com，另一次为Lawrence.com。 但这对站点管理员来说是低效率的，而且为同一篇文章在数据库里保留多个副本也显得多余。

更好的解决方案？ 两个网站用的是同一个文章数据库，并将每一篇文章与一个或多个站点用多对多关系关联起来。 Django 站点框架提供数据库表来记载哪些文章可以被关联。 它是一个把数据与一个或多个站点关联起来的钩子。

情景2：把网站的名字/域名保存在一个地方

LJWorld.com 和 Lawrence.com 都有邮件提醒功能，使读者注册后可以在新闻发生后立即收到通知。 这是一种完美的的机制： 某读者提交了注册表单，然后马上就受到一封内容是“感谢您的注册”的邮件。

把这个注册过程的代码实现两遍显然是低效、多余的，因此两个站点在后台使用相同的代码。 但感谢注册的通知在两个网站中需要不同。 通过使用 Site 对象，我们通过使用当前站点的 name (例如 'LJWorld.com' )和 domain (例如 'www.ljworld.com' )可以把感谢通知抽提出来。

Django 的多站点框架为你提供了一个位置来存储 Django 项目中每个站点的 name 和 domain ，这意味着你可以用同样的方法来重用这些值。

如何使用多站点框架

多站点框架与其说是一个框架，不如说是一系列约定。 所有的一切都基于两个简单的概念：

• 位于 django.contrib.sites 的 Site 模型有 domain 和 name 两个字段。

• SITE_ID 设置指定了与特定配置文件相关联的 Site 对象之数据库 ID。

如何运用这两个概念由你决定，但 Django 是通过几个简单的约定自动使用的。

安装多站点应用要执行以下几个步骤：

1. 将 'django.contrib.sites' 加入到 INSTALLED_APPS 中。

1. 运行 manage.py syncdb 命令将 django_site 表安装到数据库中。 这样也会建立默认的站点对象，域名为 example.com。

1. 把 example.com 改成你自己的域名，然后通过Django admin站点或Python API来添加其他 Site 对象。 为该 Django 项目支撑的每个站（或域）创建一个 Site 对象。

1. 在每个设置文件中定义一个 SITE_ID 变量。 该变量值应当是该设置文件所支撑的站点 Site 对象的数据库 ID。

多站点框架的功能

下面几节讲述的是用多站点框架能够完成的几项工作。

from django.db import models

from django.contrib.sites.models import Site

class Article(models.Model):

    headline = models.CharField(max_length=200)

    # ...

    sites = models.ManyToManyField(Site)

from django.conf import settings

from django.shortcuts import get_object_or_404

from mysite.articles.models import Article

def article_detail(request, article_id):

    a = get_object_or_404(Article, id=article_id, sites__id=settings.SITE_ID)

    # ...

from django.db import models

from django.contrib.sites.models import Site

class Article(models.Model):

    headline = models.CharField(max_length=200)

    # ...

    site = models.ForeignKey(Site)

from django.conf import settings

def my_view(request):

    if settings.SITE_ID == 3:

        # Do something.

    else:

        # Do something else.

from django.conf import settings

from django.contrib.sites.models import Site

def my_view(request):

    current_site = Site.objects.get(id=settings.SITE_ID)

    if current_site.domain == 'foo.com':

        # Do something

    else:

        # Do something else.

from django.contrib.sites.models import Site

def my_view(request):

    current_site = Site.objects.get_current()

    if current_site.domain == 'foo.com':

        # Do something

    else:

        # Do something else.

from django.contrib.sites.models import Site

from django.core.mail import send_mail

def register_for_newsletter(request):

    # Check form values, etc., and subscribe the user.

    # ...

    current_site = Site.objects.get_current()

    send_mail('Thanks for subscribing to %s alerts' % current_site.name,

        'Thanks for your subscription. We appreciate it.\n\n-The %s team.' % current_site.name,

        'editor@%s' % current_site.domain,

        [user_email])

    # ...

from django.core.mail import send_mail

from django.template import loader, Context

def register_for_newsletter(request):

    # Check form values, etc., and subscribe the user.

    # ...

    subject = loader.get_template('alerts/subject.txt').render(Context({}))

    message = loader.get_template('alerts/message.txt').render(Context({}))

    send_mail(subject, message, 'do-not-reply@example.com', [user_email])

    # ...

当前站点管理器

如果 站点 在你的应用中扮演很重要的角色，请考虑在你的模型中使用方便的 CurrentSiteManager 。 这是一个模型管理器（见第十章），它会自动过滤使其只包含与当前站点相关联的对象。

通过显示地将 CurrentSiteManager 加入模型中以使用它。 例如：

from django.db import models

from django.contrib.sites.models import Site

from django.contrib.sites.managers import CurrentSiteManager

class Photo(models.Model):

    photo = models.FileField(upload_to='/home/photos')

    photographer_name = models.CharField(max_length=100)

    pub_date = models.DateField()

    site = models.ForeignKey(Site)

    objects = models.Manager()

    on_site = CurrentSiteManager()

通过该模型， Photo.objects.all() 将返回数据库中所有的 Photo 对象，而 Photo.on_site.all() 仅根据 SITE_ID 设置返回与当前站点相关联的 Photo 对象。

换言之，以下两条语句是等效的：

Photo.objects.filter(site=settings.SITE_ID)

Photo.on_site.all()

CurrentSiteManager 是如何知道 Photo 的哪个字段是 Site 呢？缺省情况下，它会查找一个叫做 site 的字段。如果你的模型包含了名字 不是 site 的 外键 或者 多对多 关联，你需要把它作为参数传给 CurrentSiteManager 以显示指明。下面的模型拥有一个 publish_on 字段：

from django.db import models

from django.contrib.sites.models import Site

from django.contrib.sites.managers import CurrentSiteManager

class Photo(models.Model):

    photo = models.FileField(upload_to='/home/photos')

    photographer_name = models.CharField(max_length=100)

    pub_date = models.DateField()

    publish_on = models.ForeignKey(Site)

    objects = models.Manager()

    on_site = CurrentSiteManager('publish_on')

如果试图使用 CurrentSiteManager 并传入一个不存在的字段名， Django 将引发一个 ValueError 异常。

注意

即便是已经使用了 CurrentSiteManager ，你也许还想在模型中拥有一个正常的（非站点相关）的 管理器 。正如在附录 B 中所解释的，如果你手动定义了一个管理器，那么 Django 不会为你创建全自动的 objects = models.Manager() 管理器。

同样，Django 的特定部分（即 Django 超级管理站点和通用视图）使用在模型中定义 的 第一个 管理器，因此如果希望管理站点能够访问所有对象（而不是仅仅站点特有对象），请于定义 CurrentSiteManager 之前在模型中放入 objects = models.Manager() 。

Django如何使用多站点框架

尽管并不是必须的，我们还是强烈建议使用多站点框架，因为 Django 在几个地方利用了它。 即使只用 Django 来支持单个网站，你也应该花一点时间用 domain 和 name 来创建站点对象，并将 SITE_ID 设置指向它的 ID 。

以下讲述的是 Django 如何使用多站点框架：

• 在重定向框架中（见后面的重定向一节），每一个重定向对象都与一个特定站点关联。 当 Django 搜索重定向的时候，它会考虑当前的 SITE_ID 。

• 在注册框架中，每个注释都与特定站点相关。 每个注释被显示时，其 site 被设置为当前的 SITE_ID ，而当通过适当的模板标签列出注释时，只有当前站点的注释将会显示。

• 在 flatpages 框架中 (参见后面的 Flatpages 一节），每个 flatpage 都与特定的站点相关联。 创建 flatpage 时，你都将指定它的 site ，而 flatpage 中间件在获取 flatpage 以显示它的过程中，将查看当前的 SITE_ID 。

• 在 syndication 框架中（参阅第 13 章）， title 和 description 的模板会自动访问变量 {{ site }} ，它其实是代表当前站点的 Site 对象。 而且，如果你不指定一个合格的domain的话，提供目录URL的钩子将会使用当前“Site”对象的domain。

• 在权限框架中（参见十四章），视图 django.contrib.auth.views.login 把当前 Site 名字和对象分别以 {{ site_name }} 和 {{ site }} 的形式传给了模板。