Contents

require 'representable'
require 'representable/bindings/xml_bindings'
require 'nokogiri'

module Representable
  module XML
    def self.binding_for_definition(definition)
      return CollectionBinding.new(definition)      if definition.array?
      return HashBinding.new(definition)            if definition.hash? and not definition.options[:use_attributes] # FIXME: hate this.
      return AttributeHashBinding.new(definition)   if definition.hash? and definition.options[:use_attributes]
      return AttributeBinding.new(definition)       if definition.attribute
      PropertyBinding.new(definition)
    end
    
    def self.included(base)
      base.class_eval do
        include Representable
        extend ClassMethods
        self.representation_wrap = true # let representable compute it.
      end
    end
    
    
    module ClassMethods
      # Creates a new Ruby object from XML using mapping information declared in the class.
      #
      # Accepts a block yielding the currently iterated Definition. If the block returns false 
      # the property is skipped.
      #
      # Example:
      #   band.from_xml("<band><name>Nofx</name></band>")
      def from_xml(*args, &block)
        create_represented(*args, &block).from_xml(*args)
      end
      
      def from_node(*args, &block)
        create_represented(*args, &block).from_node(*args)
      end
    end
    
    
    def from_xml(doc, *args)
      node = Nokogiri::XML(doc).root
      from_node(node, *args)
    end
    
    def from_node(node, options={})
      update_properties_from(node, options, XML)
    end
    
    # Returns a Nokogiri::XML object representing this object.
    def to_node(options={})
      root_tag = options[:wrap] || representation_wrap
      
      create_representation_with(Nokogiri::XML::Node.new(root_tag.to_s, Nokogiri::XML::Document.new), options, XML)
    end
    
    def to_xml(*args)
      to_node(*args).to_s
    end
  end
end

Version data entries

5 entries across 5 versions & 1 rubygems

Version	Path
representable-1.2.6	lib/representable/xml.rb
representable-1.2.5	lib/representable/xml.rb
representable-1.2.4	lib/representable/xml.rb
representable-1.2.3	lib/representable/xml.rb
representable-1.2.2	lib/representable/xml.rb