Django-Braces访问控制Mixin详解-CSDN博客

本文链接：https://blog.csdn.net/gitblog_00131/article/details/148917045

Django-Braces访问控制Mixin详解

Django-Braces提供了一系列强大的Mixin类，用于简化Django视图中的访问控制逻辑。这些Mixin可以帮助开发者快速实现用户认证、权限检查等功能，而无需重复编写样板代码。

基础概念

所有访问控制Mixin都基于AccessMixin，它定义了以下通用属性：

login_url：未授权时的重定向登录URL，默认为settings.LOGIN_URL
raise_exception：权限拒绝时的处理方式
- False（默认）：重定向到登录页面
- True：抛出PermissionDenied异常
- 异常子类：抛出指定异常
- 可调用对象：调用该对象并返回响应
redirect_field_name：重定向字段名，默认为REDIRECT_FIELD_NAME
redirect_unauthenticated_users：是否重定向未认证用户，默认为False

核心Mixin详解

LoginRequiredMixin

这是最基本的Mixin，用于确保用户已登录。它相当于Django的@login_required装饰器的类视图版本。

from django.views.generic import TemplateView
from braces.views import LoginRequiredMixin

class SecretView(LoginRequiredMixin, TemplateView):
    template_name = "secret.html"
    login_url = "/custom-login/"  # 可选
    raise_exception = True  # 可选，改为抛出异常而非重定向

最佳实践：

通常应作为视图继承列表中的第一个Mixin（除非与CsrfExemptMixin一起使用）
可以与其他访问控制Mixin组合使用

PermissionRequiredMixin

用于检查用户是否拥有特定权限。必须设置permission_required属性。

from braces.views import PermissionRequiredMixin

class ProtectedView(PermissionRequiredMixin, TemplateView):
    permission_required = "auth.change_user"  # 必须设置

特点：

只支持检查单个权限
可设置object_level_permissions=True启用对象级权限检查
通常与LoginRequiredMixin一起使用

MultiplePermissionsRequiredMixin

更强大的权限检查Mixin，支持同时检查多个权限。

from braces.views import MultiplePermissionsRequiredMixin

class MultiPermView(MultiplePermissionsRequiredMixin, TemplateView):
    permissions = {
        "all": ("app.add_model", "app.change_model"),  # 需要全部满足
        "any": ("app.delete_model", "app.view_model")  # 满足任一即可
    }

GroupRequiredMixin

检查用户是否属于指定用户组，支持单个或多个组检查。

from braces.views import GroupRequiredMixin

class GroupView(GroupRequiredMixin, TemplateView):
    group_required = "editors"  # 单个组
    # 或 group_required = ["editors", "admins"] 多个组

高级用法：

可覆盖check_membership方法实现自定义组检查逻辑
可覆盖get_group_required方法动态返回组名

UserPassesTestMixin

最灵活的Mixin，允许通过自定义函数检查用户权限。

from braces.views import UserPassesTestMixin

class CustomCheckView(UserPassesTestMixin, TemplateView):
    def test_func(self, user):
        return user.email.endswith("@company.com")