Class: Arel::Nodes::BoundSqlLiteral

Inherits:
NodeExpression show all
Defined in:
lib/arel/nodes/bound_sql_literal.rb

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Math

#&, #*, #-, #/, #<<, #>>, #^, #|, #~@

Methods included from OrderPredications

#asc, #desc

Methods included from AliasPredication

#as

Methods included from Predications

#between, #concat, #contains, #does_not_match, #does_not_match_all, #does_not_match_any, #does_not_match_regexp, #eq, #eq_all, #eq_any, #gt, #gt_all, #gt_any, #gteq, #gteq_all, #gteq_any, #in, #in_all, #in_any, #is_distinct_from, #is_not_distinct_from, #lt, #lt_all, #lt_any, #lteq, #lteq_all, #lteq_any, #matches, #matches_all, #matches_any, #matches_regexp, #not_between, #not_eq, #not_eq_all, #not_eq_any, #not_in, #not_in_all, #not_in_any, #overlaps, #quoted_array, #when

Methods included from Expressions

#average, #count, #extract, #maximum, #minimum, #sum

Methods inherited from Node

#and, #equality?, #fetch_attribute, #invert, #not, #or, #to_sql

Methods included from FactoryMethods

#cast, #coalesce, #create_and, #create_false, #create_join, #create_on, #create_string_join, #create_table_alias, #create_true, #grouping, #lower

Constructor Details

#initialize(sql_with_placeholders, positional_binds, named_binds) ⇒ BoundSqlLiteral

Returns a new instance of BoundSqlLiteral.



8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
 
# File 'lib/arel/nodes/bound_sql_literal.rb', line 8

def initialize(sql_with_placeholders, positional_binds, named_binds)
  has_positional = !(positional_binds.nil? || positional_binds.empty?)
  has_named = !(named_binds.nil? || named_binds.empty?)

  if has_positional
    if has_named
      raise BindError.new("cannot mix positional and named binds", sql_with_placeholders)
    end
    if positional_binds.size != (expected = sql_with_placeholders.count("?"))
      raise BindError.new("wrong number of bind variables (#{positional_binds.size} for #{expected})", sql_with_placeholders)
    end
  elsif has_named
    tokens_in_string = sql_with_placeholders.scan(/:(?<!::)([a-zA-Z]\w*)/).flatten.map(&:to_sym).uniq
    tokens_in_hash = named_binds.keys.map(&:to_sym).uniq

    if !(missing = (tokens_in_string - tokens_in_hash)).empty?
      if missing.size == 1
        raise BindError.new("missing value for #{missing.first.inspect}", sql_with_placeholders)
      else
        raise BindError.new("missing values for #{missing.inspect}", sql_with_placeholders)
      end
    end
  end

  @sql_with_placeholders = sql_with_placeholders
  if has_positional
    @positional_binds = positional_binds
    @named_binds = nil
  else
    @positional_binds = nil
    @named_binds = named_binds
  end
end

Instance Attribute Details

#named_binds ⇒ Object (readonly)

Returns the value of attribute named_binds.



6
7
8
 
# File 'lib/arel/nodes/bound_sql_literal.rb', line 6

def named_binds
  @named_binds
end

#positional_binds ⇒ Object (readonly)

Returns the value of attribute positional_binds.



6
7
8
 
# File 'lib/arel/nodes/bound_sql_literal.rb', line 6

def positional_binds
  @positional_binds
end

#sql_with_placeholders ⇒ Object (readonly)

Returns the value of attribute sql_with_placeholders.



6
7
8
 
# File 'lib/arel/nodes/bound_sql_literal.rb', line 6

def sql_with_placeholders
  @sql_with_placeholders
end

Instance Method Details

#+(other) ⇒ Object

Raises:

  • (ArgumentError) 


54
55
56
57
58
 
# File 'lib/arel/nodes/bound_sql_literal.rb', line 54

def +(other)
  raise ArgumentError, "Expected Arel node" unless Arel.arel_node?(other)

  Fragments.new([self, other])
end

#eql?(other) ⇒ Boolean Also known as: ==

Returns:

  • (Boolean) 


46
47
48
49
50
51
 
# File 'lib/arel/nodes/bound_sql_literal.rb', line 46

def eql?(other)
  self.class == other.class &&
    sql_with_placeholders == other.sql_with_placeholders &&
    positional_binds == other.positional_binds &&
    named_binds == other.named_binds
end

#hash ⇒ Object 



42
43
44
 
# File 'lib/arel/nodes/bound_sql_literal.rb', line 42

def hash
  [self.class, sql_with_placeholders, positional_binds, named_binds].hash
end

#inspect ⇒ Object 



60
61
62
 
# File 'lib/arel/nodes/bound_sql_literal.rb', line 60

def inspect
  "#<#{self.class.name} #{sql_with_placeholders.inspect} #{(named_binds || positional_binds).inspect}>"
end