module ActiveSupport::DescendantsTracker - activesupport-4.2.3 Documentation

# module ActiveSupport::DescendantsTracker

This module provides an internal implementation to track descendants which is faster than iterating through ObjectSpace.

### Public Class Methods

clear() click to toggle source

    # File lib/active_support/descendants_tracker.rb, line 18
    def clear
      if defined? ActiveSupport::Dependencies
        @@direct_descendants.each do |klass, descendants|
          if ActiveSupport::Dependencies.autoloaded?(klass)
            @@direct_descendants.delete(klass)
          else
            descendants.reject! { |v| ActiveSupport::Dependencies.autoloaded?(v) }
          end
        end
      else
        @@direct_descendants.clear
      end
    end

descendants(klass) click to toggle source

    # File lib/active_support/descendants_tracker.rb, line 12
    def descendants(klass)
      arr = []
      accumulate_descendants(klass, arr)
      arr
    end

direct_descendants(klass) click to toggle source

    # File lib/active_support/descendants_tracker.rb, line 8
    def direct_descendants(klass)
      @@direct_descendants[klass] || []
    end

store_inherited(klass, descendant) click to toggle source

This is the only method that is not thread safe, but is only ever called during the eager loading phase.

    # File lib/active_support/descendants_tracker.rb, line 34
    def store_inherited(klass, descendant)
      (@@direct_descendants[klass] ||= []) << descendant
    end

### Private Class Methods

accumulate_descendants(klass, acc) click to toggle source

    # File lib/active_support/descendants_tracker.rb, line 39
    def accumulate_descendants(klass, acc)
      if direct_descendants = @@direct_descendants[klass]
        acc.concat(direct_descendants)
        direct_descendants.each { |direct_descendant| accumulate_descendants(direct_descendant, acc) }
      end
    end

### Public Instance Methods

descendants() click to toggle source

    # File lib/active_support/descendants_tracker.rb, line 56
    def descendants
      DescendantsTracker.descendants(self)
    end

direct_descendants() click to toggle source

    # File lib/active_support/descendants_tracker.rb, line 52
    def direct_descendants
      DescendantsTracker.direct_descendants(self)
    end

inherited(base) click to toggle source
Calls superclass method

    # File lib/active_support/descendants_tracker.rb, line 47
    def inherited(base)
      DescendantsTracker.store_inherited(self, base)
      super
    end