Contents

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

module Representable
  module XML
    BINDING_FOR_TYPE = {
      :attr     => AttributeBinding,
      :text     => TextBinding,
    }
    
    def self.included(base)
      base.class_eval do
        include Representable
        extend ClassMethods
      end
    end
    
    
    class Definition < Representable::Definition
      # FIXME: extract xml-specific from Definition.
    end
    
    
    module ClassMethods
      def definition_class
        Definition
      end
      
      def binding_for_definition(definition)
        (BINDING_FOR_TYPE[definition.sought_type] or ObjectBinding).new(definition)
      end
      
      # 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(doc, *args, &block)
        create_from_xml(*args).tap do |object|
          object.from_xml(doc, *args, &block)
        end
      end
      
    private
      def create_from_xml(*args)
        new(*args)
      end
    end
    
    def from_xml(doc, *args, &block)
      xml = Nokogiri::XML::Node.from(doc)
      update_properties_from(xml, &block)
    end
    
    
    # Returns a Nokogiri::XML object representing this object.
    def to_xml(params={})
      root_tag = params[:name] || self.class.representation_name
      
      create_representation_with(Nokogiri::XML::Node.new(root_tag.to_s, Nokogiri::XML::Document.new))
    end
  end
end

Version data entries

1 entries across 1 versions & 1 rubygems

Version	Path
representable-0.9.2	lib/representable/xml.rb