Sha256: 7faa1049be5f27443be34435f3e1b8f31424c5b4b446d2bd37bf80e67d9a5d72

Contents?: true

Size: 1.43 KB

Versions: 54

Compression:

Stored size: 1.43 KB

Contents

module ActiveModel
  # == Active Model Conversions
  #
  # Handles default conversions: to_model, to_key and to_param.
  #
  # Let's take for example this non persisted object.
  #
  #   class ContactMessage
  #     include ActiveModel::Conversion
  #
  #     # ContactMessage are never persisted in the DB
  #     def persisted?
  #       false
  #     end
  #   end
  #
  #   cm = ContactMessage.new
  #   cm.to_model == self # => true
  #   cm.to_key           # => nil
  #   cm.to_param         # => nil
  #
  module Conversion
    # If your object is already designed to implement all of the Active Model
    # you can use the default <tt>:to_model</tt> implementation, which simply
    # returns self.
    #
    # If your model does not act like an Active Model object, then you should
    # define <tt>:to_model</tt> yourself returning a proxy object that wraps
    # your object with Active Model compliant methods.
    def to_model
      self
    end

    # Returns an Enumerable of all key attributes if any is set, regardless
    # if the object is persisted or not.
    #
    # Note the default implementation uses persisted? just because all objects
    # in Ruby 1.8.x responds to <tt>:id</tt>.
    def to_key
      persisted? ? [id] : nil
    end

    # Returns a string representing the object's key suitable for use in URLs,
    # or nil if <tt>persisted?</tt> is false.
    def to_param
      persisted? ? to_key.join('-') : nil
    end
  end
end

Version data entries

54 entries across 54 versions & 2 rubygems

Version Path
activemodel-3.1.12 lib/active_model/conversion.rb
activemodel-3.1.11 lib/active_model/conversion.rb
activemodel-3.1.10 lib/active_model/conversion.rb
activemodel-3.1.9 lib/active_model/conversion.rb
dirty_history-0.7.3 dirty_history/ruby/1.9.1/gems/activemodel-3.1.1/lib/active_model/conversion.rb
dirty_history-0.7.2 dirty_history/ruby/1.9.1/gems/activemodel-3.1.1/lib/active_model/conversion.rb
dirty_history-0.7.1 dirty_history/ruby/1.9.1/gems/activemodel-3.1.1/lib/active_model/conversion.rb
dirty_history-0.7.0 dirty_history/ruby/1.9.1/gems/activemodel-3.1.1/lib/active_model/conversion.rb
dirty_history-0.6.7 dirty_history/ruby/1.9.1/gems/activemodel-3.1.1/lib/active_model/conversion.rb
dirty_history-0.6.6 dirty_history/ruby/1.9.1/gems/activemodel-3.1.1/lib/active_model/conversion.rb
dirty_history-0.6.5 dirty_history/ruby/1.9.1/gems/activemodel-3.1.1/lib/active_model/conversion.rb
dirty_history-0.6.4 dirty_history/ruby/1.9.1/gems/activemodel-3.1.1/lib/active_model/conversion.rb
activemodel-3.1.8 lib/active_model/conversion.rb
dirty_history-0.6.3 dirty_history/ruby/1.9.1/gems/activemodel-3.1.1/lib/active_model/conversion.rb
activemodel-3.1.7 lib/active_model/conversion.rb
dirty_history-0.6.2 dirty_history/ruby/1.9.1/gems/activemodel-3.1.1/lib/active_model/conversion.rb
dirty_history-0.6.1 dirty_history/ruby/1.9.1/gems/activemodel-3.1.1/lib/active_model/conversion.rb
dirty_history-0.6.0 dirty_history/ruby/1.9.1/gems/activemodel-3.1.1/lib/active_model/conversion.rb
activemodel-3.1.6 lib/active_model/conversion.rb
dirty_history-0.5.4 dirty_history/ruby/1.9.1/gems/activemodel-3.1.1/lib/active_model/conversion.rb