Class: Moneta::Fallback

Inherits:
Wrapper show all
Defined in:
lib/moneta/fallback.rb

Overview

Provides a fallback to a second store when an exception is raised

Examples:

Basic usage - catches any IOError and falls back to Adapters:Null

Moneta.build do
  use :Fallback
  adapter :Client
end

Specifying an exception to rescue

Moneta.build do
  use :Fallback, rescue: Redis::CannotConnectError
  adapter :Redis
end

Specifying a different fallback

Moneta.build do
  use :Fallback do
    # This is a new builder context
    adapter :Memory
  end
  adapter :File, dir: 'cache'
end

API:

  • public

Instance Attribute Summary

Attributes inherited from Proxy

#adapter

Instance Method Summary collapse

Methods inherited from Wrapper

#clear, #close, #config, #create, #delete, #each_key, #features, #fetch_values, #increment, #key?, #load, #merge!, #slice, #store, #values_at

Methods inherited from Proxy

#clear, #close, #config, #create, #delete, #each_key, #features, features_mask, #fetch_values, #increment, #key?, #load, #merge!, not_supports, #slice, #store, #values_at

Methods included from Config

#config, included

Methods included from Defaults

#[], #[]=, #close, #create, #decrement, #each_key, #features, #fetch, #fetch_values, included, #increment, #key?, #merge!, #slice, #supports?, #update, #values_at

Methods included from OptionSupport

#expires, #prefix, #raw, #with

Constructor Details

#initialize(adapter, options = {}, &block) ⇒ Fallback

Returns a new instance of Fallback.

Options Hash (options):

  • :fallback (Moneta store) — default: :Null store —

    The store to fall back on

  • :rescue (Class|Array<Class>) — default: [IOError] —

    The list of exceptions that should be rescued

Yield Returns:

  • (Moneta store) —

    Moneta store built using the builder API

Parameters:

  • The underlying store

  • (defaults to: {})

API:

  • public



34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
 
# File 'lib/moneta/fallback.rb', line 34

def initialize(adapter, options = {}, &block)
  super

  @fallback =
    if block_given?
      ::Moneta.build(&block)
    elsif options.key?(:fallback)
      options.delete(:fallback)
    else
      ::Moneta::Adapters::Null.new
    end

  @rescue =
    case options[:rescue]
    when nil
      [::IOError]
    when Array
      options[:rescue]
    else
      [options[:rescue]]
    end
end