mongodb-session

KO | EN

gitlite — search

#python #java #python3 #arduino #golang #machine-learning #rust #html #flask #javascript #seismology #nodejs

mongodb-session

★ 12 Open GitHub ↗

Http sessions into mongodb for Clojure/Ring.

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# mongodb-session

Mongodb-session use mongodb as a Clojure/Ring's http session storage.

**Alternative**: This library relies on [congomongo](https://github.com/congomongo/congomongo) as a MongoDB client. If you are using [monger](http://clojuremongodb.info/), consider using [mongers built-in session support](http://clojuremongodb.info/articles/integration.html#using_mongodbbacked_ring_session_store_with_monger).

## Usage
### Functional access
**ring.middleware.session** version.<br>
Following examples are originated from [sandbar-examples](https://github.com/brentonashworth/sandbar-examples/blob/master/sessions/src/sandbar/examples/session_demo.clj).<br>
Ring-core must be higher than 0.3.0, because mongodb-session depend on the protocol defined ring.middleware.session.store.

```clojure
(ns hello
  (:require [ring.middleware.session :as rs]
            [somnium.congomongo :as congo]
            [hozumi.mongodb-session :as mongoss]
      ...))

(congo/mongo! :db "mydb" :host "127.0.0.1")

(defroutes my-routes ....)

(def app (-> my-routes
           (rs/wrap-session {:store (mongoss/mongodb-store)})))
```

Then, you can use mongodb session in the same way as in-memory one.

```clojure
(defn functional-handler
  "Functional style of working with a session."
  [request]
  (let [counter (if-let [counter (-> request :session :counter)]
                  (+ counter 1)
                  1)]
    {:status 200
     :headers {"Content-Type" "text/html"}
     :body (html
            (layout "Functional" counter (link-to "/stateful" "Stateful")))
     :session {:counter counter}}))
```

Let's look at the mongodb.

```javascript
% bin/mongo
MongoDB shell version: 1.6.3
connecting to: test
>
> use mydb
switched to db mydb
> db.ring_sessions.find()
{ "_id" : "0a7047f6-ad8a-45b0-b214-ba18830b9851",
  "_date" : "Sat Nov 06 2010 08:33:58 GMT+0900 (JST)",
  "counter" : 3 }
```

**_id** means cookie value of ring-session.<br>
**_date** means when this session is started.<br>
Default collection name mongodb-session use is **ring_sessions**. You can change this like below.

```clojure
(mongoss/mongodb-store {:collection-name :my_sessions})
```

You can also change session id everytime when session is updated. This behavior prevents session fixation attack.

```clojure
(mongoss/mongodb-store {:auto-key-change? true})
```

### Statuful access
[sandbar.stateful-session](https://github.com/brentonashworth/sandbar) version.

```clojure
(ns hello
  (:require [sandbar.stateful-session :as stateful]
            [somnium.congomongo :as mongo]
            [hozumi.mongodb-session :as mongoss]))
  
(mongo/mongo! :db "mydb" :host "127.0.0.1")

(defroutes my-routes ....)

(def app (-> my-routes
           (stateful/wrap-stateful-session {:store (mongoss/mongodb-store)})))
```

You don't need to include :session entry in the response map.

```clojure
(defn stateful-handler
  "Stateful style of working with a session."
  [request]
  (let [counter (+ 1 (stateful/session-get :counter 0))]
    (do (stateful/session-put! :counter counter)
        {:status 200
         :headers {"Content-Type" "text/html"}
         :body (html
                 (layout "Stateful" counter
             (link-to "/functional" "Functional")))})))
```

mongodb

```javascript
> db.ring_sessions.find()
{ "_id" : "0a7047f6-ad8a-45b0-b214-ba18830b9851",
  "_date" : "Sat Nov 06 2010 08:33:58 GMT+0900 (JST)",
  "sandbar.stateful-session/session" : { "counter" : 2 } }
```

## Installation
Leiningen

```clojure
[org.clojars.hozumi/mongodb-session "1.0.1"]
```

mongodb-session

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README