# encoding: utf-8 module CouchRest module Model module Properties extend ActiveSupport::Concern included do class_attribute(:properties) unless self.respond_to?(:properties) class_attribute(:properties_by_name) unless self.respond_to?(:properties_by_name) self.properties ||= [] self.properties_by_name ||= {} raise "You can only mixin Properties in a class responding to [] and []=, if you tried to mixin CastedModel, make sure your class inherits from Hash or responds to the proper methods" unless (method_defined?(:[]) && method_defined?(:[]=)) end # Provide an attribute hash ready to be sent to CouchDB but with # all the nil attributes removed. def as_couch_json super.delete_if{|k,v| v.nil?} end # Returns the Class properties with their values # # ==== Returns # Array:: the list of properties with their values def properties_with_values props = {} properties.each { |property| props[property.name] = read_attribute(property.name) } props end # Read the casted value of an attribute defined with a property. # # ==== Returns # Object:: the casted attibutes value. def read_attribute(property) self[find_property!(property).to_s] end # Store a casted value in the current instance of an attribute defined # with a property and update dirty status def write_attribute(property, value) prop = find_property!(property) value = prop.is_a?(String) ? value : prop.cast(self, value) couchrest_attribute_will_change!(prop.name) if use_dirty? && self[prop.name] != value self[prop.name] = value end # Takes a hash as argument, and applies the values by using writer methods # for each key. It doesn't save the document at the end. Raises a NoMethodError if the corresponding methods are # missing. In case of error, no attributes are changed. def update_attributes_without_saving(hash) # Remove any protected and update all the rest. Any attributes # which do not have a property will simply be ignored. attrs = remove_protected_attributes(hash) directly_set_attributes(attrs) end alias :attributes= :update_attributes_without_saving # 'attributes' needed for Dirty alias :attributes :properties_with_values def set_attributes(hash) attrs = remove_protected_attributes(hash) directly_set_attributes(attrs) end protected def find_property(property) property.is_a?(Property) ? property : self.class.properties_by_name[property.to_s] end # The following methods should be accessable by the Model::Base Class, but not by anything else! def apply_all_property_defaults return if self.respond_to?(:new?) && (new? == false) # TODO: cache the default object # Never mark default options as dirty! dirty, self.disable_dirty = self.disable_dirty, true self.class.properties.each do |property| write_attribute(property, property.default_value) end self.disable_dirty = dirty end def prepare_all_attributes(attrs = {}, options = {}) self.disable_dirty = !!options[:directly_set_attributes] apply_all_property_defaults if options[:directly_set_attributes] directly_set_read_only_attributes(attrs) directly_set_attributes(attrs, true) else attrs = remove_protected_attributes(attrs) directly_set_attributes(attrs) end self.disable_dirty = false self end def find_property!(property) prop = find_property(property) raise ArgumentError, "Missing property definition for #{property.to_s}" if prop.nil? prop end # Set all the attributes and return a hash with the attributes # that have not been accepted. def directly_set_attributes(hash, mass_assign = false) return if hash.nil? hash.reject do |key, value| if self.respond_to?("#{key}=") self.send("#{key}=", value) elsif mass_assign || mass_assign_any_attribute self[key] = value end end end def directly_set_read_only_attributes(hash) property_list = self.properties.map{|p| p.name} hash.each do |attribute_name, attribute_value| next if self.respond_to?("#{attribute_name}=") if property_list.include?(attribute_name) write_attribute(attribute_name, hash.delete(attribute_name)) end end end module ClassMethods def property(name, *options, &block) raise "Invalid property definition, '#{name}' already used for CouchRest Model type field" if name.to_s == model_type_key.to_s && CouchRest::Model::Base >= self opts = { } type = options.shift if type.class != Hash opts[:type] = type opts.merge!(options.shift || {}) else opts.update(type) end existing_property = self.properties.find{|p| p.name == name.to_s} if existing_property.nil? || (existing_property.default != opts[:default]) define_property(name, opts, &block) end end # Automatically set updated_at and created_at fields # on the document whenever saving occurs. # # These properties are casted as Time objects, so they should always # be set to UTC. def timestamps! property(:updated_at, Time, :read_only => true, :protected => true, :auto_validation => false) property(:created_at, Time, :read_only => true, :protected => true, :auto_validation => false) set_callback :save, :before do |object| write_attribute('updated_at', Time.now) write_attribute('created_at', Time.now) if object.new? end end protected # This is not a thread safe operation, if you have to set new properties at runtime # make sure a mutex is used. def define_property(name, options={}, &block) # check if this property is going to casted type = options.delete(:type) || options.delete(:cast_as) if block_given? type = Class.new do include Embeddable end if block.arity == 1 # Traditional, with options type.class_eval { yield type } else type.instance_exec(&block) end type = [type] # inject as an array end property = Property.new(name, type, options) create_property_getter(property) create_property_setter(property) unless property.read_only == true if property.type_class.respond_to?(:validates_casted_model) validates_casted_model property.name end properties << property properties_by_name[property.to_s] = property property end # defines the getter for the property (and optional aliases) def create_property_getter(property) define_method(property.name) do read_attribute(property.name) end if ['boolean', TrueClass.to_s.downcase].include?(property.type.to_s.downcase) define_method("#{property.name}?") do value = read_attribute(property.name) !(value.nil? || value == false) end end if property.alias alias_method(property.alias, property.name.to_sym) end end # defines the setter for the property (and optional aliases) def create_property_setter(property) name = property.name define_method("#{name}=") do |value| write_attribute(name, value) end if property.alias alias_method "#{property.alias}=", "#{name}=" end end end # module ClassMethods end end end