Enum AnvilKitError 

pub enum AnvilKitError {
    Render {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Physics {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Asset {
        message: String,
        path: Option<String>,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Audio {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Input {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Ecs {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Window {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Config {
        message: String,
        key: Option<String>,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Network {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Io(Error),
    Serialization {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
    Generic {
        message: String,
        source: Option<Box<dyn Error + Send + Sync>>,
    },
}

AnvilKit 的主要错误类型

这个枚举涵盖了 AnvilKit 生态系统中可能出现的所有错误类型。 每个变体都包含详细的错误信息和可选的上下文数据。

设计特点

• 结构化: 按功能模块分类错误
• 信息丰富: 包含详细的错误描述和上下文
• 可序列化: 支持错误的序列化和传输
• 链式错误: 支持错误链和根因分析

Variants

Render

渲染系统错误

包括 GPU 驱动错误、着色器编译错误、纹理加载错误等。

Fields

message: String

错误消息

source: Option<Box<dyn Error + Send + Sync>>

可选的底层错误

Physics

物理系统错误

包括物理世界初始化错误、碰撞检测错误、约束求解错误等。

Fields

message: String

错误消息

source: Option<Box<dyn Error + Send + Sync>>

可选的底层错误

Asset

资源管理错误

包括资源加载失败、格式不支持、资源不存在等。

Fields

message: String

错误消息

path: Option<String>

资源路径（如果适用）

source: Option<Box<dyn Error + Send + Sync>>

可选的底层错误

Audio

音频系统错误

包括音频设备初始化错误、音频格式错误、播放错误等。

Fields

message: String

错误消息

source: Option<Box<dyn Error + Send + Sync>>

可选的底层错误

Input

输入系统错误

包括输入设备初始化错误、输入映射错误等。

Fields

message: String

错误消息

source: Option<Box<dyn Error + Send + Sync>>

可选的底层错误

Ecs

ECS 系统错误

包括组件注册错误、系统调度错误、世界状态错误等。

Fields

message: String

错误消息

source: Option<Box<dyn Error + Send + Sync>>

可选的底层错误

Window

窗口和平台错误

包括窗口创建错误、平台特定错误、事件处理错误等。

Fields

message: String

错误消息

source: Option<Box<dyn Error + Send + Sync>>

可选的底层错误

Config

配置和初始化错误

包括配置文件解析错误、参数验证错误、初始化失败等。

Fields

message: String

错误消息

key: Option<String>

配置键或路径（如果适用）

source: Option<Box<dyn Error + Send + Sync>>

可选的底层错误

Network

网络和通信错误

包括网络连接错误、协议错误、序列化错误等。

Fields

message: String

错误消息

source: Option<Box<dyn Error + Send + Sync>>

可选的底层错误

Io(Error)

I/O 操作错误

文件系统操作、网络 I/O 等底层 I/O 错误的包装。

Serialization

序列化和反序列化错误

Fields

message: String

错误消息

source: Option<Box<dyn Error + Send + Sync>>

可选的底层错误

Generic

通用错误

用于不属于其他特定类别的错误。

Fields

message: String

错误消息

source: Option<Box<dyn Error + Send + Sync>>

可选的底层错误

Implementations

impl AnvilKitError

pub fn render(message: impl Into<String>) -> AnvilKitError

创建渲染错误

示例

use anvilkit_core::error::AnvilKitError;
 
let error = AnvilKitError::render("着色器编译失败");

pub fn render_with_source( message: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> AnvilKitError

创建带源错误的渲染错误

pub fn physics(message: impl Into<String>) -> AnvilKitError

创建物理错误

pub fn physics_with_source( message: impl Into<String>, source: impl Error + Send + Sync + 'static, ) -> AnvilKitError

创建带源错误的物理错误

pub fn asset(message: impl Into<String>) -> AnvilKitError

创建资源错误

pub fn asset_with_path( message: impl Into<String>, path: impl Into<String>, ) -> AnvilKitError

创建带路径的资源错误

pub fn audio(message: impl Into<String>) -> AnvilKitError

创建音频错误

pub fn input(message: impl Into<String>) -> AnvilKitError

创建输入错误

pub fn ecs(message: impl Into<String>) -> AnvilKitError

创建 ECS 错误

pub fn window(message: impl Into<String>) -> AnvilKitError

创建窗口错误

pub fn config(message: impl Into<String>) -> AnvilKitError

创建配置错误

pub fn config_with_key( message: impl Into<String>, key: impl Into<String>, ) -> AnvilKitError

创建带键的配置错误

pub fn network(message: impl Into<String>) -> AnvilKitError

创建网络错误

pub fn serialization(message: impl Into<String>) -> AnvilKitError

创建序列化错误

pub fn generic(message: impl Into<String>) -> AnvilKitError

创建通用错误

pub fn category(&self) -> ErrorCategory

获取错误类别

示例

use anvilkit_core::error::{AnvilKitError, ErrorCategory};
 
let error = AnvilKitError::render("测试错误");
assert_eq!(error.category(), ErrorCategory::Render);

pub fn message(&self) -> String

获取错误消息

返回不包含错误类型前缀的纯错误消息。

pub fn is_category(&self, category: ErrorCategory) -> bool

检查是否为特定类别的错误

示例

use anvilkit_core::error::{AnvilKitError, ErrorCategory};
 
let error = AnvilKitError::render("测试错误");
assert!(error.is_category(ErrorCategory::Render));
assert!(!error.is_category(ErrorCategory::Physics));

pub fn with_context(self, context: impl Into<String>) -> AnvilKitError

添加上下文信息

返回一个包含额外上下文信息的新错误。

Trait Implementations

impl Debug for AnvilKitError

fn fmt(&self, f: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Display for AnvilKitError

fn fmt(&self, __formatter: &mut Formatter<'_>) -> Result<(), Error>

Formats the value using the given formatter.

impl Error for AnvilKitError

fn source(&self) -> Option<&(dyn Error + 'static)>

Returns the lower-level source of this error, if any.

fn description(&self) -> &str

👎Deprecated since 1.42.0:

use the Display impl or to_string()

fn cause(&self) -> Option<&dyn Error>

👎Deprecated since 1.33.0:

replaced by Error::source, which can support downcasting

fn provide<'a>(&'a self, request: &mut Request<'a>)

🔬This is a nightly-only experimental API. (error_generic_member_access)

Provides type-based access to context intended for error reports.

impl From<Error> for AnvilKitError

fn from(source: Error) -> AnvilKitError

Converts to this type from the input type.