vendor/plugins/sql_session_store/lib/postgresql_session.rb

   1 require 'pg'
   2
   3 # allow access to the real Posqtgresql connection
   4 class ActiveRecord::ConnectionAdapters::PostgreSQLAdapter
   5   attr_reader :connection
   6 end
   7
   8 # PostgresqlSession is a down to the bare metal session store
   9 # implementation to be used with +SQLSessionStore+. It is much faster
  10 # than the default ActiveRecord implementation.
  11 #
  12 # The implementation assumes that the table column names are 'id',
  13 # 'session_id', 'data', 'created_at' and 'updated_at'. If you want use
  14 # other names, you will need to change the SQL statments in the code.
  15 #
  16 # This table layout is compatible with ActiveRecordStore.
  17
  18 class PostgresqlSession
  19
  20   # if you need Rails components, and you have a pages which create
  21   # new sessions, and embed components insides these pages that need
  22   # session access, then you *must* set +eager_session_creation+ to
  23   # true (as of Rails 1.0). Not needed for Rails 1.1 and up.
  24   cattr_accessor :eager_session_creation
  25   @@eager_session_creation = false
  26
  27   attr_accessor :id, :session_id, :data
  28
  29   def initialize(session_id, data)
  30     @session_id = session_id
  31     @data = data
  32     @id = nil
  33   end
  34
  35   class << self
  36
  37     # retrieve the session table connection and get the 'raw' Postgresql connection from it
  38     def session_connection
  39       SqlSession.connection.connection
  40     end
  41
  42     # try to find a session with a given +session_id+. returns nil if
  43     # no such session exists. note that we don't retrieve
  44     # +created_at+ and +updated_at+ as they are not accessed anywhyere
  45     # outside this class.
  46     def find_session(session_id)
  47       connection = session_connection
  48       result = connection.query("SELECT id, data FROM sessions WHERE session_id = $1 LIMIT 1", [session_id])
  49       my_session = new(session_id, result.getvalue(0, 1))
  50       my_session.id = result.getvalue(0, 0)
  51       result.clear
  52       my_session
  53     end
  54
  55     # create a new session with given +session_id+ and +data+
  56     # and save it immediately to the database
  57     def create_session(session_id, data)
  58       new_session = new(session_id, data)
  59       if @@eager_session_creation
  60         connection = session_connection
  61         connection.query("INSERT INTO sessions (created_at, updated_at, session_id, data) VALUES (NOW(), NOW(), $1, $2)", [session_id, data])
  62         new_session.id = connection.lastval
  63       end
  64       new_session
  65     end
  66
  67     # delete all sessions meeting a given +condition+. it is the
  68     # caller's responsibility to pass a valid sql condition
  69     def delete_all(id=nil)
  70       if id
  71         session_connection.query("DELETE FROM sessions WHERE session_id = $1", [id])
  72       else
  73         session_connection.query("DELETE FROM sessions")
  74       end
  75     end
  76
  77   end # class methods
  78
  79   # update session with given +data+.
  80   # unlike the default implementation using ActiveRecord, updating of
  81   # column `updated_at` will be done by the database itself
  82   def update_session(data)
  83     connection = self.class.session_connection
  84     if @id
  85       # if @id is not nil, this is a session already stored in the database
  86       # update the relevant field using @id as key
  87       connection.query("UPDATE sessions SET updated_at = NOW(), data = $1 WHERE id = $2", [data, @id])
  88     else
  89       # if @id is nil, we need to create a new session in the database
  90       # and set @id to the primary key of the inserted record
  91       result = connection.query("INSERT INTO sessions (created_at,  updated_at, session_id, data) VALUES (NOW(), NOW(), $1, $2) RETURNING id", [@session_id, data])
  92       @id = result.getvalue(0, 0)
  93       result.clear
  94     end
  95   end
  96
  97   # destroy the current session
  98   def destroy
  99     self.class.delete_all(session_id)
 100   end
 101
 102 end
 103
 104 __END__
 105
 106 # This software is released under the MIT license
 107 #
 108 # Copyright (c) 2006-2008 Stefan Kaes
 109
 110 # Permission is hereby granted, free of charge, to any person obtaining
 111 # a copy of this software and associated documentation files (the
 112 # "Software"), to deal in the Software without restriction, including
 113 # without limitation the rights to use, copy, modify, merge, publish,
 114 # distribute, sublicense, and/or sell copies of the Software, and to
 115 # permit persons to whom the Software is furnished to do so, subject to
 116 # the following conditions:
 117
 118 # The above copyright notice and this permission notice shall be
 119 # included in all copies or substantial portions of the Software.
 120
 121 # THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND,
 122 # EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
 123 # MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND
 124 # NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE
 125 # LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION
 126 # OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION
 127 # WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 128