Module: Mongo::Conversions

Included in:
Collection, Cursor
Defined in:
lib/mongo/util/conversions.rb

Overview

Utility module to include when needing to convert certain types of objects to mongo-friendly parameters.

Constant Summary collapse

ASCENDING_CONVERSION = 
["ascending", "asc", "1"]
DESCENDING_CONVERSION = 
["descending", "desc", "-1"]

Instance Method Summary collapse

Instance Method Details

#array_as_sort_parameters(value) ⇒ Object

Converts the supplied Array to a Hash to pass to mongo as sorting parameters. The returned Hash will vary depending on whether the passed Array is one or two dimensional.

Example:

array_as_sort_parameters([["field1", :asc], ["field2", :desc]]) => { "field1" => 1, "field2" => -1}



43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
 
# File 'lib/mongo/util/conversions.rb', line 43

def array_as_sort_parameters(value)
  order_by = OrderedHash.new
  if value.first.is_a? Array
    value.each do |param|
      if (param.class.name == "String")
        order_by[param] = 1
      else
        order_by[param[0]] = sort_value(param[1]) unless param[1].nil?
      end
    end
  elsif !value.empty?
    if order_by.size == 1
      order_by[value.first] = 1
    else
      order_by[value.first] = sort_value(value[1])
    end
  end
  order_by
end

#formatted_sort_clause(sort) ⇒ Object 



25
26
27
28
29
30
31
32
33
 
# File 'lib/mongo/util/conversions.rb', line 25

def formatted_sort_clause(sort)
  case sort
  when String, Symbol then string_as_sort_parameters(sort)
  when Array then array_as_sort_parameters(sort)
  else
    raise InvalidSortValueError, "Illegal sort clause, '#{sort}'; must be of the form " +
      "[['field1', '(ascending|descending)'], ['field2', '(ascending|descending)']]"
  end
end

#sort_value(value) ⇒ Object

Converts the String, Symbol, or Integer to the corresponding sort value in MongoDB.

Valid conversions (case-insensitive):

ascending, asc, :ascending, :asc, 1 => 1 descending, desc, :descending, :desc, -1 => -1

If the value is invalid then an error will be raised.

Raises:



87
88
89
90
91
92
93
94
95
 
# File 'lib/mongo/util/conversions.rb', line 87

def sort_value(value)
  val = value.to_s.downcase
  return 1 if ASCENDING_CONVERSION.include?(val)
  return -1 if DESCENDING_CONVERSION.include?(val)
  raise InvalidSortValueError.new(
    "#{self} was supplied as a sort direction when acceptable values are: " +
    "Mongo::ASCENDING, 'ascending', 'asc', :ascending, :asc, 1, Mongo::DESCENDING, " +
    "'descending', 'desc', :descending, :desc, -1.")
end

#string_as_sort_parameters(value) ⇒ Object

Converts the supplied String or Symbol to a Hash to pass to mongo as a sorting parameter with ascending order. If the String is empty then an empty Hash will be returned.

Example:

*DEPRECATED

string_as_sort_parameters("field") => { "field" => 1 } string_as_sort_parameters("") => {}



73
74
75
76
 
# File 'lib/mongo/util/conversions.rb', line 73

def string_as_sort_parameters(value)
  return {} if (str = value.to_s).empty?
  { str => 1 }
end