Las abstracciones son fáciles de diseñar mal. Se hacen demasiado delgadas -- exponiendo detalles específicos del backend que se filtran por cada punto de llamada -- o demasiado gruesas, ocultando capacidades que el código consumidor legítimamente necesita. El trait StorageBackend en FLIN necesitaba enhebrar esta aguja con precisión: lo suficientemente abstracto para que los sistemas de archivos locales, S3, Cloudflare R2 y Google Cloud Storage quepan detrás de la misma interfaz, pero lo suficientemente concreto para que cada backend pueda optimizar sus operaciones sin contorsiones.
rustpub trait StorageBackend: Send + Sync {
fn put(&self, hash: &str, data: &[u8], extension: &str) -> StorageResult<String>;
fn put_from_path(&self, hash: &str, temp_path: &str, extension: &str) -> StorageResult<String>;
fn get(&self, path: &str) -> StorageResult<Vec<u8>>;
fn delete(&self, path: &str) -> StorageResult<()>;
fn exists(&self, hash: &str, extension: &str) -> StorageResult<bool>;
fn url(&self, hash: &str, extension: &str) -> String;
fn signed_url(&self, hash: &str, extension: &str, duration: Duration) -> StorageResult<String>;
fn backend_type(&self) -> &'static str;
fn base_path(&self) -> &str;
}Las dos palabras más importantes en la definición del trait no son nombres de métodos -- son Send + Sync. Estos traits marcadores de Rust garantizan que cualquier tipo que implemente StorageBackend puede compartirse de forma segura entre hilos y enviarse a través de límites de hilos.
El patrón del trait es una de las abstracciones más poderosas de Rust, y el sistema de almacenamiento de FLIN demuestra por qué. Aplica seguridad de hilos en tiempo de compilación, habilita despacho polimórfico a través de objetos trait y mantiene la interfaz estable mientras permite que cada backend optimice sus internos independientemente.
Esta es la Parte 127 de la serie "Cómo construimos FLIN", que documenta cómo un CEO en Abidjan y un CTO de IA diseñaron y construyeron un lenguaje de programación desde cero.
Navegación de la serie: - [126] Almacenamiento de archivos con 4 backends - [127] El patrón del trait StorageBackend (estás aquí) - [128] Backends R2 y Google Cloud Storage