| """ |
| 通用业务异常类 |
| """ |
|
|
| from __future__ import annotations |
|
|
| from typing import TYPE_CHECKING, Any |
|
|
| if TYPE_CHECKING: |
| from django.utils.functional import Promise |
|
|
| from .base import BusinessException |
|
|
| __all__: list[str] = [ |
| "ValidationException", |
| "PermissionDenied", |
| "NotFoundError", |
| "ConflictError", |
| "AuthenticationError", |
| "RateLimitError", |
| "ForbiddenError", |
| "UnauthorizedError", |
| ] |
|
|
|
|
| class ValidationException(BusinessException): |
| """ |
| 验证异常 |
| |
| 使用场景: |
| - 数据格式不正确 |
| - 业务规则验证失败 |
| - 字段值不符合要求 |
| |
| HTTP 状态码:400 |
| """ |
|
|
| def __init__( |
| self, message: str | Promise = "数据验证失败", code: str | None = None, errors: dict[str, Any] | None = None |
| ) -> None: |
| super().__init__(message=message, code=code or "VALIDATION_ERROR", errors=errors) |
|
|
|
|
| class PermissionDenied(BusinessException): |
| """ |
| 权限拒绝异常 |
| |
| 使用场景: |
| - 用户无权限执行操作 |
| - 访问被拒绝的资源 |
| |
| HTTP 状态码:403 |
| """ |
|
|
| def __init__( |
| self, message: str | Promise = "无权限执行该操作", code: str | None = None, errors: dict[str, Any] | None = None |
| ) -> None: |
| super().__init__(message=message, code=code or "PERMISSION_DENIED", errors=errors) |
|
|
|
|
| class NotFoundError(BusinessException): |
| """ |
| 资源不存在异常 |
| |
| 使用场景: |
| - 查询的资源不存在 |
| - ID 无效 |
| |
| HTTP 状态码:404 |
| """ |
|
|
| def __init__( |
| self, message: str | Promise = "资源不存在", code: str | None = None, errors: dict[str, Any] | None = None |
| ) -> None: |
| super().__init__(message=message, code=code or "NOT_FOUND", errors=errors) |
|
|
|
|
| class ConflictError(BusinessException): |
| """ |
| 资源冲突异常 |
| |
| 使用场景: |
| - 资源已存在(重复创建) |
| - 资源状态冲突 |
| - 并发修改冲突 |
| |
| HTTP 状态码:409 |
| """ |
|
|
| def __init__( |
| self, message: str | Promise = "资源冲突", code: str | None = None, errors: dict[str, Any] | None = None |
| ) -> None: |
| super().__init__(message=message, code=code or "CONFLICT", errors=errors) |
|
|
|
|
| class AuthenticationError(BusinessException): |
| """ |
| 认证失败异常 |
| |
| 使用场景: |
| - 登录失败 |
| - Token 无效 |
| - 会话过期 |
| |
| HTTP 状态码:401 |
| """ |
|
|
| def __init__( |
| self, message: str | Promise = "认证失败", code: str | None = None, errors: dict[str, Any] | None = None |
| ) -> None: |
| super().__init__(message=message, code=code or "AUTHENTICATION_ERROR", errors=errors) |
|
|
|
|
| class RateLimitError(BusinessException): |
| """ |
| 频率限制异常 |
| |
| 使用场景: |
| - 请求过于频繁 |
| - 超过配额限制 |
| |
| HTTP 状态码:429 |
| """ |
|
|
| def __init__( |
| self, message: str | Promise = "请求过于频繁", code: str | None = None, errors: dict[str, Any] | None = None |
| ) -> None: |
| super().__init__(message=message, code=code or "RATE_LIMIT_ERROR", errors=errors) |
|
|
|
|
| |
| class ForbiddenError(PermissionDenied): |
| """无权限访问(向后兼容)""" |
|
|
| def __init__(self, message: str | Promise = "无权限访问") -> None: |
| super().__init__(message) |
| self.status = 403 |
|
|
|
|
| class UnauthorizedError(AuthenticationError): |
| """未认证(向后兼容)""" |
|
|
| def __init__(self, message: str | Promise = "请先登录") -> None: |
| super().__init__(message) |
| self.status = 401 |
|
|
