App

(Fn [App, String, (Fn [(Ref Request a), (Ref (Map String String) b)] Response)] App)

                        (DELETE app pattern handler)
                    

adds a DELETE route.

(Fn [App, String, (Fn [(Ref Request a), (Ref (Map String String) b)] Response)] App)

                        (GET app pattern handler)
                    

adds a GET route.

(Fn [App, String, (Fn [(Ref Request a), (Ref (Map String String) b)] Response)] App)

                        (PATCH app pattern handler)
                    

adds a PATCH route.

(Fn [App, String, (Fn [(Ref Request a), (Ref (Map String String) b)] Response)] App)

                        (POST app pattern handler)
                    

adds a POST route.

(Fn [App, String, (Fn [(Ref Request a), (Ref (Map String String) b)] Response)] App)

                        (PUT app pattern handler)
                    

adds a PUT route.

(Fn [App, String, (Fn [(Ref WSEvent a), (Ref (Map String String) b), (Ref WebSocket c)] ())] App)

                        (WS app pattern handler)
                    

adds a WebSocket route. The handler is called for each lifecycle event (WSEvent): Connect, Message, Binary, and Close.

(defn echo [event params ws]
  (match-ref event
    (WSEvent.Connect) (WebSocket.send ws @"connected")
    (WSEvent.Message msg) (WebSocket.send ws (fmt "echo: %s" msg))
    (WSEvent.Binary data) (WebSocket.send-binary ws data)
    (WSEvent.Close) ()))

(defserver "0.0.0.0" 3000
  (WS "/ws/echo" echo))

(Fn [(Ref App a)] App)

copies a App.

(Fn [] App)

                        (create)
                    

creates an empty App with no routes and a default error handler.

(Fn [App] ())

deletes a App. Should usually not be called manually.

(Fn [(Ref App a)] (Ref (Fn [(Ref Request b), Int, String] Response) a))

gets the error-handler property of a App.

Int

(Fn [(Array Route), (Array WSRoute), (Fn [(Ref Request a), Int, String] Response)] App)

creates a App.

Int

(Fn [(Ref App a)] String)

converts a App to a string.

(Fn [App, String, String, (Fn [(Ref Request a), (Ref (Map String String) b)] Response)] App)

                        (route app method pattern handler)
                    

adds a route to the app.

(Fn [(Ref App a)] (Ref (Array Route) a))

gets the routes property of a App.

Bool

(Fn [(Ref App a), (Ref (Array (Fn [(Ref Request b), (Ref (Map String String) c)] (Maybe Response) d)) a), (Ref (Array (Fn [(Ref Request e), (Ref (Map String String) f), Response] Response g)) a), (Ref String h), Int] ())

                        (serve app before-hooks after-hooks host port)
                    

starts the web server on host:port.

Uses kqueue/epoll for concurrent connection handling with HTTP keep-alive. Sockets are non-blocking, reads accumulate into a per-connection buffer, and writes drain across writable events.

The loop is single-threaded, so peak throughput is bounded by one core. For multi-core scaling, run several copies behind a TCP load balancer.

(Fn [App, (Fn [(Ref Request a), Int, String] Response)] App)

                        (set-error app handler)
                    

sets a custom error handler.

(Fn [App, (Fn [(Ref Request a), Int, String] Response)] App)

sets the error-handler property of a App.

(Fn [(Ref App a), (Fn [(Ref Request b), Int, String] Response)] ())

sets the error-handler property of a App in place.

(Fn [App, (Array Route)] App)

sets the routes property of a App.

(Fn [(Ref App a), (Array Route)] ())

sets the routes property of a App in place.

(Fn [App, (Array WSRoute)] App)

sets the ws-routes property of a App.

(Fn [(Ref App a), (Array WSRoute)] ())

sets the ws-routes property of a App in place.

(Fn [App, String] App)

                        (static-dir app dir)
                    

registers a wildcard GET route that serves files from dir on disk via sendfile. Register after API routes so it acts as a fallback.

(Fn [(Ref App a)] String)

converts a App to a string.

(Fn [App, (Ref (Fn [(Fn [(Ref Request a), Int, String] Response)] (Fn [(Ref Request a), Int, String] Response) b) c)] App)

updates the error-handler property of a App using a function f.

(Fn [App, (Ref (Fn [(Array Route)] (Array Route) a) b)] App)

updates the routes property of a App using a function f.

(Fn [App, (Ref (Fn [(Array WSRoute)] (Array WSRoute) a) b)] App)

updates the ws-routes property of a App using a function f.

Int

(Fn [Int, Int, Int, Int, Int, Bool] Int)

                        (ws-ping-action ping-interval max-missed idle pcount since-ping write-pending)
                    

Decides what to do for a WebSocket connection's ping state. Returns 0 (nothing), 1 (send ping), or 2 (close as dead). Setting ping-interval to 0 or negative disables pinging.

Int

(Fn [(Ref App a)] (Ref (Array WSRoute) a))

gets the ws-routes property of a App.