123456789_123456789_123456789_123456789_123456789_

Class: ActionView::LookupContext

Do not use. This class is for internal use only.
Relationships & Source Files
Namespace Children
Modules:
Accessors, DetailsCache, ViewPaths
Classes:
DetailsKey
Super Chains via Extension / Inclusion / Inheritance
Instance Chain:
self, ViewPaths, DetailsCache, Accessors
Inherits: Object
Defined in: actionview/lib/action_view/lookup_context.rb

Overview

==========================

LookupContext is the object responsible for holding all information required for looking up templates, i.e. view paths and details. LookupContext is also responsible for generating a key, given to view paths, used in the resolver cache lookup. Since this key is generated only once during the request, it speeds up all cache accesses.

Class Method Summary

Instance Attribute Summary

ViewPaths - Included

#formats, #locale, #view_paths

DetailsCache - Included

#cache

Instance Method Summary

ViewPaths - Included

#any_templates?,
#append_view_path

Append a path to the list of view paths for the current LookupContext.
#details_for_lookup,
#lookup_context

LookupContext is the object responsible for holding all information required for looking up templates, i.e. view paths and details.
#prepend_view_path

Prepend a path to the list of view paths for the current LookupContext.
#template_exists?,
#_prefixes

The prefixes used in render "foo" shortcuts.

DetailsCache - Included

#disable_cache

Temporary skip passing the details_key forward.
#_set_detail,
#details_key

Calculate the details key.

Constructor Details

.new(view_paths, details = {}, prefixes = []) ⇒ LookupContext

[ GitHub ] 

  


# File 'actionview/lib/action_view/lookup_context.rb', line 249



def initialize(view_paths, details = {}, prefixes = [])
  @details_key = nil
  @digest_cache = nil
  @cache = true
  @prefixes = prefixes

  @details = initialize_details({}, details)
  @view_paths = build_view_paths(view_paths)
end


  







Class Method Details



  

    .register_detail(name, &block)  
  

  [ GitHub ]


  

  


# File 'actionview/lib/action_view/lookup_context.rb', line 24



def self.register_detail(name, &block)
  block = ActiveSupport::Ractors.shareable_proc(&block)
  @default_procs = @default_procs.merge(name => block).freeze
  @registered_details = @default_procs.keys.freeze

  Accessors.define_method(:"default_#{name}", &block)
  Accessors.module_eval <<-METHOD, __FILE__, __LINE__ + 1
    def #{name}
      @details[:#{name}] || []
    end

    def #{name}=(value)
      value = value.present? ? Array(value) : default_#{name}
      _set_detail(:#{name}, value) if value != @details[:#{name}]
    end
  METHOD
end


  








  

    .reset_view_context_class  
  

  [ GitHub ]


  

  


# File 'actionview/lib/action_view/lookup_context.rb', line 100



def self.reset_view_context_class
  @view_context_mutex.synchronize { @view_context_class = nil }
end


  








  

    .view_context_class  
  

  [ GitHub ]


  

  


# File 'actionview/lib/action_view/lookup_context.rb', line 104



def self.view_context_class
  return @view_context_class if @view_context_class
  base = ActionView::Base # prevent recursive locking
  @view_context_mutex.synchronize do
    @view_context_class = base.with_empty_template_cache
  end
end


  







Instance Attribute Details



  

    #default_procs   (readonly)
  

  [ GitHub ]


  

  


# File 'actionview/lib/action_view/lookup_context.rb', line 20



singleton_class.attr_reader :default_procs, :registered_details


  








  

    #formats=(values)   (writeonly)
  



  

    
Override formats= to expand ["*/*"] values and automatically
add :html as fallback to :js.

  



  [ GitHub ]


  

  


# File 'actionview/lib/action_view/lookup_context.rb', line 280



def formats=(values)
  if values
    values = values.dup
    values.concat(default_formats) if values.delete "*/*"
    values.uniq!

    Template.validate_formats(values)

    if (values.length == 1) && (values[0] == :js)
      values << :html
      @html_fallback_for_js = true
    end
  end
  super(values)
end


  








  

    #locale   (rw)
  



  

    
Override locale to return a symbol instead of array.

  



  [ GitHub ]


  

  


# File 'actionview/lib/action_view/lookup_context.rb', line 297



def locale
  @details[:locale].first
end


  








  

    #locale=(value)   (rw)
  



  

    
Overload locale= to also set the I18n.locale. If the current I18n.config object responds
to original_config, it means that it has a copy of the original ::I18n configuration and it's
acting as proxy, which we need to skip.

  



  [ GitHub ]


  

  


# File 'actionview/lib/action_view/lookup_context.rb', line 304



def locale=(value)
  if value
    config = I18n.config.respond_to?(:original_config) ? I18n.config.original_config : I18n.config
    config.locale = value
  end

  super(default_locale)
end


  








  

    #prefixes   (rw)
  

  [ GitHub ]


  

  


# File 'actionview/lib/action_view/lookup_context.rb', line 18



attr_accessor :prefixes


  








  

    #registered_details   (readonly)
  

  [ GitHub ]


  

  


# File 'actionview/lib/action_view/lookup_context.rb', line 20



singleton_class.attr_reader :default_procs, :registered_details


  







Instance Method Details



  

    #digest_cache  
  

  [ GitHub ]


  

  


# File 'actionview/lib/action_view/lookup_context.rb', line 259



def digest_cache
  @digest_cache ||= DetailsKey.digest_cache(@details)
end


  








  

    #initialize_details(target, details)   (private)
  

  [ GitHub ]


  

  


# File 'actionview/lib/action_view/lookup_context.rb', line 270



def initialize_details(target, details)
  LookupContext.registered_details.each do |k|
    target[k] = details[k] || LookupContext.default_procs[k].call
  end
  target
end


  








  

    #with_prepended_formats(formats)  
  

  [ GitHub ]


  

  


# File 'actionview/lib/action_view/lookup_context.rb', line 263



def with_prepended_formats(formats)
  details = @details.dup
  details[:formats] = formats

  self.class.new(@view_paths, details, @prefixes)
end