Class: ActionDispatch::Cookies::CookieJar

Inherits:
Object
  • Object
show all
Includes:
ChainedCookieJars, Enumerable
Defined in:
lib/action_dispatch/middleware/cookies.rb

Overview

:nodoc:

Instance Attribute Summary collapse

Class Method Summary collapse

Instance Method Summary collapse

Methods included from ChainedCookieJars

#encrypted, #permanent, #signed, #signed_or_encrypted

Constructor Details

#initialize(request) ⇒ CookieJar

Returns a new instance of CookieJar.



324
325
326
327
328
329
330
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 324

def initialize(request)
  @set_cookies = {}
  @delete_cookies = {}
  @request = request
  @cookies = {}
  @committed = false
end

Instance Attribute Details

#request ⇒ Object (readonly)

Returns the value of attribute request.



322
323
324
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 322

def request
  @request
end

Class Method Details

.build(req, cookies) ⇒ Object 



316
317
318
319
320
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 316

def self.build(req, cookies)
  jar = new(req)
  jar.update(cookies)
  jar
end

Instance Method Details

#[](name) ⇒ Object

Returns the value of the cookie by ‘name`, or `nil` if no such cookie exists.



345
346
347
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 345

def [](name)
  @cookies[name.to_s]
end

#[]=(name, options) ⇒ Object

Sets the cookie named ‘name`. The second argument may be the cookie’s value or a hash of options as documented above.



379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 379

def []=(name, options)
  if options.is_a?(Hash)
    options.symbolize_keys!
    value = options[:value]
  else
    value = options
    options = { value: value }
  end

  handle_options(options)

  if @cookies[name.to_s] != value || options[:expires]
    @cookies[name.to_s] = value
    @set_cookies[name.to_s] = options
    @delete_cookies.delete(name.to_s)
  end

  value
end

#clear(options = {}) ⇒ Object

Removes all cookies on the client machine by calling ‘delete` for each cookie.



425
426
427
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 425

def clear(options = {})
  @cookies.each_key { |k| delete(k, options) }
end

#commit! ⇒ Object 



334
335
336
337
338
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 334

def commit!
  @committed = true
  @set_cookies.freeze
  @delete_cookies.freeze
end

#committed? ⇒ Boolean

Returns:

  • (Boolean) 


332
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 332

def committed?; @committed; end

#delete(name, options = {}) ⇒ Object

Removes the cookie on the client machine by setting the value to an empty string and the expiration date in the past. Like ‘[]=`, you can pass in an options hash to delete cookies with extra data such as a `:path`.

Returns the value of the cookie, or ‘nil` if the cookie does not exist.



404
405
406
407
408
409
410
411
412
413
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 404

def delete(name, options = {})
  return unless @cookies.has_key? name.to_s

  options.symbolize_keys!
  handle_options(options)

  value = @cookies.delete(name.to_s)
  @delete_cookies[name.to_s] = options
  value
end

#deleted?(name, options = {}) ⇒ Boolean

Whether the given cookie is to be deleted by this CookieJar. Like ‘[]=`, you can pass in an options hash to test if a deletion applies to a specific `:path`, `:domain` etc.

Returns:

  • (Boolean) 


418
419
420
421
422
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 418

def deleted?(name, options = {})
  options.symbolize_keys!
  handle_options(options)
  @delete_cookies[name.to_s] == options
end

#each(&block) ⇒ Object 



340
341
342
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 340

def each(&block)
  @cookies.each(&block)
end

#fetch(name, *args, &block) ⇒ Object 



349
350
351
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 349

def fetch(name, *args, &block)
  @cookies.fetch(name.to_s, *args, &block)
end

#key?(name) ⇒ Boolean Also known as: has_key?

Returns:

  • (Boolean) 


353
354
355
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 353

def key?(name)
  @cookies.key?(name.to_s)
end

#to_header ⇒ Object 



373
374
375
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 373

def to_header
  @cookies.map { |k, v| "#{escape(k)}=#{escape(v)}" }.join "; "
end

#update(other_hash) ⇒ Object 



361
362
363
364
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 361

def update(other_hash)
  @cookies.update other_hash.stringify_keys
  self
end

#update_cookies_from_jar ⇒ Object 



366
367
368
369
370
371
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 366

def update_cookies_from_jar
  request_jar = @request.cookie_jar.instance_variable_get(:@cookies)
  set_cookies = request_jar.reject { |k, _| @delete_cookies.key?(k) || @set_cookies.key?(k) }

  @cookies.update set_cookies if set_cookies
end

#write(response) ⇒ Object 



429
430
431
432
433
434
435
436
437
438
439
 
# File 'lib/action_dispatch/middleware/cookies.rb', line 429

def write(response)
  @set_cookies.each do |name, value|
    if write_cookie?(value)
      response.set_cookie(name, value)
    end
  end

  @delete_cookies.each do |name, value|
    response.delete_cookie(name, value)
  end
end