mirror of
https://github.com/metosin/reitit.git
synced 2025-12-17 00:11:11 +00:00
73 lines
2.1 KiB
Markdown
73 lines
2.1 KiB
Markdown
# Sieppari
|
|
|
|
```clj
|
|
[metosin/reitit-sieppari "0.7.0-alpha4"]
|
|
```
|
|
|
|
[Sieppari](https://github.com/metosin/sieppari) is a new and fast interceptor implementation for Clojure, with pluggable async supporting [core.async](https://github.com/clojure/core.async), [Manifold](https://github.com/ztellman/manifold) and [Promesa](http://funcool.github.io/promesa/latest).
|
|
|
|
To use Sieppari with `reitit-http`, we need to attach a `reitit.interceptor.sieppari/executor` to a `http-router` to compile and execute the interceptor chains. Reitit and Sieppari share the same interceptor model, so all reitit default interceptors work seamlessly together.
|
|
|
|
We can use both synchronous ring and [async-ring](https://www.booleanknot.com/blog/2016/07/15/asynchronous-ring.html) with Sieppari.
|
|
|
|
## Synchronous Ring
|
|
|
|
```clj
|
|
(require '[reitit.http :as http])
|
|
(require '[reitit.interceptor.sieppari :as sieppari])
|
|
|
|
(defn i [x]
|
|
{:enter (fn [ctx] (println "enter " x) ctx)
|
|
:leave (fn [ctx] (println "leave " x) ctx)})
|
|
|
|
(defn handler [_]
|
|
(future {:status 200, :body "pong"}))
|
|
|
|
(def app
|
|
(http/ring-handler
|
|
(http/router
|
|
["/api"
|
|
{:interceptors [(i :api)]}
|
|
|
|
["/ping"
|
|
{:interceptors [(i :ping)]
|
|
:get {:interceptors [(i :get)]
|
|
:handler handler}}]])
|
|
{:executor sieppari/executor}))
|
|
|
|
(app {:request-method :get, :uri "/api/ping"})
|
|
;enter :api
|
|
;enter :ping
|
|
;enter :get
|
|
;leave :get
|
|
;leave :ping
|
|
;leave :api
|
|
;=> {:status 200, :body "pong"}
|
|
```
|
|
|
|
## Async-ring
|
|
|
|
```clj
|
|
(let [respond (promise)]
|
|
(app {:request-method :get, :uri "/api/ping"} respond nil)
|
|
(deref respond 1000 ::timeout))
|
|
;enter :api
|
|
;enter :ping
|
|
;enter :get
|
|
;leave :get
|
|
;leave :ping
|
|
;leave :api
|
|
;=> {:status 200, :body "pong"}
|
|
```
|
|
|
|
## Examples
|
|
|
|
### Simple
|
|
|
|
* simple example, with both sync & async code:
|
|
* https://github.com/metosin/reitit/tree/master/examples/http
|
|
|
|
### With batteries
|
|
|
|
* with [default interceptors](default_interceptors.md), [coercion](../coercion/coercion.md) and [swagger](../ring/swagger.md)-support:
|
|
* https://github.com/metosin/reitit/tree/master/examples/http-swagger
|