Request#

Das Request-Objekt wird an jeden Route-Handler übergeben.

app.get("hello", ":name") { req -> String in
    let name = req.parameters.get("name")!
    return "Hello, \(name)!"
}

Es ist das Hauptfenster zum Rest der Funktionalität von Vapor. Es enthält APIs für den Request-Body, Query-Parameter, den Logger, den HTTP-Client, den Authenticator und mehr. Der Zugriff auf diese Funktionalität über den Request sorgt dafür, dass die Berechnung auf dem richtigen Event-Loop bleibt, und ermöglicht es, sie für Tests zu mocken. Du kannst dem Request sogar über Extensions eigene Services hinzufügen.

Die vollständige API-Dokumentation für Request findest du hier.

Application#

Die Eigenschaft Request.application enthält eine Referenz auf die Application. Dieses Objekt enthält die gesamte Konfiguration und Kernfunktionalität der Anwendung. Der Großteil sollte nur in configure.swift gesetzt werden, bevor die Anwendung vollständig startet, und viele der tiefer liegenden APIs werden in den meisten Anwendungen nicht benötigt. Eine der nützlichsten Eigenschaften ist Application.eventLoopGroup, mit der du über die Methode any() einen EventLoop für Prozesse abrufen kannst, die einen neuen benötigen. Sie enthält außerdem die Environment.

Body#

Wenn du direkten Zugriff auf den Request-Body als ByteBuffer möchtest, kannst du Request.body.data verwenden. Dies kann genutzt werden, um Daten aus dem Request-Body in eine Datei zu streamen (auch wenn du dafür stattdessen die Eigenschaft fileio auf dem Request verwenden solltest) oder an einen anderen HTTP-Client.

Cookies#

Auch wenn die nützlichste Anwendung von Cookies über die eingebauten Sessions erfolgt, kannst du auch direkt über Request.cookies auf Cookies zugreifen.

app.get("my-cookie") { req -> String in
    guard let cookie = req.cookies["my-cookie"] else {
        throw Abort(.badRequest)
    }
    if let expiration = cookie.expires, expiration < Date() {
        throw Abort(.badRequest)
    }
    return cookie.string
}

Headers#

Auf ein HTTPHeaders-Objekt kann über Request.headers zugegriffen werden. Es enthält alle mit dem Request gesendeten Header. Es kann beispielsweise verwendet werden, um auf den Content-Type-Header zuzugreifen.

app.get("json") { req -> String in
    guard let contentType = req.headers.contentType, contentType == .json else {
        throw Abort(.badRequest)
    }
    return "JSON"
}

Weitere Dokumentation zu HTTPHeaders findest du hier. Vapor fügt HTTPHeaders außerdem mehrere Extensions hinzu, um die Arbeit mit den am häufigsten verwendeten Headern zu erleichtern; eine Liste ist hier verfügbar.

IP-Adresse#

Auf die SocketAddress, die den Client repräsentiert, kann über Request.remoteAddress zugegriffen werden, was für Logging oder Rate-Limiting mittels der String-Repräsentation Request.remoteAddress.ipAddress nützlich sein kann. Sie stellt möglicherweise nicht genau die IP-Adresse des Clients dar, wenn sich die Anwendung hinter einem Reverse-Proxy befindet.

app.get("ip") { req -> String in
    return req.remoteAddress.ipAddress
}

Weitere Dokumentation zu SocketAddress findest du hier.