method

alias_method_chain

Importance_3
Ruby on Rails latest stable (v2.3.4) - 2 notes - Class: Module
  • v1.0.0
  • v1.1.0
  • v1.1.1
  • v1.1.2
  • v1.1.3
  • v1.1.4
  • v1.1.5
  • v1.1.6
  • v1.2.0
  • v1.2.1
  • v1.2.2
  • v1.2.3
  • v1.2.4
  • v1.2.5
  • v1.2.6
  • v2.0.0
  • v2.0.1
  • v2.0.2
  • v2.0.3
  • 2.1.0 (0)
  • v2.2.1
  • v2.3.2
  • v2.3.4
  • What's this?

Method deprecated

This method is deprecated on the latest stable version of Rails. The last existing version (v2.1.0) is shown here.

alias_method_chain(target, feature) public

Encapsulates the common pattern of:

  alias_method :foo_without_feature, :foo
  alias_method :foo, :foo_with_feature

With this, you simply do:

  alias_method_chain :foo, :feature

And both aliases are set up for you.

Query and bang methods (foo?, foo!) keep the same punctuation:

  alias_method_chain :foo?, :feature

is equivalent to

  alias_method :foo_without_feature?, :foo?
  alias_method :foo?, :foo_with_feature?

so you can safely chain foo, foo?, and foo! with the same feature.

Show source
Register or log in to add new notes.
August 29, 2008
8 thanks

Always pass a block

I highly recommend always taking a block and passing it back up the chain if you use alias_method_chain, even if the original method does not. Otherwise you’re keeping anyone later in the chain from adding support for blocks.

http://tech.hickorywind.org/articles/2008/08/29/always-pass-a-block-when-using-alias_method_chain

April 1, 2009 - (>= v2.1.0)
1 thank