Class: ActionDispatch::Request::Session
- Inherits:
-
Object
- Object
- ActionDispatch::Request::Session
- Defined in:
- lib/action_dispatch/request/session.rb
Overview
Session is responsible for lazily loading the session from store.
Defined Under Namespace
Classes: Options
Constant Summary collapse
- ENV_SESSION_KEY =
:nodoc:
Rack::RACK_SESSION
- ENV_SESSION_OPTIONS_KEY =
:nodoc:
Rack::RACK_SESSION_OPTIONS
- Unspecified =
Singleton object used to determine if an optional param wasn’t specified.
Object.new
Class Method Summary collapse
-
.create(store, req, default_options) ⇒ Object
Creates a session hash, merging the properties of the previous session if any.
- .find(req) ⇒ Object
- .set(req, session) ⇒ Object
Instance Method Summary collapse
-
#[](key) ⇒ Object
Returns value of the key stored in the session or
nil
if the given key is not found in the session. -
#[]=(key, value) ⇒ Object
Writes given value to given key of the session.
-
#clear ⇒ Object
Clears the session.
-
#delete(key) ⇒ Object
Deletes given key from the session.
- #destroy ⇒ Object
-
#dig(*keys) ⇒ Object
Returns the nested value specified by the sequence of keys, returning
nil
if any intermediate step isnil
. - #each(&block) ⇒ Object
- #empty? ⇒ Boolean
- #exists? ⇒ Boolean
-
#fetch(key, default = Unspecified, &block) ⇒ Object
Returns value of the given key from the session, or raises
KeyError
if can’t find the given key and no default value is set. -
#has_key?(key) ⇒ Boolean
(also: #key?, #include?)
Returns true if the session has the given key or false.
- #id ⇒ Object
-
#initialize(by, req) ⇒ Session
constructor
A new instance of Session.
- #inspect ⇒ Object
-
#keys ⇒ Object
Returns keys of the session as Array.
- #loaded? ⇒ Boolean
- #merge!(other) ⇒ Object
- #options ⇒ Object
-
#to_hash ⇒ Object
(also: #to_h)
Returns the session as Hash.
-
#update(hash) ⇒ Object
Updates the session with given Hash.
-
#values ⇒ Object
Returns values of the session as Array.
Constructor Details
#initialize(by, req) ⇒ Session
Returns a new instance of Session.
63 64 65 66 67 68 69 |
# File 'lib/action_dispatch/request/session.rb', line 63 def initialize(by, req) @by = by @req = req @delegate = {} @loaded = false @exists = nil # We haven't checked yet. end |
Class Method Details
.create(store, req, default_options) ⇒ Object
Creates a session hash, merging the properties of the previous session if any.
16 17 18 19 20 21 22 23 24 |
# File 'lib/action_dispatch/request/session.rb', line 16 def self.create(store, req, ) session_was = find req session = Request::Session.new(store, req) session.merge! session_was if session_was set(req, session) Options.set(req, Request::Session::Options.new(store, )) session end |
.find(req) ⇒ Object
26 27 28 |
# File 'lib/action_dispatch/request/session.rb', line 26 def self.find(req) req.get_header ENV_SESSION_KEY end |
.set(req, session) ⇒ Object
30 31 32 |
# File 'lib/action_dispatch/request/session.rb', line 30 def self.set(req, session) req.set_header ENV_SESSION_KEY, session end |
Instance Method Details
#[](key) ⇒ Object
Returns value of the key stored in the session or nil
if the given key is not found in the session.
91 92 93 94 |
# File 'lib/action_dispatch/request/session.rb', line 91 def [](key) load_for_read! @delegate[key.to_s] end |
#[]=(key, value) ⇒ Object
Writes given value to given key of the session.
125 126 127 128 |
# File 'lib/action_dispatch/request/session.rb', line 125 def []=(key, value) load_for_write! @delegate[key.to_s] = value end |
#clear ⇒ Object
Clears the session.
131 132 133 134 |
# File 'lib/action_dispatch/request/session.rb', line 131 def clear load_for_write! @delegate.clear end |
#delete(key) ⇒ Object
Deletes given key from the session.
159 160 161 162 |
# File 'lib/action_dispatch/request/session.rb', line 159 def delete(key) load_for_write! @delegate.delete key.to_s end |
#destroy ⇒ Object
79 80 81 82 83 84 85 86 87 |
# File 'lib/action_dispatch/request/session.rb', line 79 def destroy clear = self. || {} @by.send(:delete_session, @req, .id(@req), ) # Load the new sid to be written with the response. @loaded = false load_for_write! end |
#dig(*keys) ⇒ Object
Returns the nested value specified by the sequence of keys, returning nil
if any intermediate step is nil
.
98 99 100 101 102 |
# File 'lib/action_dispatch/request/session.rb', line 98 def dig(*keys) load_for_read! keys = keys.map.with_index { |key, i| i.zero? ? key.to_s : key } @delegate.dig(*keys) end |
#each(&block) ⇒ Object
214 215 216 |
# File 'lib/action_dispatch/request/session.rb', line 214 def each(&block) to_hash.each(&block) end |
#empty? ⇒ Boolean
204 205 206 207 |
# File 'lib/action_dispatch/request/session.rb', line 204 def empty? load_for_read! @delegate.empty? end |
#exists? ⇒ Boolean
195 196 197 198 |
# File 'lib/action_dispatch/request/session.rb', line 195 def exists? return @exists unless @exists.nil? @exists = @by.send(:session_exists?, @req) end |
#fetch(key, default = Unspecified, &block) ⇒ Object
Returns value of the given key from the session, or raises KeyError
if can’t find the given key and no default value is set. Returns default value if specified.
session.fetch(:foo)
# => KeyError: key not found: "foo"
session.fetch(:foo, :bar)
# => :bar
session.fetch(:foo) do
:bar
end
# => :bar
178 179 180 181 182 183 184 185 |
# File 'lib/action_dispatch/request/session.rb', line 178 def fetch(key, default = Unspecified, &block) load_for_read! if default == Unspecified @delegate.fetch(key.to_s, &block) else @delegate.fetch(key.to_s, default, &block) end end |
#has_key?(key) ⇒ Boolean Also known as: key?, include?
Returns true if the session has the given key or false.
105 106 107 108 |
# File 'lib/action_dispatch/request/session.rb', line 105 def has_key?(key) load_for_read! @delegate.key?(key.to_s) end |
#id ⇒ Object
71 72 73 |
# File 'lib/action_dispatch/request/session.rb', line 71 def id .id(@req) end |
#inspect ⇒ Object
187 188 189 190 191 192 193 |
# File 'lib/action_dispatch/request/session.rb', line 187 def inspect if loaded? super else "#<#{self.class}:0x#{(object_id << 1).to_s(16)} not yet loaded>" end end |
#keys ⇒ Object
Returns keys of the session as Array.
113 114 115 116 |
# File 'lib/action_dispatch/request/session.rb', line 113 def keys load_for_read! @delegate.keys end |
#loaded? ⇒ Boolean
200 201 202 |
# File 'lib/action_dispatch/request/session.rb', line 200 def loaded? @loaded end |
#merge!(other) ⇒ Object
209 210 211 212 |
# File 'lib/action_dispatch/request/session.rb', line 209 def merge!(other) load_for_write! @delegate.merge!(other) end |
#options ⇒ Object
75 76 77 |
# File 'lib/action_dispatch/request/session.rb', line 75 def Options.find @req end |
#to_hash ⇒ Object Also known as: to_h
Returns the session as Hash.
137 138 139 140 |
# File 'lib/action_dispatch/request/session.rb', line 137 def to_hash load_for_read! @delegate.dup.delete_if { |_, v| v.nil? } end |
#update(hash) ⇒ Object
Updates the session with given Hash.
session.to_hash
# => {"session_id"=>"e29b9ea315edf98aad94cc78c34cc9b2"}
session.update({ "foo" => "bar" })
# => {"session_id"=>"e29b9ea315edf98aad94cc78c34cc9b2", "foo" => "bar"}
session.to_hash
# => {"session_id"=>"e29b9ea315edf98aad94cc78c34cc9b2", "foo" => "bar"}
153 154 155 156 |
# File 'lib/action_dispatch/request/session.rb', line 153 def update(hash) load_for_write! @delegate.update stringify_keys(hash) end |
#values ⇒ Object
Returns values of the session as Array.
119 120 121 122 |
# File 'lib/action_dispatch/request/session.rb', line 119 def values load_for_read! @delegate.values end |