rails--rails/activerecord/lib/arel/table.rb

118 lines
2.5 KiB
Ruby

# frozen_string_literal: true
module Arel # :nodoc: all
class Table
include Arel::FactoryMethods
include Arel::AliasPredication
@engine = nil
class << self; attr_accessor :engine; end
attr_accessor :name, :table_alias
# TableAlias and Table both have a #table_name which is the name of the underlying table
alias :table_name :name
def initialize(name, as: nil, klass: nil, type_caster: klass&.type_caster)
@name = name.to_s
@klass = klass
@type_caster = type_caster
# Sometime AR sends an :as parameter to table, to let the table know
# that it is an Alias. We may want to override new, and return a
# TableAlias node?
if as.to_s == @name
as = nil
end
@table_alias = as
end
def alias(name = "#{self.name}_2")
Nodes::TableAlias.new(self, name)
end
def from
SelectManager.new(self)
end
def join(relation, klass = Nodes::InnerJoin)
return from unless relation
case relation
when String, Nodes::SqlLiteral
raise EmptyJoinError if relation.empty?
klass = Nodes::StringJoin
end
from.join(relation, klass)
end
def outer_join(relation)
join(relation, Nodes::OuterJoin)
end
def group(*columns)
from.group(*columns)
end
def order(*expr)
from.order(*expr)
end
def where(condition)
from.where condition
end
def project(*things)
from.project(*things)
end
def take(amount)
from.take amount
end
def skip(amount)
from.skip amount
end
def having(expr)
from.having expr
end
def [](name, table = self)
name = name.to_s if name.is_a?(Symbol)
name = @klass.attribute_aliases[name] || name if @klass
Attribute.new(table, name)
end
def hash
# Perf note: aliases and table alias is excluded from the hash
# aliases can have a loop back to this table breaking hashes in parent
# relations, for the vast majority of cases @name is unique to a query
@name.hash
end
def eql?(other)
self.class == other.class &&
self.name == other.name &&
self.table_alias == other.table_alias
end
alias :== :eql?
def type_cast_for_database(attr_name, value)
type_caster.type_cast_for_database(attr_name, value)
end
def type_for_attribute(name)
type_caster.type_for_attribute(name)
end
def able_to_type_cast?
!type_caster.nil?
end
private
attr_reader :type_caster
end
end