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:
- Security Decorators (@Auth, @Role)
- Performance Decorators (@Cache)
- HTTP Decorators (@GET, @POST, etc.)
- Andere Decorators (@SEO, @AI)