残阳似血的博客

相信大家都用过微博，我们在微博的timeline中，常常可以看到文字、音乐、视频等等的混合。所有的内容都聚合在一起显示出来。具体的实现未可知，但是在Django中，我们有比较优雅的方式。那就是使用contenttypes模块来实现。

现在我们假设对于一条微博只有三种方式（其他的很容易拓展）：文本，音乐以及视频。我们先定义三个简单的Model。（注意到Music和Video只要简单继承Tweet类即可。）

from django.db import models
from django.contrib.auth.models import User

class Tweet(models.Model):
    user = models.ForeignKey(User) # 这里就用Django自带的User
    content = models.CharField(max_length=140) # 内容，最多140字
    pic_url = models.URLField(null=True, blank=True)
    created = models.DateTimeField(auto_now_add=True)
    
    class Meta:
        ordering = ['-created',]
        
    def __unicode__(self):
        return self.content
    
class Music(Tweet):
    music_url = models.URLField(verify_exists=False)
    
class Video(Tweet):
    video_url = models.URLField(verify_exists=False)

为了使无论什么类型的微博都显示在timeline中，我们就需要单独用一张表来存放用户的行为（event）。作者在添加一条微博的时候，就会自动记录用户的事件。记录用户事件的表中，我们当然要记录用户的微博类型，以及如何找到这个对象。但是这里我们就有三个model，这个时候Django中的contenttypes framework就派上了用场。官方文档在这里。其中的核心类是ContentType，它的作用很简单，其实就是储存了一个Model的信息，通过它我们就可以还原这个Model。ContentType代码像这样：

class ContentType(models.Model):  
    name = models.CharField(max_length=100)  
    app_label = models.CharField(max_length=100)  
    model = models.CharField(_('python model class name'), max_length=100)  
    objects = ContentTypeManager()  

app_label是这个Model所在的app名称，model是Model的类名，name是Model的友好名称，即Model的元类中的verbose_name属性。通过这几个字段，就可以还原出这个Model来。

于是，我们在记录事件的Model中用一个字段表示ContentType，这样我们就能指向任意一个Model。这点颇像C中的void*指针。

让我们来看看Event Model的代码：

from django.contrib.contenttypes.models import ContentType
from django.contrib.contenttypes import generic

class Event(models.Model):
    user = models.ForeignKey(User)
    content_type = models.ForeignKey(ContentType)
    object_id = models.PositiveIntegerField()
    event_object = generic.GenericForeignKey('content_type', 'object_id')

user字段用来指向事件的发起者。conten_type表示任意一个Model，而通过object_id，我们就可以得到这个实例，也就是event_object的作用（GenericForeignKey），这点可以参考官方文档中GenericForeignKey类的说明。

我们在各个Model中再添加一行（本例只需在Tweet中添加即可）：

events = generic.GenericRelation('Event')  

这样，当一个Model实例被删除时，Event中的相关记录也就会被删除。

在结束了这些之后，我们就需要在用户添加一篇微博的时候，来记录这个动作。可能有人就会想到重写Model中的save方法。没错，这样确实可以实现。但是如果有多个类，我们就需要在每个类中都重写这个方法。而且，这么写会破坏原有Model的行为。其实有着更好的方法来实现：使用Signals（官方文档）。

如Signals名字——信号所言，Django中包含一个“Signal dispatcher”（信号调度员，姑且这么翻译吧），其实就是让某个动作（发送者senders）能够让别的应用（receivers）捕捉到。比如说一个Model在保存之前会出发pre_save信号，来让别的程序捕捉。这个模块在多个代码片段捕捉同一个事件的时候就很有用。Signals模块的实现是和Django中内置的生产者消费者模块相关的。当然这个不必深究。

Django提供以下内置信号：

• django.db.models.signals.pre_save & django.db.models.signals.post_save：分别在一个Model的save()方法之前和之后触发。
• django.db.models.signals.pre_delete & django.db.models.signals.post_delete：分别在一个Model的delete()方法之前和之后触发。
• django.db.models.signals.m2m_changed：当一个Model中的ManyToManyField改变时触发。
• django.core.signals.request_started & django.core.signals.request_finished：在django的http请求开始和结束时触发。

在我们的例子里，我们只需要监听几个Model的post_save信号：

from django.db.models.signals import post_save

def post_save_callback(sender, instance, **kwargs):
    '''sender是信号发送者（Model），instance是其实例'''
    obj = instance
    event = Event(user=obj.user, event_object=obj)
    event.save()
        
# 添加dispatch_uid保证每次事件只会被记录一次
post_save.connect(post_save_callback, sender=Tweet, dispatch_uid="my_unique_identifier")

这里的post_save_callback是回调函数，当我们需要注册一个信号的时候，它要作为Singal.connect()方法的第一参数。Django1.3中可以使用装饰器，像这样：

from django.core.signals import post_save
from django.dispatch import receiver

@receiver(post_save, sender=Tweet, dispatch_uid="my_unique_identifier")
def post_save_callback(sender, instance, **kwargs):
    '''函数内容就省略了'''

更多Signals的内容请参考官方文档。

这样就基本上大功告成了。现在，我们用一个简单的Model来表示关注和被关注的用户关系：

class FriendShip(models.Model):
    user = models.ForeignKey(User, related_name='owner')
    follower = models.ForeignKey(User, related_name='follower')

在自动admin中添加一些数据，我们就可以在views中这么写了：

def main(request):
    user = User.objects.get(username="") # 某个用户
    followers = [entry.user for entry in FriendShip.objects.filter(follower=user)] # 这个用户所关注的人
    
    events = Event.objects.filter(user__in=followers)
    
    return render_to_response('twitter/main.html', {'events': events })

最后大家可能也想到了在自动admin中的“最近的动作”也是使用contenttypes实现（所以可以理解为什么使用自动admin，需要依赖django.contrib.contenttypes这个app了）。如果感兴趣，大家可以参阅django.contrib.admin.models以及django.contrib.admin.options中的代码。