Codebrahma

Work

Observers in Rails: Ruby on Rails Development

Life without Observers

Let's say you need to listen to changes in a model's attributes and trigger some events based on those changes. If you look at the following example, I've done exaclty that. If the status of application is changed an email is sent.

class Application < ActiveRecord::Base
  
  after_save :email_confirmation

  def open?
    status == 'Open'
  end

  def closed?
    status == 'Closed'
  end

  def pending?
    status == 'Pending'
  end

  def email_confirmation
    if status_changed?
      ApplicationMailer.closed_notification(self)  if closed?
      ApplicationMailer.open_notification(self)  if open?
      ApplicationMailer.pending_notification(self)  if pending?
    end
  end

end

The above piece of code violates the Single Responsibility Principle, which states that each class should have "only one responsiblilty". The Application model should only deal with saving and manupluating the application object. Sending emails is not part of it's responsiblity.


ActiveRecord::Observers

We can delegate the responsiblity of observing changes in model attibutes and responding to those changes, to a seperate Observer class. Model specific event handling is much cleaner this way. This way, we can refrain from polluting the model by adding not un-necessary methods.

class ApplicationObserver < ActiveRecord::Observer

  def after_save(appl)
    if status_changed?
      ApplicationMailer.closed_notification(appl)  if appl.closed?
      ApplicationMailer.open_notification(appl)  if appl.open?
      ApplicationMailer.pending_notification(appl)  if appl.pending?
    end
  end

end

You can read more about the observer design pattern here.


_ _

Note

  1. Observer names are infered form the model names. So if you name your observer as ApplicationObserver, rails knows that it's observing the Applicationmodel.
  2. Your observers need not be model specific. SRP states that "Responsibility should be entirely encapsulated by the context". So by this definition you can have a single observer which listens to changes in multiple models and perfom a single function say, sending an email or publishing a notification. To acomplish this you can use theActiveRecord::Observer.observe method.
  3. Place your observers in app/models or app/models/observers.
  4. Finally, Observers have been removed form the rails core after Rails 3.2. You need to include the rails-observers gem to use observers in later rails versions.

References: http://api.rubyonrails.org/v3.2.13/classes/ActiveRecord/Observer.html,

Written by
Nithin Krishna
Published at
Jul 30, 2014
Posted in
Tutorial
Tags
If you want to get more posts like this, join our newsletter

Join our NEW newsletter to learn about the latest trends in the fast changing front end atmosphere

Mail hello@codebrahma.com

Phone +1 484 506 0634

Codebrahma is an independent company. Mentioned brands and companies are trademarked brands.
© 2024 codebrahma.com. All rights reserved.