Given a hash of serialization rules, an XMLSerializer can convert a hash of request options into XML. The request options are validated before returning XML.
@return [String]
@return [String] Returns the name of the API operation.
@return [Hash]
@return [Validator]
@param [String] namespace @param [String] #operation_name @param [Hash] rules A hash of option rules to validate against.
# File lib/aws/core/options/xml_serializer.rb, line 28 def initialize namespace, operation_name, rules @namespace = namespace @operation_name = operation_name @rules = rules @validator = Validator.new(rules) end
@overload serialize!(request_options)
@param [Hash] request_options A hash of already validated request options with normalized values. @return [String] Returns an string of the request parameters serialized into XML.
# File lib/aws/core/options/xml_serializer.rb, line 52 def serialize request_options xml = Nokogiri::XML::Builder.new xml.send("#{operation_name}Request", :xmlns => namespace) do |xml| hash_members_xml(request_options, rules, xml) end xml.doc.root.to_xml end
# File lib/aws/core/options/xml_serializer.rb, line 86 def hash_members_xml hash, rules, builder xml_ordered_members(rules).each do |member_name| if hash.key?(member_name) value = hash[member_name] to_xml(builder, member_name, rules[member_name], value) end end end
# File lib/aws/core/options/xml_serializer.rb, line 62 def to_xml builder, opt_name, rules, value xml_name = rules[:name] xml_name ||= opt_name.is_a?(String) ? opt_name : Inflection.class_name(opt_name.to_s) case value when Hash builder.send(xml_name) do |builder| hash_members_xml(value, rules[:members], builder) end when Array builder.send(xml_name) do value.each do |member_value| to_xml(builder, 'member', rules[:members], member_value) end end else builder.send(xml_name, value) end end
# File lib/aws/core/options/xml_serializer.rb, line 95 def xml_ordered_members members members.inject([]) do |list,(member_name, member)| list << [member[:position] || 0, member_name] end.sort_by(&:first).map(&:last) end