Sha256: 4e8d79dfffc7691b584db5d8c25a9594ece889cb1ba8c19098f5f0888d0eedb8

Contents?: true

Size: 1.62 KB

Versions: 13

Compression:

Stored size: 1.62 KB

Contents

# encoding: utf-8
require "mongoid/relations/cascading/delete"
require "mongoid/relations/cascading/destroy"
require "mongoid/relations/cascading/nullify"
require "mongoid/relations/cascading/restrict"

module Mongoid
  module Relations

    # This module defines the behaviour for setting up cascading deletes and
    # nullifies for relations, and how to delegate to the approriate strategy.
    module Cascading
      extend ActiveSupport::Concern

      included do
        class_attribute :cascades
        self.cascades = []
      end

      # Perform all cascading deletes, destroys, or nullifies. Will delegate to
      # the appropriate strategy to perform the operation.
      #
      # @example Execute cascades.
      #   document.cascade!
      #
      # @since 2.0.0.rc.1
      def cascade!
        cascades.each do |name|
          if !metadata || !metadata.versioned?
            if meta = relations[name]
              strategy = meta.cascade_strategy
              strategy.new(self, meta).cascade
            end
          end
        end
      end

      module ClassMethods

        # Attempt to add the cascading information for the document to know how
        # to handle associated documents on a removal.
        #
        # @example Set up cascading information
        #   Movie.cascade(metadata)
        #
        # @param [ Metadata ] metadata The metadata for the relation.
        #
        # @return [ Class ] The class of the document.
        #
        # @since 2.0.0.rc.1
        def cascade(metadata)
          cascades.push(metadata.name.to_s) if metadata.dependent?
          self
        end
      end
    end
  end
end

Version data entries

13 entries across 13 versions & 1 rubygems

Version Path
mongoid-3.0.14 lib/mongoid/relations/cascading.rb
mongoid-3.0.13 lib/mongoid/relations/cascading.rb
mongoid-3.0.12 lib/mongoid/relations/cascading.rb
mongoid-3.0.11 lib/mongoid/relations/cascading.rb
mongoid-3.0.10 lib/mongoid/relations/cascading.rb
mongoid-3.0.9 lib/mongoid/relations/cascading.rb
mongoid-3.0.6 lib/mongoid/relations/cascading.rb
mongoid-3.0.5 lib/mongoid/relations/cascading.rb
mongoid-3.0.4 lib/mongoid/relations/cascading.rb
mongoid-3.0.3 lib/mongoid/relations/cascading.rb
mongoid-3.0.2 lib/mongoid/relations/cascading.rb
mongoid-3.0.1 lib/mongoid/relations/cascading.rb
mongoid-3.0.0 lib/mongoid/relations/cascading.rb