Class: ActiveSupport::Cache::Entry

Inherits:
Object
  • Object
show all
Defined in:
lib/active_support/cache.rb

Overview

This class is used to represent cache entries. Cache entries have a value and an optional expiration time. The expiration time is used to support the :race_condition_ttl option on the cache.

Since cache entries in most instances will be serialized, the internals of this class are highly optimized using short instance variable names that are lazily defined.

Constant Summary collapse

DEFAULT_COMPRESS_LIMIT =

:nodoc:

16.kilobytes

Instance Method Summary collapse

Constructor Details

#initialize(value, options = {}) ⇒ Entry

Create a new cache entry for the specified value. Options supported are :compress, :compress_threshold, and :expires_in.



576
577
578
579
580
581
582
583
584
585
586
 
# File 'lib/active_support/cache.rb', line 576

def initialize(value, options = {})
  if should_compress?(value, options)
    @value = compress(value)
    @compressed = true
  else
    @value = value
  end
  @created_at = Time.now.to_f
  @expires_in = options[:expires_in]
  @expires_in = @expires_in.to_f if @expires_in
end

Instance Method Details

#dup_value! ⇒ Object

Duplicate the value in a class. This is used by cache implementations that don’t natively serialize entries to protect against accidental cache modifications.



631
632
633
634
635
636
637
638
639
640
 
# File 'lib/active_support/cache.rb', line 631

def dup_value!
  convert_version_4beta1_entry! if defined?(@v)
  if @value && !compressed? && !(@value.is_a?(Numeric) || @value == true || @value == false)
    if @value.is_a?(String)
      @value = @value.dup
    else
      @value = Marshal.load(Marshal.dump(@value))
    end
  end
end

#expired? ⇒ Boolean

Check if the entry is expired. The expires_in parameter can override the value set when the entry was created.

Returns:

  • (Boolean) 


595
596
597
598
 
# File 'lib/active_support/cache.rb', line 595

def expired?
  convert_version_4beta1_entry! if defined?(@value)
  @expires_in && @created_at + @expires_in <= Time.now.to_f
end

#expires_at ⇒ Object 



600
601
602
 
# File 'lib/active_support/cache.rb', line 600

def expires_at
  @expires_in ? @created_at + @expires_in : nil
end

#expires_at=(value) ⇒ Object 



604
605
606
607
608
609
610
 
# File 'lib/active_support/cache.rb', line 604

def expires_at=(value)
  if value
    @expires_in = value.to_f - @created_at
  else
    @expires_in = nil
  end
end

#size ⇒ Object

Returns the size of the cached value. This could be less than value.size if the data is compressed.



614
615
616
617
618
619
620
621
622
623
624
625
626
627
 
# File 'lib/active_support/cache.rb', line 614

def size
  if defined?(@s)
    @s
  else
    case value
    when NilClass
      0
    when String
      @value.bytesize
    else
      @s = Marshal.dump(@value).bytesize
    end
  end
end

#value ⇒ Object 



588
589
590
591
 
# File 'lib/active_support/cache.rb', line 588

def value
  convert_version_4beta1_entry! if defined?(@v)
  compressed? ? uncompress(@value) : @value
end