Module: GSolr::Connection::Utils

Included in:
Requestable
Defined in:
lib/gsolr/connection/utils.rb

Instance Method Summary collapse

Instance Method Details

#build_param(k, v) ⇒ Object

converts a key value pair to an escaped string: Example: build_param(:id, 1) == “id=1”



55
56
57
 
# File 'lib/gsolr/connection/utils.rb', line 55

def build_param(k,v)
  "#{escape(k)}=#{escape(v)}"
end

#build_url(url = '', params = {}, string_query = '') ⇒ Object

creates and returns a url as a string “url” is the base url “params” is an optional hash of GET style query params “string_query” is an extra query string that will be appended to the result of “url” and “params”.



40
41
42
43
44
45
46
47
48
49
50
 
# File 'lib/gsolr/connection/utils.rb', line 40

def build_url(url='', params={}, string_query='')
  queries = [string_query, hash_to_query(params)]

  queries.delete_if{|q_elem|
    q_elem.to_s.empty?
  }

  url += "?#{queries.join('&')}" unless queries.empty?

  return url
end

#bytesize(string) ⇒ Object 



26
27
28
 
# File 'lib/gsolr/connection/utils.rb', line 26

def bytesize(string)
  string.bytesize
end

#encode_utf8(string) ⇒ Object

encodes the string as utf-8 in Ruby 1.9 returns the unaltered string in Ruby 1.8



18
19
20
21
 
# File 'lib/gsolr/connection/utils.rb', line 18

def encode_utf8(string)
  (string.respond_to?(:force_encoding) and string.respond_to?(:encoding)) ?
    string.force_encoding(Encoding::UTF_8) : string
end

#escape(s) ⇒ Object

Performs URI escaping so that you can construct proper query strings faster. Use this rather than the cgi.rb version since it’s faster. (Stolen from Rack).



9
10
11
12
13
14
 
# File 'lib/gsolr/connection/utils.rb', line 9

def escape(s)
  s.to_s.gsub(/([^ a-zA-Z0-9_.-]+)/n) {
    #'%'+$1.unpack('H2'*$1.size).join('%').upcase
    '%'+$1.unpack('H2'*bytesize($1)).join('%').upcase
  }.tr(' ', '+')
end

#hash_to_query(params) ⇒ Object

converts hash into URL query string, keys get an alpha sort if a value is an array, the array values get mapped to the same key:

hash_to_query(:q=>'blah', :fq=>['blah', 'blah'], :facet=>{:field=>['location_facet', 'format_facet']})

returns:

?q=blah&fq=blah&fq=blah&facet.field=location_facet&facet.field=format.facet

if a value is empty/nil etc., it is not added



67
68
69
70
71
72
73
74
75
76
77
78
79
 
# File 'lib/gsolr/connection/utils.rb', line 67

def hash_to_query(params)
  mapped  = params.map do |key, val|
              next if val.to_s.empty?

              if val.class == Array
                hash_to_query(v.map { |elem| [key, elem] })
              else
                build_param key, val
              end
            end

  mapped.compact.join("&")
end