123456789_123456789_123456789_123456789_123456789_

Class: Arel::SelectManager

Do not use. This class is for internal use only.
Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, TreeManager
Instance Chain:
Inherits: Arel::TreeManager
Defined in: activerecord/lib/arel/select_manager.rb

Constant Summary

Class Method Summary

Instance Attribute Summary

Instance Method Summary

Constructor Details

.new(table = nil) ⇒ SelectManager

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 9

def initialize(table = nil)
  @ast = Nodes::SelectStatement.new(table)
  @ctx = @ast.cores.last
end

Instance Attribute Details

#limit (rw) Also known as: #taken

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 19

def limit
  @ast.limit && @ast.limit.expr
end

#limit=(limit) (rw)

Alias for #take.

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 242

alias limit= take

#offset (rw)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 28

def offset
  @ast.offset && @ast.offset.expr
end

#offset=(amount) (rw)

Alias for #skip.

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 40

alias :offset= :skip

#projections (rw)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 139

def projections
  @ctx.projections
end

#projections=(projections) (rw)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 143

def projections=(projections)
  @ctx.projections = projections
end

Instance Method Details

#as(other)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 48

def as(other)
  create_table_alias grouping(@ast), Nodes::SqlLiteral.new(other, retryable: true)
end

#collapse(exprs) (private)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 258

def collapse(exprs)
  exprs = exprs.compact
  exprs.map! { |expr|
    if String === expr
      # FIXME: Don't do this automatically
      Arel.sql(expr)
    else
      expr
    end
  }

  if exprs.length == 1
    exprs.first
  else
    create_and exprs
  end
end

#comment(*values)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 252

def comment(*values)
  @ctx.comment = Nodes::Comment.new(values)
  self
end

#constraints

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 24

def constraints
  @ctx.wheres
end

#distinct(value = true)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 154

def distinct(value = true)
  if value
    @ctx.set_quantifier = Arel::Nodes::Distinct.new
  else
    @ctx.set_quantifier = nil
  end
  self
end

#distinct_on(value)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 163

def distinct_on(value)
  if value
    @ctx.set_quantifier = Arel::Nodes::DistinctOn.new(value)
  else
    @ctx.set_quantifier = nil
  end
  self
end

#except(other) Also known as: #minus

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 213

def except(other)
  Nodes::Except.new ast, other.ast
end

#exists

Produces an Arel::Nodes::Exists node

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 44

def exists
  Arel::Nodes::Exists.new @ast
end

#from(table)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 85

def from(table)
  table = Nodes::SqlLiteral.new(table) if String === table

  case table
  when Nodes::Join
    @ctx.source.right << table
  else
    @ctx.source.left = table
  end

  self
end

#froms

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 98

def froms
  @ast.cores.filter_map { |x| x.from }
end

#group(*columns)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 74

def group(*columns)
  columns.each do |column|
    # FIXME: backwards compat
    column = Nodes::SqlLiteral.new(column) if String === column
    column = Nodes::SqlLiteral.new(column.to_s) if Symbol === column

    @ctx.groups.push Nodes::Group.new column
  end
  self
end

#having(expr)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 119

def having(expr)
  @ctx.havings << expr
  self
end

#initialize_copy(other)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 14

def initialize_copy(other)
  super
  @ctx = @ast.cores.last
end

#intersect(other)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 209

def intersect(other)
  Nodes::Intersect.new ast, other.ast
end

#join(relation, klass = Nodes::InnerJoin)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 102

def join(relation, klass = Nodes::InnerJoin)
  return self unless relation

  case relation
  when String, Nodes::SqlLiteral
    raise EmptyJoinError if relation.empty?
    klass = Nodes::StringJoin
  end

  @ctx.source.right << create_join(relation, nil, klass)
  self
end

#join_sources

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 244

def join_sources
  @ctx.source.right
end

#lateral(table_name = nil)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 218

def lateral(table_name = nil)
  base = table_name.nil? ? ast : as(table_name)
  Nodes::Lateral.new(base)
end

#lock(locking = Arel.sql("FOR UPDATE"))

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 52

def lock(locking = Arel.sql("FOR UPDATE"))
  case locking
  when true
    locking = Arel.sql("FOR UPDATE")
  when Arel::Nodes::SqlLiteral
  when String
    locking = Arel.sql locking
  end

  @ast.lock = Nodes::Lock.new(locking)
  self
end

#locked

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 65

def locked
  @ast.lock
end

#minus(other)

Alias for #except.

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 216

alias :minus :except

#on(*exprs)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 69

def on(*exprs)
  @ctx.source.right.last.right = Nodes::On.new(collapse(exprs))
  self
end

#optimizer_hints(*hints)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 147

def optimizer_hints(*hints)
  unless hints.empty?
    @ctx.optimizer_hints = Arel::Nodes::OptimizerHints.new(hints)
  end
  self
end

#order(*expr)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 172

def order(*expr)
  # FIXME: We SHOULD NOT be converting these to SqlLiteral automatically
  @ast.orders.concat expr.map { |x|
    STRING_OR_SYMBOL_CLASS.include?(x.class) ? Nodes::SqlLiteral.new(x.to_s) : x
  }
  self
end

#orders

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 180

def orders
  @ast.orders
end

#outer_join(relation)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 115

def outer_join(relation)
  join(relation, Nodes::OuterJoin)
end

#project(*projections)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 130

def project(*projections)
  # FIXME: converting these to SQLLiterals is probably not good, but
  # rails tests require it.
  @ctx.projections.concat projections.map { |x|
    STRING_OR_SYMBOL_CLASS.include?(x.class) ? Nodes::SqlLiteral.new(x.to_s) : x
  }
  self
end

#skip(amount) Also known as: #offset=

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 32

def skip(amount)
  if amount
    @ast.offset = Nodes::Offset.new(amount)
  else
    @ast.offset = nil
  end
  self
end

#source

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 248

def source
  @ctx.source
end

#take(limit) Also known as: #limit=

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 234

def take(limit)
  if limit
    @ast.limit = Nodes::Limit.new(limit)
  else
    @ast.limit = nil
  end
  self
end

#taken

Alias for #limit.

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 22

alias :taken :limit

#union(operation, other = nil)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 198

def union(operation, other = nil)
  if other
    node_class = Nodes.const_get("Union#{operation.to_s.capitalize}")
  else
    other = operation
    node_class = Nodes::Union
  end

  node_class.new self.ast, other.ast
end

#where(expr)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 184

def where(expr)
  if Arel::TreeManager === expr
    expr = expr.ast
  end
  @ctx.wheres << expr
  self
end

#where_sql(engine = Table.engine)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 192

def where_sql(engine = Table.engine)
  return if @ctx.wheres.empty?

  Nodes::SqlLiteral.new("WHERE #{Nodes::And.new(@ctx.wheres).to_sql(engine)}")
end

#window(name)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 124

def window(name)
  window = Nodes::NamedWindow.new(name)
  @ctx.windows.push window
  window
end

#with(*subqueries)

[ GitHub ]

  
# File 'activerecord/lib/arel/select_manager.rb', line 223

def with(*subqueries)
  if subqueries.first.is_a? Symbol
    node_class = Nodes.const_get("With#{subqueries.shift.to_s.capitalize}")
  else
    node_class = Nodes::With
  end
  @ast.with = node_class.new(subqueries.flatten)

  self
end