Django利用LogEntry生成历史操作实战记录

 更新时间:2021年12月22日 11:02:17   作者:Tsissan's Blog  
LogEntry是在后台开发中经常用到的模块,它在admin是默认开启的。文中给大家介绍了在admin页面上查看操作日志的方法及实战代码,感兴趣的朋友跟随小编一起看看吧

在开发测试平台的时候,虽然对某些关键功能做了权限设置,但毕竟是公司多人使用,有些数据的配置可能不小心被他人修改但未告知其他使用者,造成了诸多不便。所以决定开发一个操作历史表,可以方便查看数据地改动。
LogEntry是在后台开发中经常用到的模块,它在admin是默认开启的。
可以使用LogEntry模块记录所有用户的操作记录。一方面可以用来监督,另一方面可以用来做回滚。

使用LogEntry

ModelAdmin本身就有日志记录功能。当新建一个实体(Post、Category、Tag)时,ModelAdmin会创建一条变更日志记录。当修改一条内容时,ModelAdmin又会调用LogEntry来创建一条日志,记录这个变更。
ModelAdmin内部提供了两个方法,分别是log_addition和log_change。
log_addition记录新增日志。
log_change记录变更日志。
log_deletion记录删除日志。
我们可以看它们的定义来学习LogEntry模块
代码位置:Lib\site-packages\django\contrib\admin\options.py

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,
    )


def log_deletion(self, request, object, object_repr):
    """
    Log that an object will be deleted. Note that this method must be
    called before the deletion.

    The default implementation creates an admin LogEntry object.
    """
    from django.contrib.admin.models import LogEntry, DELETION
    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=object_repr,
        action_flag=DELETION,
    )

从以上代码可以看出:这两个方法都调用了LogEntry.objects.log_action方法,只是参数略有不同,可以看到,如果需要自定义变更记录的话,只需要传递对应的参数即可。以下简要介绍一下这些参数。

  • user_id:当前用户id
  • content_type_id:要保存内容的类型,上面的代码中使用的是get_.content_type_for_model方法拿到对应Model的类型id。这可以简单理解为ContentType为每个Model定义了一个类型id
  • object_id:记录变更实例的id
  • object_repr:实例的展示名称,可以简单理解为我们定义的__str__所返回的内容
  • action_flag:操作标记。admin的Model里面定义了几种基础的标记: ADDITION、CHANGE和DELETION。它用来标记当前参数是数据变更、新增,还是删除。
  • change_message:这是记录的消息,可以自行定义。我们可以把新添加的内容放进去(必要时可以通过这里来恢复),也可以把新旧内容的区别放进去。

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

查询某个对象的变更

上面我们知道如何记录某个对象的变更日志了,那么问题来了,如何在询已经记录的变更呢?
其实这是简单的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).id,
    object_id=post.id)

这样我们就拿到了id为1的所有变更记录了。

在admin页面上查看操作日志

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

#最上面增加import
from django.contrib.admin.models import LogEntry
#文件最下方增加
@adnin.register(LogEntry, site=custom_site)
class LogEntryAdmin(admin.ModelAdmin):
    list_display = ['object_repr','object_ id','action_flag','user','change_message']

这样就可以看到所有的变更记录了。如下图所示:

实战

虽然操作历史显示出来了,但是在django自带的admin后台才能看到,不是所有人都有进入admin后台权限,能不能有一种方法能在前端展示出来让每个人都可以查看呢?
前端代码:

<table class="table table-bordered" style="width: 60%;margin-left: 20%;text-align: center"> 
   <caption style="text-align: center">
    <span style="font-size: large;color: black">项目:【<span style="color: pink">{{ client.name }}</span>】的操作记录: </span>
   </caption> 
   <thead> 
    <tr style="background-color: #cdd8e5"> 
     <th style="width: 100px;text-align: center">操作时间</th> 
     <th style="width: 200px;text-align: center">操作对象</th> 
     <th style="width: 50px;text-align: center">对象id</th> 
     <th style="width: 100px;text-align: center">动作标志</th> 
     <th style="width: 100px;text-align: center">操作用户</th> 
     <th style="width: 300px;text-align: center">修改内容</th> 
    </tr> 
   </thead> 
   <tbody>
     {% for i in objects %} 
    <tr> 
     <td>{{ i.action_time }}</td> 
     <td>{{ i.object_repr }}</td> 
     <td>{{ i.object_id }}</td> 
     <td>{{ i.get_action_flag_display }}</td> 
     <td>{{ i.user }}</td> 
     <td>{{ i.change_message }}</td> 
    </tr> {% endfor %} 
   </tbody> 
  </table>

这里有个坑,如果就利用{{i.action_flag}}获取操作标记的话,得到的是索引值,经过stackoverflow.com查阅,需要利用Django-doc(用您要在其文本表示形式中“翻译”的字段名称替换)来获取相应值,因此:get_fieldname_display,所以这里要写成{{ i.get_action_flag_display }}

后端代码(views.py):

# 导入所需的包
from django.contrib.admin.models import LogEntry, CHANGE, ADDITION, DELETION
from django.contrib.admin.options import get_content_type_for_model

res = dict()
res['objects'] = LogEntry.objects.all()  # 获取到所有操作历史
# 只需要调用LogEntry.objects.log_action方法带入所需参数即可
LogEntry.objects.log_action(
        user_id=request.user.pk,  # 操作用户的id
        content_type_id=get_content_type_for_model(object).pk,  # 对应数据库Model的id
        object_id=object.pk,  # 操作对象的id
        object_repr=object_repr,  # 操作对象的名字
        action_flag=DELETION,  # ADDITION、CHANGE和DELETION三种方式选择合适的
        change_message=''  # 自定义消息,可以放入修改之后的数据
    )

实现效果

参考资料:https://www.cnblogs.com/zihao1037/p/11057341.html

到此这篇关于Django利用LogEntry生成历史操作的文章就介绍到这了,更多相关Django历史操作内容请搜索脚本之家以前的文章或继续浏览下面的相关文章希望大家以后多多支持脚本之家!

相关文章

  • Python Django框架单元测试之文件上传测试示例

    Python Django框架单元测试之文件上传测试示例

    这篇文章主要介绍了Python Django框架单元测试之文件上传测试,结合实例形式分析了Django框架单元测试中文件上传测试的操作步骤与相关实现技巧,需要的朋友可以参考下
    2019-05-05
  • Flask 让jsonify返回的json串支持中文显示的方法

    Flask 让jsonify返回的json串支持中文显示的方法

    下面小编就为大家分享一篇Flask 让jsonify返回的json串支持中文显示的方法,具有很好的参考价值,希望对大家有所帮助。一起跟随小编过来看看吧
    2018-03-03
  • Python使用fliecmp实现比较文件的操作

    Python使用fliecmp实现比较文件的操作

    对于文件的比较一般有几种,比如比较文件的内容,比较文件的大小,或者直接对比整个项目文件,本文就详细的介绍这些方法的实现,感兴趣的可以了解一下
    2021-06-06
  • Python反射的用法实例分析

    Python反射的用法实例分析

    这篇文章主要介绍了Python反射的用法,结合实例形式分析了Python反射机制所涉及的几个常用方法与相关使用技巧,需要的朋友可以参考下
    2018-02-02
  • 关于python中readlines函数的参数hint的相关知识总结

    关于python中readlines函数的参数hint的相关知识总结

    今天给大家带来的是关于Python函数的相关知识,文章围绕着python中readlines函数的参数hint展开,文中有非常详细的介绍及代码示例,需要的朋友可以参考下
    2021-06-06
  • python中的list字符串元素排序

    python中的list字符串元素排序

    这篇文章主要介绍了python中的list字符串元素排序方式,具有很好的参考价值,希望对大家有所帮助。如有错误或未考虑完全的地方,望不吝赐教
    2022-11-11
  • Pygame游戏开发之太空射击实战盾牌篇

    Pygame游戏开发之太空射击实战盾牌篇

    相信大多数8090后都玩过太空射击游戏,在过去游戏不多的年代太空射击自然属于经典好玩的一款了,今天我们来自己动手实现它,在编写学习中回顾过往展望未来,在本课中,我们将为玩家添加一个盾牌以及一个用于显示盾牌等级的栏
    2022-08-08
  • Django自定义YamlField实现过程解析

    Django自定义YamlField实现过程解析

    这篇文章主要介绍了Django自定义YamlField实现过程解析,文中通过示例代码介绍的非常详细,对大家的学习或者工作具有一定的参考学习价值,需要的朋友可以参考下
    2020-11-11
  • python3使用matplotlib绘制散点图

    python3使用matplotlib绘制散点图

    这篇文章主要为大家详细介绍了python3使用matplotlib绘制散点图,具有一定的参考价值,感兴趣的小伙伴们可以参考一下
    2019-03-03
  • pytorch 数据预加载的实现示例

    pytorch 数据预加载的实现示例

    在PyTorch中,数据加载和预处理是深度学习中非常重要的一部分,本文主要介绍了pytorch 数据预加载的实现示例,具有一定的参考价值,感兴趣的可以了解一下
    2023-12-12

最新评论