module ActiveObject #:nodoc: module Serialization class Serializer #:nodoc: attr_reader :options def initialize(object, options = {}) @object, @options = object, options.dup end # To replicate the behavior in ActiveObject#attributes, # :except takes precedence over :only. If :only is not set # for a N level model but is set for the N+1 level models, # then because :except is set to a default value, the second # level model can have both :except and :only set. So if # :only is set, always delete :except. def serializable_attribute_names attribute_names = @object.attributes if options[:only] options.delete(:except) attribute_names = attribute_names & Array(options[:only]).collect { |n| n.to_s } else options[:except] = Array(options[:except]) attribute_names = attribute_names - options[:except].collect { |n| n.to_s } end attribute_names end def serializable_method_names Array(options[:methods]).inject([]) do |method_attributes, name| method_attributes << name if @object.respond_to?(name.to_s) method_attributes end end def serializable_names serializable_attribute_names + serializable_method_names end # Add associations specified via the :includes option. # Expects a block that takes as arguments: # +association+ - name of the association # +objects+ - the association object(s) to be serialized # +opts+ - options for the association objects def add_includes(&block) if include_associations = options.delete(:include) base_only_or_except = { :except => options[:except], :only => options[:only] } include_has_options = include_associations.is_a?(Hash) associations = include_has_options ? include_associations.keys : Array(include_associations) for association in associations objects = @object.send association objects = objects.objects if objects.is_a?(ActiveObject::Associations::HasManyAssociation::Collection) unless objects.nil? association_options = include_has_options ? include_associations[association] : base_only_or_except opts = options.merge(association_options) yield(association, objects, opts) end end options[:include] = include_associations end end def serializable_object returning(serializable_object = {}) do serializable_names.each { |name| serializable_object[name] = @object.send(name) } add_includes do |association, objects, opts| if objects.is_a?(Enumerable) serializable_object[association] = objects.collect { |r| self.class.new(r, opts).serializable_object } serializable_object.delete("#{association}_ids") else serializable_object[association] = self.class.new(objects, opts).serializable_object serializable_object.delete("#{association}_id") end end end end def serialize # overwrite to implement end def to_s(&block) serialize(&block) end end end end require 'active_object/serializers/xml_serializer' require 'active_object/serializers/json_serializer'