Django记录操作日志、LogEntry的使用 - 《python web 开发》

">
1. 使用LogEntry
2. 查询某个对象的变更
3. 在admin页面上查看操作日志

LogEntry是在后台开发中经常用到的模块，它在admin是默认开启的。
可以使用LogEntry模块记录所有用户的操作记录。一方面可以用来监督，另一方面可以用来做回滚。

1. 使用LogEntry

ModelAdmin本身就有日志记录功能。当新建一个实体(Post、Category、Tag)时,ModelAdmin会创建一条变更日志记录。当修改一条内容时，ModelAdmin又会调用LogEntry来创建一条日志，记录这个变更。
ModelAdmin内部提供了两个方法，分别是log_addition和log_change。
log_addition记录新增日志。
log_change记录变更日志。
我们可以看它们的定义来学习LogEntry模块

def log_addition(self, request, object, message):
        """
        Log that an object has been successfully added.
        The default implementation creates an admin LogEntry object.
        """
        from django.contrib.admin.models import LogEntry, ADDITION
        return LogEntry.objects.log_action(
            user_id=request.user.pk,
            content_type_id=get_content_type_for_model(object).pk,
            object_id=object.pk,
            object_repr=str(object),
            action_flag=ADDITION,
            change_message=message,
        )
    def log_change(self, request, object, message):
        """
        Log that an object has been successfully changed.
        The default implementation creates an admin LogEntry object.
        """
        from django.contrib.admin.models import LogEntry, CHANGE
        return LogEntry.objects.log_action(
            user_id=request.user.pk,
            content_type_id=get_content_type_for_model(object).pk,
            object_id=object.pk,
            object_repr=str(object),
            action_flag=CHANGE,
            change_message=message,
        )

从以上代码可以看出：这两个方法都调用了LogEntry.objects.logaction方法，只是参数略有不同，可以看到，如果需要自定义变更记录的话，只需要传递对应的参数即可。以下简要介绍一下这些参数。 <a name=”user-id”>

user_ id

当前用户id。

content_type_id

要保存内容的类型，上面的代码中使用的是get_.content_type_for_model方法拿到对应Model的类型id。这可以简单理解为ContentType为每个Model定义了一个类型id。

object_id

记录变更实例的id,比如PostAdmin中它就是post. id。

object_repr

实例的展示名称，可以简单理解为我们定义的str所返回的内容。

action flag

操作标记。admin的Model里面定义了几种基础的标记: ADDITION、CHANGE和DELETION。它用来标记当前参数是数据变更、新增，还是删除。

change_ message

这是记录的消息，可以自行定义。我们可以把新添加的内容放进去(必要时可以通过这里来恢复),也可以把新旧内容的区别放进去。

理解了这几个参数，如果遇到类似的需求，就能直接使用Django现成的工具来完成了。

2. 查询某个对象的变更

上面我们知道如何记录某个对象的变更日志了，那么问题来了，如何在询已经记录的变更呢？
其实这是简单的Model查询问题。假设我们记录的对象是Post的操作，现在来获取Post中id为1的所有变更日志，大概代码如下：

from django.contrib.admin.models import LogEntry, CHANGE
from django.contrib.admin.options import get_content_type_for_model
post = Post.objects.get(id=1)
log_entries = LogEntry.objects.filter(
    content_type_id=get_content_type_for_model(post).pk,
    object_id=post.id,

3. 在admin页面上查看操作日志

我们既知道如何记录变更日志，也知道如何获取变更日志，那么如何才能够在admin后台方便地查看操作日志呢?
新增如下配置:

from django.contrib.admin.models import LogEntry
@admin.register(LogEntry)
class LogEntryAdmin(admin.ModelAdmin):
    list_display = (
        '__str__', 'action_time', 'user', 'content_type', 'object_id', 'object_repr', 'action_flag', 'change_message')
    list_filter = ('content_type',)
    search_fields = ['user__username', ]
    date_hierarchy = 'action_time'