Class: Rack::Utils::HeaderHash Private

Inherits:
Hash
  • Object
show all
Defined in:
lib/rack/utils.rb

Overview

This class is part of a private API. You should avoid using this class if possible, as it may be removed or be changed in the future.

A case-insensitive Hash that preserves the original case of a header when set.

Class Method Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(hash = {}) ⇒ HeaderHash

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns a new instance of HeaderHash.


434
435
436
437
438
# File 'lib/rack/utils.rb', line 434

def initialize(hash = {})
  super()
  @names = {}
  hash.each { |k, v| self[k] = v }
end

Class Method Details

.[](headers) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

:nodoc:


426
427
428
429
430
431
432
# File 'lib/rack/utils.rb', line 426

def self.[](headers)
  if headers.is_a?(HeaderHash) && !headers.frozen?
    return headers
  else
    return self.new(headers)
  end
end

Instance Method Details

#[](k) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.


464
465
466
# File 'lib/rack/utils.rb', line 464

def [](k)
  super(k) || super(@names[k.downcase])
end

#[]=(k, v) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.


468
469
470
471
472
473
# File 'lib/rack/utils.rb', line 468

def []=(k, v)
  canonical = k.downcase.freeze
  delete k if @names[canonical] && @names[canonical] != k # .delete is expensive, don't invoke it unless necessary
  @names[canonical] = k
  super k, v
end

#clearObject

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

on clear, we need to clear @names hash


447
448
449
450
# File 'lib/rack/utils.rb', line 447

def clear
  super
  @names.clear
end

#delete(k) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.


475
476
477
478
479
# File 'lib/rack/utils.rb', line 475

def delete(k)
  canonical = k.downcase
  result = super @names.delete(canonical)
  result
end

#eachObject

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.


452
453
454
455
456
# File 'lib/rack/utils.rb', line 452

def each
  super do |k, v|
    yield(k, v.respond_to?(:to_ary) ? v.to_ary.join("\n") : v)
  end
end

#fetch(k, *args) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.


489
490
491
# File 'lib/rack/utils.rb', line 489

def fetch(k, *args)
  super(@names[k.downcase] || k, *args)
end

#include?(k) ⇒ Boolean Also known as: has_key?, member?, key?

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

Returns:

  • (Boolean)

481
482
483
# File 'lib/rack/utils.rb', line 481

def include?(k)
  super || @names.include?(k.downcase)
end

#initialize_copy(other) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.

on dup/clone, we need to duplicate @names hash


441
442
443
444
# File 'lib/rack/utils.rb', line 441

def initialize_copy(other)
  super
  @names = other.names.dup
end

#merge(other) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.


498
499
500
501
# File 'lib/rack/utils.rb', line 498

def merge(other)
  hash = dup
  hash.merge! other
end

#merge!(other) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.


493
494
495
496
# File 'lib/rack/utils.rb', line 493

def merge!(other)
  other.each { |k, v| self[k] = v }
  self
end

#replace(other) ⇒ Object

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.


503
504
505
506
507
# File 'lib/rack/utils.rb', line 503

def replace(other)
  clear
  other.each { |k, v| self[k] = v }
  self
end

#to_hashObject

This method is part of a private API. You should avoid using this method if possible, as it may be removed or be changed in the future.


458
459
460
461
462
# File 'lib/rack/utils.rb', line 458

def to_hash
  hash = {}
  each { |k, v| hash[k] = v }
  hash
end