Class: OccamsRecord::EagerLoaders::AdHocBase

Inherits:

Object

• Object
• OccamsRecord::EagerLoaders::AdHocBase

Includes:

Builder

Defined in:

lib/occams-record/eager_loaders/ad_hoc_base.rb

Overview

Base class for eager loading ad hoc associations.

Direct Known Subclasses

AdHocMany, AdHocOne

Instance Attribute Summary

• #name ⇒ String readonly

  Association name.

Instance Method Summary

• #initialize(name, mapping, sql, binds: {}, model: nil, use: nil) { ... } ⇒ AdHocBase constructor

  Initialize a new add hoc association.

• #run(rows, query_logger: nil, measurements: nil) ⇒ Object

  Run the query and merge the results into the given rows.

Methods included from Builder

#eager_load, #eager_load_many, #eager_load_one, #nest

Constructor Details

#initialize(name, mapping, sql, binds: {}, model: nil, use: nil) { ... } ⇒ AdHocBase

Initialize a new add hoc association.

Parameters:

• name (Symbol) —

  name of attribute to load records into

• mapping (Hash) —

  a Hash with the key being the parent id and the value being fkey in the child

• sql (String) —

  the SQL to query the associated records. Include a bind params called ‘%ids’ for the foreign/parent ids.

• binds (Hash) (defaults to: {}) —

  any additional binds for your query.

• model (ActiveRecord::Base) (defaults to: nil) —

  optional - ActiveRecord model that represents what you’re loading. required when using Sqlite.

• use (Array<Module>) (defaults to: nil) —

  optional - Ruby modules to include in the result objects (single or array)

Yields:

• eager load associations nested under this one

# File 'lib/occams-record/eager_loaders/ad_hoc_base.rb', line 25

def initialize(name, mapping, sql, binds: {}, model: nil, use: nil, &builder)
  @name, @mapping = name.to_s, mapping
  @sql, @binds, @use, @model = sql, binds, use, model
  @eager_loaders = EagerLoaders::Context.new(@model)
  instance_exec(&builder) if builder
end

Instance Attribute Details

#name ⇒ String (readonly)

Returns association name.

Returns:

• (String) —

  association name

# File 'lib/occams-record/eager_loaders/ad_hoc_base.rb', line 12

def name
  @name
end

Instance Method Details

#run(rows, query_logger: nil, measurements: nil) ⇒ Object

Run the query and merge the results into the given rows.

Parameters:

• rows (Array<OccamsRecord::Results::Row>) —

  Array of rows used to calculate the query.

• query_logger (Array<String>) (defaults to: nil)

# File 'lib/occams-record/eager_loaders/ad_hoc_base.rb', line 38

def run(rows, query_logger: nil, measurements: nil)
  fkey_binds = calc_fkey_binds rows
  assoc = if fkey_binds.all? { |_, vals| vals.any? }
            binds = @binds.merge(fkey_binds)
            RawQuery.new(@sql, binds, use: @use, eager_loaders: @eager_loaders, query_logger: query_logger, measurements: measurements).run
          else
            []
          end
  merge! assoc, rows
  nil
end