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 



80
81
82
 
# File 'lib/active_support/core_ext/hash/conversions.rb', line 80

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

Instance Method Details

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



154
155
156
157
158
159
160
 
# File 'lib/active_support/core_ext/hash/conversions.rb', line 154

def rename_key(key, options = {})
  camelize  = options.has_key?(:camelize) ? options[:camelize]   : ActiveSupport.camelize_xml
  dasherize = options.has_key?(:dasherize) ? options[:dasherize] : ActiveSupport.dasherize_xml
  key = key.camelize if camelize
  key = key.dasherize if 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"



91
92
93
94
95
 
# File 'lib/active_support/core_ext/hash/conversions.rb', line 91

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

#to_xml(options = {}) ⇒ Object 



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
144
145
146
147
148
149
150
151
152
 
# File 'lib/active_support/core_ext/hash/conversions.rb', line 99

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

  options = options.dup
  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