Struct InklogContainer 

pub struct InklogContainer { /* private fields */ }

应用级依赖注入容器

统一管理所有底层依赖实例，确保组件间共享同一实例。

实例共享

通过容器创建的所有 LoggerManager 将共享相同的依赖实例：

let container = InklogContainer::new()?;

let logger1 = container.create_logger().await?;
let logger2 = container.create_logger().await?;

// logger1 和 logger2 共享相同的 cache、config 实例

线程安全

容器本身是线程安全的，可以在多个线程间共享：

use std::sync::Arc;

let container = Arc::new(InklogContainer::new()?);

let c1 = container.clone();
let handle1 = tokio::spawn(async move {
    c1.create_logger().await
});

let c2 = container.clone();
let handle2 = tokio::spawn(async move {
    c2.create_logger().await
});

Implementations

impl InklogContainer

pub fn new() -> Result<Self, InklogError>

创建默认容器

使用默认配置创建所有依赖实例：

• Cache: OxCacheAdapter::new()
• Config: InklogConfigAdapter::new()（从搜索路径加载配置）
• Database: None（未配置）

返回

成功返回 Ok(Self)，失败返回 Err(InklogError)

错误

• InklogError::CacheError - 缓存初始化失败
• InklogError::ConfigError - 配置加载失败

示例

use inklog::InklogContainer;

let container = InklogContainer::new()?;

pub fn from_config(config: InklogConfig) -> Result<Self, InklogError>

从配置创建容器

使用提供的 InklogConfig 创建依赖实例。

Arguments

• config - 已加载的配置实例

返回

成功返回 Ok(Self)，失败返回 Err(InklogError)

示例

use inklog::{InklogContainer, InklogConfig};

let config = InklogConfig::default();
let container = InklogContainer::from_config(config)?;

pub fn builder() -> InklogContainerBuilder

创建容器构建器

用于自定义依赖注入的场景，如使用外部库原生类型。

示例

use inklog::InklogContainer;
use inklog::infrastructure::{OxCacheAdapter, InklogConfigAdapter};
use std::sync::Arc;

let container = InklogContainer::builder()
    .cache(Arc::new(OxCacheAdapter::new()?))
    .config(Arc::new(InklogConfigAdapter::new()?))
    .build()?;

pub async fn create_logger(&self) -> Result<LoggerManager, InklogError>

创建 LoggerManager，注入共享依赖

返回的 LoggerManager 将使用容器中共享的依赖实例。

返回

成功返回 Ok(LoggerManager)，失败返回 Err(InklogError)

示例

let container = InklogContainer::new()?;
let logger = container.create_logger().await?;

// logger 使用容器中共享的 cache 和 config

pub fn cache(&self) -> Arc<dyn Cache>

获取共享的缓存实例

返回容器中缓存实例的克隆（Arc 克隆，共享底层数据）。

示例

let container = InklogContainer::new()?;
let cache = container.cache();

cache.set("key", "value".to_string()).await?;

pub fn config(&self) -> Arc<dyn Config>

获取共享的配置实例

返回容器中配置实例的克隆（Arc 克隆，共享底层数据）。

示例

let container = InklogContainer::new()?;
let config = container.config();

let level = config.get_string("global.level");

pub fn database(&self) -> Option<Arc<dyn Database>>

获取共享的数据库实例（需要 dbnexus feature）

返回容器中数据库实例的克隆（如果已配置）。

示例

let container = InklogContainer::new()?;

if let Some(db) = container.database() {
    let healthy = db.is_healthy().await;
}

pub fn set_database(&mut self, database: Arc<dyn Database>)

设置数据库实例（需要 dbnexus feature）

用于在容器创建后动态配置数据库连接。

Arguments

• database - 数据库实例

示例

use inklog::infrastructure::DbNexusAdapter;

let mut container = InklogContainer::new()?;
let db = DbNexusAdapter::new("postgres://localhost/logs", 10).await?;
container.set_database(Arc::new(db));

Trait Implementations

impl Debug for InklogContainer

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

Formats the value using the given formatter.

impl Default for InklogContainer

fn default() -> Self

Returns the “default value” for a type.