Actix-web para Rust: guía completa con ejemplos

¿Qué es Actix-web y para qué sirve?

\n\n

Actix-web es un potente, pragmático y extremadamente rápido framework web para el lenguaje de programación Rust. Está construido sobre el modelo de actores (biblioteca Actix) y el runtime asíncrono Tokio. Actix-web permite crear aplicaciones web y API de alto rendimiento capaces de procesar millones de solicitudes por segundo.

\n\n

¿Por qué usar Actix-web?

\n

\n
• Rendimiento: Actix-web se encuentra consistentemente entre los tres frameworks web más rápidos del mundo (según las pruebas de TechEmpower), superando a soluciones como Go net/http y Node.js Express.
\n
• Seguridad: Rust garantiza la seguridad de la memoria en tiempo de compilación, eliminando clases enteras de vulnerabilidades (desbordamiento de búfer, condiciones de carrera).
\n
• Seguridad de tipos: Gracias al estricto sistema de tipos de Rust, muchos errores (por ejemplo, formato JSON incorrecto) se detectan en tiempo de compilación.
\n
• Asincronía: Soporte completo de async/await permite manejar miles de conexiones simultáneas sin crear un hilo por cada una.
\n
• Ecosistema: Actix-web se integra fácilmente con otros crates de Rust: serde (serialización), sqlx/diesel (bases de datos), reqwest (cliente HTTP).
\n

\n\n

Actix-web es ideal para: API REST, microservicios, servidores WebSocket, aplicaciones web de alta carga, servidores proxy.

\n\n

Instalación de Actix-web

\n\n

Como Actix-web es una biblioteca para Rust, la instalación se realiza a través del gestor de paquetes cargo (análogo a pip para Python).

\n\n

Paso 1. Asegúrate de tener Rust instalado. Verifica con el comando:

\n

rustc --version\ncargo --version

\n

Si Rust no está instalado, descárgalo desde rustup.rs.

\n\n

Paso 2. Crea un nuevo proyecto:

\n

cargo new my_actix_app\ncd my_actix_app

\n\n

Paso 3. Agrega Actix-web a las dependencias. Abre el archivo Cargo.toml y agrega:

\n

[dependencies]\nactix-web = "4"

\n\n

Paso 4. Instala las dependencias y compila el proyecto:

\n

cargo build

\n\n

¡Listo! Ahora puedes usar Actix-web en tu proyecto.

\n\n

Inicio rápido: "Hello, World!" en Actix-web

\n\n

Creemos un servidor web simple que responda a solicitudes GET.

\n\n

Ejemplo 1: Servidor mínimo

\n

// main.rs\nuse actix_web::{get, App, HttpResponse, HttpServer, Responder};\n\n#[get("/")]\nasync fn hello() -> impl Responder {\n    HttpResponse::Ok().body("Hello, World!")\n}\n\n#[actix_web::main]\nasync fn main() -> std::io::Result<()> {\n    HttpServer::new(|| {\n        App::new()\n            .service(hello)\n    })\n    .bind(("127.0.0.1", 8080))?\n    .run()\n    .await\n}

\n\n

Ejecución: cargo run

\n

Verificación: Abre el navegador en http://127.0.0.1:8080 o ejecuta:

\n

curl http://127.0.0.1:8080

\n

Verás la respuesta: Hello, World!

\n\n

Métodos y funciones principales de Actix-web

\n\n

Veamos los elementos clave del framework. Para cada uno se proporciona una descripción, parámetros y un ejemplo funcional.

\n\n

1. #[get("/path")] — macro para manejar solicitudes GET

\n

Qué hace: Decora una función asíncrona, convirtiéndola en un manejador de solicitudes HTTP GET en la ruta especificada.

\n

Parámetros: Ruta (cadena), puede contener segmentos dinámicos (por ejemplo, /{id}).

\n

Ejemplo:

\n

use actix_web::{get, HttpResponse, Responder};\n\n#[get("/user/{id}")]\nasync fn get_user(path: actix_web::web::Path<String>) -> impl Responder {\n    let user_id = path.into_inner();\n    HttpRespons