Module: ActiveSupport::CoreExtensions::Hash::Conversions

Included in:
Hash
Defined in:
lib/active_support/core_ext/hash/conversions.rb

Defined Under Namespace

Modules: ClassMethods, FileLike

Constant Summary collapse

XML_TYPE_NAMES =
{
  "Symbol"     => "symbol",
  "Fixnum"     => "integer",
  "Bignum"     => "integer",
  "BigDecimal" => "decimal",
  "Float"      => "float",
  "TrueClass"  => "boolean",
  "FalseClass" => "boolean",
  "Date"       => "date",
  "DateTime"   => "datetime",
  "Time"       => "datetime",
  "ActiveSupport::TimeWithZone" => "datetime"
}
XML_FORMATTING =
{
  "symbol"   => Proc.new { |symbol| symbol.to_s },
  "date"     => Proc.new { |date| date.to_s(:db) },
  "datetime" => Proc.new { |time| time.xmlschema },
  "binary"   => Proc.new { |binary| ActiveSupport::Base64.encode64(binary) },
  "yaml"     => Proc.new { |yaml| yaml.to_yaml }
}
XML_PARSING =
{
  "symbol"       => Proc.new  { |symbol|  symbol.to_sym },
  "date"         => Proc.new  { |date|    ::Date.parse(date) },
  "datetime"     => Proc.new  { |time|    ::Time.parse(time).utc rescue ::DateTime.parse(time).utc },
  "integer"      => Proc.new  { |integer| integer.to_i },
  "float"        => Proc.new  { |float|   float.to_f },
  "decimal"      => Proc.new  { |number|  BigDecimal(number) },
  "boolean"      => Proc.new  { |boolean| %w(1 true).include?(boolean.strip) },
  "string"       => Proc.new  { |string|  string.to_s },
  "yaml"         => Proc.new  { |yaml|    YAML::load(yaml) rescue yaml },
  "base64Binary" => Proc.new  { |bin|     ActiveSupport::Base64.decode64(bin) },
  "file"         => Proc.new do |file, entity|
    f = StringIO.new(ActiveSupport::Base64.decode64(file))
    f.extend(FileLike)
    f.original_filename = entity['name']
    f.content_type = entity['content_type']
    f
  end
}

Class Method Summary collapse

Instance Method Summary collapse

Class Method Details

.included(klass) ⇒ Object



72
73
74
# File 'lib/active_support/core_ext/hash/conversions.rb', line 72

def self.included(klass)
  klass.extend(ClassMethods)
end

Instance Method Details

#rename_key(key, options = {}) ⇒ Object



145
146
147
148
149
150
# File 'lib/active_support/core_ext/hash/conversions.rb', line 145

def rename_key(key, options = {})
  camelize = options.has_key?(:camelize) && options[:camelize]
  dasherize = !options.has_key?(:dasherize) || options[:dasherize]
  key = key.camelize if camelize
  dasherize ? key.dasherize : key
end

#to_query(namespace = nil) ⇒ Object Also known as: to_param

Converts a hash into a string suitable for use as a URL query string. An optional namespace can be passed to enclose the param names (see example below).

Examples

{ :name => 'David', :nationality => 'Danish' }.to_query # => "name=David&nationality=Danish"

{ :name => 'David', :nationality => 'Danish' }.to_query('user') # => "user%5Bname%5D=David&user%5Bnationality%5D=Danish"


83
84
85
86
87
# File 'lib/active_support/core_ext/hash/conversions.rb', line 83

def to_query(namespace = nil)
  collect do |key, value|
    value.to_query(namespace ? "#{namespace}[#{key}]" : key)
  end.sort * '&'
end

#to_xml(options = {}) ⇒ Object



91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
# File 'lib/active_support/core_ext/hash/conversions.rb', line 91

def to_xml(options = {})
  require 'builder' unless defined?(Builder)

  options[:indent] ||= 2
  options.reverse_merge!({ :builder => Builder::XmlMarkup.new(:indent => options[:indent]),
                           :root => "hash" })
  options[:builder].instruct! unless options.delete(:skip_instruct)
  root = rename_key(options[:root].to_s, options)

  options[:builder].__send__(:method_missing, root) do
    each do |key, value|
      case value
        when ::Hash
          value.to_xml(options.merge({ :root => key, :skip_instruct => true }))
        when ::Array
          value.to_xml(options.merge({ :root => key, :children => key.to_s.singularize, :skip_instruct => true}))
        when ::Method, ::Proc
          # If the Method or Proc takes two arguments, then
          # pass the suggested child element name.  This is
          # used if the Method or Proc will be operating over
          # multiple records and needs to create an containing
          # element that will contain the objects being
          # serialized.
          if 1 == value.arity
            value.call(options.merge({ :root => key, :skip_instruct => true }))
          else
            value.call(options.merge({ :root => key, :skip_instruct => true }), key.to_s.singularize)
          end
        else
          if value.respond_to?(:to_xml)
            value.to_xml(options.merge({ :root => key, :skip_instruct => true }))
          else
            type_name = XML_TYPE_NAMES[value.class.name]

            key = rename_key(key.to_s, options)

            attributes = options[:skip_types] || value.nil? || type_name.nil? ? { } : { :type => type_name }
            if value.nil?
              attributes[:nil] = true
            end

            options[:builder].tag!(key,
              XML_FORMATTING[type_name] ? XML_FORMATTING[type_name].call(value) : value,
              attributes
            )
          end
      end
    end
    
    yield options[:builder] if block_given?
  end

end