method

delegate_missing_to

v5.2.3 - Show latest stable - 0 notes - Class: Module

1.0.0
1.1.6
1.2.6
2.0.3
2.1.0
2.2.1
2.3.8
3.0.0
3.0.9
3.1.0
3.2.1
3.2.8
3.2.13
4.0.2
4.1.8
4.2.1
4.2.7
4.2.9
5.0.0.1
5.1.7 (0)
5.2.3 (-35)
6.0.0 (38)
6.1.3.1 (13)
6.1.7.7 (0)
7.0.0 (0)
7.1.3.2 (0)
What's this?

delegate_missing_to(target) public

When building decorators, a common pattern may emerge:

class Partition
  def initialize(event)
    @event = event
  end

  def person
    @event.detail.person || @event.creator
  end

  private
    def respond_to_missing?(name, include_private = false)
      @event.respond_to?(name, include_private)
    end

    def method_missing(method, *args, &block)
      @event.send(method, *args, &block)
    end
end

With Module#delegate_missing_to, the above is condensed to:

class Partition
  delegate_missing_to :@event

  def initialize(event)
    @event = event
  end

  def person
    @event.detail.person || @event.creator
  end
end

The target can be anything callable within the object, e.g. instance variables, methods, constants, etc.

The delegated method must be public on the target, otherwise it will raise NoMethodError.

Show source

# File activesupport/lib/active_support/core_ext/module/delegation.rb, line 258
  def delegate_missing_to(target)
    target = target.to_s
    target = "self.#{target}" if DELEGATION_RESERVED_METHOD_NAMES.include?(target)

    module_eval       def respond_to_missing?(name, include_private = false)        # It may look like an oversight, but we deliberately do not pass        # +include_private+, because they do not get delegated.        #{target}.respond_to?(name) || super      end      def method_missing(method, *args, &block)        if #{target}.respond_to?(method)          #{target}.public_send(method, *args, &block)        else          begin            super          rescue NoMethodError            if #{target}.nil?              raise DelegationError, "\#{method} delegated to #{target}, but #{target} is nil"            else              raise            end          end        end      end, __FILE__, __LINE__ + 1
  end

delegate_missing_to

Related methods

Flowdock - Team Inbox With Chat