Module: ActiveRecord::ConnectionAdapters::PostgreSQL::Quoting

Included in:
ActiveRecord::ConnectionAdapters::PostgreSQLAdapter
Defined in:
lib/active_record/connection_adapters/postgresql/quoting.rb

Instance Method Summary collapse

Instance Method Details

#escape_bytea(value) ⇒ Object

Escapes binary strings for bytea input to the database.



6
7
8
# File 'lib/active_record/connection_adapters/postgresql/quoting.rb', line 6

def escape_bytea(value)
  @connection.escape_bytea(value) if value
end

#lookup_cast_type_from_column(column) ⇒ Object

:nodoc:



75
76
77
# File 'lib/active_record/connection_adapters/postgresql/quoting.rb', line 75

def lookup_cast_type_from_column(column) # :nodoc:
  type_map.lookup(column.oid, column.fmod, column.sql_type)
end

#quote_column_name(name) ⇒ Object

Quotes column names for use in SQL queries.



44
45
46
# File 'lib/active_record/connection_adapters/postgresql/quoting.rb', line 44

def quote_column_name(name) # :nodoc:
  @quoted_column_names[name] ||= PG::Connection.quote_ident(super).freeze
end

#quote_default_expression(value, column) ⇒ Object

:nodoc:



62
63
64
65
66
67
68
69
70
71
72
73
# File 'lib/active_record/connection_adapters/postgresql/quoting.rb', line 62

def quote_default_expression(value, column) # :nodoc:
  if value.is_a?(Proc)
    value.call
  elsif column.type == :uuid && value.include?("()")
    value # Does not quote function default values for UUID columns
  elsif column.respond_to?(:array?)
    value = type_cast_from_column(column, value)
    quote(value)
  else
    super
  end
end

#quote_schema_name(name) ⇒ Object

Quotes schema names for use in SQL queries.



35
36
37
# File 'lib/active_record/connection_adapters/postgresql/quoting.rb', line 35

def quote_schema_name(name)
  PG::Connection.quote_ident(name)
end

#quote_string(s) ⇒ Object

Quotes strings for use in SQL input.



18
19
20
# File 'lib/active_record/connection_adapters/postgresql/quoting.rb', line 18

def quote_string(s) #:nodoc:
  @connection.escape(s)
end

#quote_table_name(name) ⇒ Object

Checks the following cases:

  • table_name

  • “table.name”

  • schema_name.table_name

  • schema_name.“table.name”

  • “schema.name”.table_name

  • “schema.name”.“table.name”



30
31
32
# File 'lib/active_record/connection_adapters/postgresql/quoting.rb', line 30

def quote_table_name(name) # :nodoc:
  @quoted_table_names[name] ||= Utils.extract_schema_qualified_name(name.to_s).quoted.freeze
end

#quote_table_name_for_assignment(table, attr) ⇒ Object



39
40
41
# File 'lib/active_record/connection_adapters/postgresql/quoting.rb', line 39

def quote_table_name_for_assignment(table, attr)
  quote_column_name(attr)
end

#quoted_binary(value) ⇒ Object

:nodoc:



58
59
60
# File 'lib/active_record/connection_adapters/postgresql/quoting.rb', line 58

def quoted_binary(value) # :nodoc:
  "'#{escape_bytea(value.to_s)}'"
end

#quoted_date(value) ⇒ Object

Quote date/time values for use in SQL input.



49
50
51
52
53
54
55
56
# File 'lib/active_record/connection_adapters/postgresql/quoting.rb', line 49

def quoted_date(value) #:nodoc:
  if value.year <= 0
    bce_year = format("%04d", -value.year + 1)
    super.sub(/^-?\d+/, bce_year) + " BC"
  else
    super
  end
end

#unescape_bytea(value) ⇒ Object

Unescapes bytea output from a database to the binary string it represents. NOTE: This is NOT an inverse of escape_bytea! This is only to be used on escaped binary output from database drive.



13
14
15
# File 'lib/active_record/connection_adapters/postgresql/quoting.rb', line 13

def unescape_bytea(value)
  @connection.unescape_bytea(value) if value
end