robotech 1.6.0

Backend service implementation for the RoboTech platform, providing RESTful APIs and business logic for web applications.
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57

#[cfg(feature = "api-client")]
use crate::api_client::ApiClientError;
use crate::app::AppError;
#[cfg(feature = "db")]
use crate::dao::DaoError;
#[cfg(feature = "db")]
use crate::db::DbError;
use crate::env::EnvError;
#[cfg(feature = "web")]
use axum::extract::multipart::MultipartError;
use idworker::IdWorkerError;
use std::time::SystemTimeError;

/// # 自定义服务层的错误枚举
///
/// 该枚举定义了服务层可能遇到的各种错误类型，包括数据未找到、重复键约束违反、
/// IO错误和数据库错误。这些错误类型用于在服务层统一处理各种异常情况，
/// 并提供清晰的错误信息反馈给调用方。
///
/// ## 错误类型说明
/// - `NotFound`: 表示请求的数据未找到，通常用于查询操作
/// - `DuplicateKey`: 表示违反了唯一性约束，如重复的用户名或邮箱
/// - `IoError`: 表示输入输出相关的错误，如文件读写失败
/// - `DatabaseError`: 表示底层数据库操作发生的错误
#[derive(Debug, thiserror::Error)]
pub enum SvcError {
    #[error("{0}")]
    Runtime(#[from] anyhow::Error),
    #[error("环境变量错误: {0}")]
    GetAppEnv(#[from] EnvError),
    #[error("系统时钟错误: {0}")]
    SystemTime(#[from] SystemTimeError),
    #[error("ID工作者错误: {0}")]
    IdWorker(#[from] IdWorkerError),
    #[error("APP错误: {0}")]
    App(#[from] AppError),
    #[error("参数校验错误 -> {0}")]
    Validation(#[from] validator::ValidationError),
    #[error("参数校验错误 -> {0}")]
    Validations(#[from] validator::ValidationErrors),
    #[error("找不到数据: {0}")]
    NotFound(String),
    #[error("IO错误: {0}")]
    Io(#[from] std::io::Error),
    #[cfg(feature = "web")]
    #[error("MultipartError错误: {0}")]
    MultipartError(#[from] MultipartError),
    #[cfg(feature = "db")]
    #[error("数据访问层错误: {0}")]
    Dao(#[from] DaoError),
    #[cfg(feature = "db")]
    #[error("数据库连接错误: {0}")]
    DbConn(#[from] DbError),
    #[cfg(feature = "api-client")]
    #[error("API客户端错误, {0}")]
    ApiClient(#[from] ApiClientError),
}