Liking cljdoc? Tell your friends :D

ring.middleware.session

Middleware for maintaining browser sessions using cookies.

Sessions are stored using types that adhere to the ring.middleware.session.store/SessionStore protocol. Ring comes with two stores included:

ring.middleware.session.memory/memory-store ring.middleware.session.cookie/cookie-store

Middleware for maintaining browser sessions using cookies.

Sessions are stored using types that adhere to the
ring.middleware.session.store/SessionStore protocol.
Ring comes with two stores included:

  ring.middleware.session.memory/memory-store
  ring.middleware.session.cookie/cookie-store
raw docstring

session-requestclj

(session-request request)
(session-request request options)

Reads current HTTP session map and adds it to :session key of the request. See: wrap-session.

Reads current HTTP session map and adds it to :session key of the request.
See: wrap-session.
sourceraw docstring

session-responseclj

(session-response response request)
(session-response response request options)

Updates session based on :session key in response. See: wrap-session.

Updates session based on :session key in response. See: wrap-session.
sourceraw docstring

wrap-sessionclj

(wrap-session handler)
(wrap-session handler options)

Reads in the current HTTP session map, and adds it to the :session key on the request. If a :session key is added to the response by the handler, the session is updated with the new value. If the value is nil, the session is deleted.

Accepts the following options:

:store - An implementation of the SessionStore protocol in the ring.middleware.session.store namespace. This determines how the session is stored. Defaults to in-memory storage using ring.middleware.session.store/memory-store.

:root - The root path of the session. Any path above this will not be able to see this session. Equivalent to setting the cookie's path attribute. Defaults to "/".

:cookie-name - The name of the cookie that holds the session key. Defaults to "ring-session".

:cookie-attrs - A map of attributes to associate with the session cookie. Defaults to {:http-only true}. This may be overridden on a per-response basis by adding :session-cookie-attrs to the response.

:set-cookies? - If true, automatically include cookie middleware. Defaults to true for backward compatibility.

Reads in the current HTTP session map, and adds it to the :session key on
the request. If a :session key is added to the response by the handler, the
session is updated with the new value. If the value is nil, the session is
deleted.

Accepts the following options:

:store        - An implementation of the SessionStore protocol in the
                ring.middleware.session.store namespace. This determines how
                the session is stored. Defaults to in-memory storage using
                ring.middleware.session.store/memory-store.

:root         - The root path of the session. Any path above this will not be
                able to see this session. Equivalent to setting the cookie's
                path attribute. Defaults to "/".

:cookie-name  - The name of the cookie that holds the session key. Defaults to
                "ring-session".

:cookie-attrs - A map of attributes to associate with the session cookie.
                Defaults to {:http-only true}. This may be overridden on a
                per-response basis by adding :session-cookie-attrs to the
                response.

:set-cookies? - If true, automatically include cookie middleware. Defaults to
                true for backward compatibility.
sourceraw docstring

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close