Class: Sequel::SQL::Expression

Inherits:
Object
  • Object
show all
Defined in:
lib/sequel/sql.rb

Overview

Base class for all SQL expression objects.

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.attr_reader(*args) ⇒ Object

Expression objects are assumed to be value objects, where their attribute values can’t change after assignment. In order to make it easy to define equality and hash methods, subclass instances assume that the only values that affect the results of such methods are the values of the object’s attributes.



58
59
60
61
 
# File 'lib/sequel/sql.rb', line 58

def self.attr_reader(*args)
  super
  comparison_attrs.concat args
end

.comparison_attrs ⇒ Object

All attributes used for equality and hash methods.



64
65
66
 
# File 'lib/sequel/sql.rb', line 64

def self.comparison_attrs
  @comparison_attrs ||= self == Expression ? [] : superclass.comparison_attrs.clone
end

Instance Method Details

#==(other) ⇒ Object

Alias of eql?



77
78
79
 
# File 'lib/sequel/sql.rb', line 77

def ==(other)
  eql?(other)
end

#eql?(other) ⇒ Boolean

Returns true if the receiver is the same expression as the the other expression.

Returns:

  • (Boolean) 


83
84
85
 
# File 'lib/sequel/sql.rb', line 83

def eql?(other)
  other.is_a?(self.class) && !self.class.comparison_attrs.find{|a| send(a) != other.send(a)}
end

#hash ⇒ Object

Make sure that the hash value is the same if the attributes are the same.



88
89
90
 
# File 'lib/sequel/sql.rb', line 88

def hash
  ([self.class] + self.class.comparison_attrs.map{|x| send(x)}).hash
end

#inspect ⇒ Object

Show the class name and instance variables for the object, necessary for correct operation on ruby 1.9.2.



94
95
96
 
# File 'lib/sequel/sql.rb', line 94

def inspect
  "#<#{self.class} #{instance_variables.map{|iv| "#{iv}=>#{instance_variable_get(iv).inspect}"}.join(', ')}>"
end

#lit ⇒ Object

Returns self, because SQL::Expression already acts like LiteralString.



99
100
101
 
# File 'lib/sequel/sql.rb', line 99

def lit
  self
end

#sql_literal(ds) ⇒ Object

Alias of to_s



104
105
106
 
# File 'lib/sequel/sql.rb', line 104

def sql_literal(ds)
  to_s(ds)
end