v3.1.0APIs & Backend

Decorators

Decorators sind Metadaten, die Funktionen annotieren und deren Verhalten steuern.

HTTP Decorators

Diese Decorators definieren die HTTP-Endpunkte deiner Anwendung.

@GET

Definiert einen GET-Endpoint.

@GET("/api/users")
fn getUsers(): List<User> {
    return db.findAll(User);
}

@POST

Definiert einen POST-Endpoint.

@POST("/api/users")
fn createUser(name: string, email: string): User {
    // ...
}

Security Decorators

@Auth

Erfordert Authentifizierung für den Endpoint.

@Auth
@GET("/api/profile")
fn getProfile(): User {
    return currentUser();
}

@Role

Erfordert eine bestimmte Rolle.

@Auth
@Role("admin")
@GET("/api/admin/users")
fn getAdminUsers(): List<User> {
    return db.findAll(User);
}

Performance & Intelligence

@Cache

Aktiviert Caching mit konfigurierbarem TTL und Pattern-Keys.

@Flow

Transaktionales State-Tracking mit automatischem Rollback.

@VelinAutoDoc

Generiert automatisch KI-freundliche Dokumentation aus Code.

@VelinPipeline

Automatische Parallelisierung von unabhängigen await-Aufrufen.

Beispiel: Kombinierte Decorators

Mehrere Decorators können kombiniert werden, um komplexe Logik deklarativ auszudrücken.

@Auth
@Role("admin")
@Cache(ttl: "10m")
@GET("/api/admin/stats")
fn getAdminStats(): Stats {
    return calculateStats();
}

Die empfohlene Reihenfolge:

  1. Security Decorators (@Auth, @Role)
  2. Performance Decorators (@Cache)
  3. HTTP Decorators (@GET, @POST, etc.)
  4. Andere Decorators (@SEO, @AI)