Definición y Registro de Componentes

Un componente (Component) es una estructura inyectable que se construye automáticamente basándose en las dependencias ya registradas en el contenedor.

Este tipo de estructura es ideal para representar partes modulares de la aplicación que dependen de otros servicios o configuraciones. Por ejemplo, repositorios de datos, servicios de negocio, etc.

Definir un Componente

Para definir un componente debes usar el atributo #[injectable] en la definición de la estructura.

Consejo

La sintaxis #[injectable(component)] también es válida, pero no es necesaria. Úsala solo si quieres ser explícito sobre tu intención de definir un componente.

Ejemplo

#[injectable]
pub struct TaskRepository {
    db: Arc<Database>,
}

impl TaskRepository {
    pub async fn find_all(&self) -> Vec<Task> {
        sqlx::query_as::<_, Task>("SELECT id, title FROM tasks")
            .fetch_all(self.db.get_pool())
            .await
            .expect("Failed to fetch tasks")
    }

    pub async fn create(&self, task: Task) {
        sqlx::query("INSERT INTO tasks (id, title) VALUES ($1, $2)")
            .bind(task.id)
            .bind(task.title)
            .execute(self.db.get_pool())
            .await
            .expect("Failed to insert task");
    }
}

En este ejemplo, TaskRepository no requiere un constructor específico, ya que el sistema de inyección de dependencias se encargará de resolver cada campo del componente y lo construirá automáticamente.

Probablemente te diste cuenta que Database está envuelto en un puntero Arc. Esto no es obligatorio, pero puede ser útil para compartir referencias de un mismo componente o proveedor en diferentes lugares sin generar clones innecesarios.

Inyección múltiple

Un componente puede depender de múltiples proveedores, componentes y estructuras marcadas con el atributo #[config], aunque en el caso de estas últimas no es necesario envolverlas en un puntero Arc.

#[config(key = "task")]
#[derive(Clone, Deserialize)]
pub struct TaskConfig {
    max_tasks: usize,
}

#[injectable]
pub struct TaskService {
    repo: Arc<TaskRepository>,
    task_conf: TaskConfig,
}