diff options
author | Genadi Samokovarov <gsamokovarov@gmail.com> | 2017-05-29 15:44:15 +0300 |
---|---|---|
committer | Genadi Samokovarov <gsamokovarov@gmail.com> | 2017-06-11 14:00:51 +0300 |
commit | 43512df990ff1bba30b4b3cfa427b314a0314623 (patch) | |
tree | 58910631e02ec2c165bd9287bb2b5386e118f29b /guides/source | |
parent | 7a3db2ea15970e4c9c31a2b23303928aeadb391d (diff) | |
download | rails-43512df990ff1bba30b4b3cfa427b314a0314623.tar.gz rails-43512df990ff1bba30b4b3cfa427b314a0314623.tar.bz2 rails-43512df990ff1bba30b4b3cfa427b314a0314623.zip |
Document Module#delegate_missing_to in the guides
Added a small section for it in the `Active Support Core Extensions`
guide. [ci skip]
Diffstat (limited to 'guides/source')
-rw-r--r-- | guides/source/active_support_core_extensions.md | 21 |
1 files changed, 21 insertions, 0 deletions
diff --git a/guides/source/active_support_core_extensions.md b/guides/source/active_support_core_extensions.md index 67bed4c8da..eb46732127 100644 --- a/guides/source/active_support_core_extensions.md +++ b/guides/source/active_support_core_extensions.md @@ -755,6 +755,8 @@ NOTE: Defined in `active_support/core_ext/module/anonymous.rb`. ### Method Delegation +#### `delegate` + The macro `delegate` offers an easy way to forward methods. Let's imagine that users in some application have login information in the `User` model but name and other data in a separate `Profile` model: @@ -837,6 +839,25 @@ In the previous example the macro generates `avatar_size` rather than `size`. NOTE: Defined in `active_support/core_ext/module/delegation.rb` +#### `delegate_missing_to` + +Imagine you would like to delegate everything missing from the `User` object, +to the `Profile` one. The `delegate_missing_to` macro lets you implement this +in a breeze: + +```ruby +class User < ApplicationRecord + has_one :profile + + delegate_missing_to :profile +end +``` + +The target can be anything callable within the object, e.g. instance variables, +methods, constants, etc. Only the public methods of the target are delegated. + +NOTE: Defined in `active_support/core_ext/module/delegation.rb` + ### Redefining Methods There are cases where you need to define a method with `define_method`, but don't know whether a method with that name already exists. If it does, a warning is issued if they are enabled. No big deal, but not clean either. |