Sha256: 8ed9c9702a3d7dddd2e16dcc8ca95aeed7f2419822fdb4c504506ac451c30317

Contents?: true

Size: 1.37 KB

Versions: 73

Compression:

Stored size: 1.37 KB

Contents

# encoding: utf-8
module Mongoid
  module Persistable

    # Defines behaviour for persistence operations that save documents.
    #
    # @since 4.0.0
    module Savable

      # Save the document - will perform an insert if the document is new, and
      # update if not.
      #
      # @example Save the document.
      #   document.save
      #
      # @param [ Hash ] options Options to pass to the save.
      #
      # @return [ true, false ] True is success, false if not.
      #
      # @since 1.0.0
      def save(options = {})
        if new_record?
          !insert(options).new_record?
        else
          update_document(options)
        end
      end

      # Save the document - will perform an insert if the document is new, and
      # update if not. If a validation error occurs an error will get raised.
      #
      # @example Save the document.
      #   document.save!
      #
      # @param [ Hash ] options Options to pass to the save.
      #
      # @raise [ Errors::Validations ] If validation failed.
      # @raise [ Errors::Callback ] If a callback returns false.
      #
      # @return [ true, false ] True if validation passed.
      #
      # @since 1.0.0
      def save!(options = {})
        unless save(options)
          fail_due_to_validation! unless errors.empty?
          fail_due_to_callback!(:save!)
        end
        true
      end
    end
  end
end

Version data entries

73 entries across 68 versions & 6 rubygems

Version Path
mongoid-7.0.13 lib/mongoid/persistable/savable.rb
mongoid-7.0.12 lib/mongoid/persistable/savable.rb
mongoid-6.4.8 lib/mongoid/persistable/savable.rb
mongoid-7.0.11 lib/mongoid/persistable/savable.rb
mongoid-7.0.10 lib/mongoid/persistable/savable.rb
mongoid-6.4.7 lib/mongoid/persistable/savable.rb
mongoid-6.4.5 lib/mongoid/persistable/savable.rb
mongoid-7.0.8 lib/mongoid/persistable/savable.rb
mongoid-7.0.7 lib/mongoid/persistable/savable.rb
mongoid-7.0.6 lib/mongoid/persistable/savable.rb
mongoid-5.4.1 lib/mongoid/persistable/savable.rb
mongoid-7.0.5 lib/mongoid/persistable/savable.rb
mongoid-7.0.4 lib/mongoid/persistable/savable.rb
mongoid-6.4.4 lib/mongoid/persistable/savable.rb
mongoid-7.0.3 lib/mongoid/persistable/savable.rb
mongoid-6.4.2 lib/mongoid/persistable/savable.rb
mongoid-7.0.2 lib/mongoid/persistable/savable.rb
mongoid-7.0.1 lib/mongoid/persistable/savable.rb
mongoid-6.4.1 lib/mongoid/persistable/savable.rb
mongoid-5.4.0 lib/mongoid/persistable/savable.rb