Wie man in 30 Minuten eine REST API in Rust schreibt: Schritt-für-Schritt-Anleitung

Einleitung: Warum Rust für REST-APIs?

Rust ist eine moderne systemnahe Programmiersprache, die die Leistung von C++ mit der Speichersicherheit kombiniert, die bereits zur Kompilierzeit garantiert wird. In den letzten Jahren wird Rust zunehmend für die Erstellung hochbelastbarer Webdienste und Microservices eingesetzt. In diesem Artikel zeigen wir, wie Sie in 30 Minuten eine vollwertige REST-API mit Rust unter Verwendung des Frameworks Actix-web und der Bibliothek Serde schreiben.

Warum sollten Sie Rust für Ihre API wählen?

• Leistung: Rust arbeitet auf dem Niveau von C/C++, was für hochbelastete Systeme entscheidend ist.
• Sicherheit: Das Ownership- und Borrowing-System schließt ganze Klassen von speicherbezogenen Fehlern aus.
• Asynchronität: Die integrierte Unterstützung für async/await ermöglicht die effiziente Verarbeitung Tausender Verbindungen.
• Ökosystem: Cargo (Paketmanager) und crates.io machen die Abhängigkeitsverwaltung einfach und bequem.

Wir erstellen eine einfache API zur Verwaltung einer Aufgabenliste (Todo-Liste), die CRUD-Operationen unterstützt. Sie lernen, Routen zu konfigurieren, JSON zu verarbeiten und mit dem Anwendungszustand zu arbeiten.

Schritt 1: Projekteinrichtung und Installation der Abhängigkeiten

Als Erstes erstellen wir ein neues Rust-Projekt mit Cargo. Öffnen Sie ein Terminal und führen Sie Folgendes aus:

cargo new rust_todo_apicd rust_todo_api

Jetzt bearbeiten wir die Datei Cargo.toml und fügen die erforderlichen Abhängigkeiten hinzu:

[package]name = "rust_todo_api"version = "0.1.0"edition = "2021"

[dependencies]actix-web = "4"serde = { version = "1.0", features = ["derive"] }serde_json = "1.0"tokio = { version = "1", features = ["full"] }uuid = { version = "1", features = ["v4"] }

Lassen Sie uns erklären, wofür jede Bibliothek benötigt wird:

• actix-web — ein leistungsstarkes asynchrones Web-Framework.
• serde — eine Bibliothek zur Serialisierung und Deserialisierung von Daten (JSON).
• serde_json — Unterstützung des JSON-Formats für serde.
• tokio — asynchrone Laufzeitumgebung für Rust (actix-web verwendet sie standardmäßig).
• uuid — Generierung eindeutiger Identifikatoren für unsere Aufgaben.

Nachdem Sie die Abhängigkeiten hinzugefügt haben, führen Sie cargo build aus, um alle Pakete herunterzuladen und zu kompilieren. Dies kann beim ersten Start einige Minuten dauern.

Schritt 2: Erstellung des Datenmodells und der Anwendungsstruktur

Erstellen wir die Datei src/main.rs und definieren das Modell unserer Aufgabe. Wir verwenden die Struktur TodoItem mit den Feldern id, title und completed:

use actix_web::{web, App, HttpServer, HttpResponse, middleware};use serde::{Deserialize, Serialize};use std::sync::Mutex;use uuid::Uuid;

#[derive(Debug, Serialize, Deserialize, Clone)]struct TodoItem {    id: String,    title: String,    completed: bool,}

#[derive(Debug, Deserialize)]struct CreateTodoRequest {    title: String,}

#[derive(Debug, Deserialize)]struct UpdateTodoRequest {    title: Option<String>,    completed: Option<bool>,}

struct AppState {    todos: Mutex<Vec<TodoItem>>,}

Beachten Sie die wichtigen Details:

• Serialize und Deserialize — Traits aus serde, die automatisch Code für die Arbeit mit JSON generieren.
• Mutex — wird für den sicheren Zugriff auf den gemeinsamen Zustand aus mehreren Threads verwendet.
• Uuid — generiert eindeutige Identifikatoren für jede Aufgabe.

Jetzt fügen wir die main-Funktion hinzu, die den Server startet und den Zustand initialisiert:

#[actix_web::main]async fn main() -> std::io::R