class ActionMailer::MessageDelivery

Parent:: Delegator

The ActionMailer::MessageDelivery class is used by ActionMailer::Base when creating a new mailer. MessageDelivery is a wrapper (Delegator subclass) around a lazy created Mail::Message. You can get direct access to the Mail::Message, deliver the email or schedule the email to be sent through Active Job.

Notifier.welcome(User.first)               # an ActionMailer::MessageDelivery object
Notifier.welcome(User.first).deliver_now   # sends the email
Notifier.welcome(User.first).deliver_later # enqueue email delivery as a job through Active Job
Notifier.welcome(User.first).message       # a Mail::Message object

Public Instance Methods

deliver_later(options={}) Show source

# File actionmailer/lib/action_mailer/message_delivery.rb, line 75
def deliver_later(options={})
  enqueue_delivery :deliver_now, options
end

Enqueues the email to be delivered through Active Job. When the job runs it will send the email using deliver_now.

Notifier.welcome(User.first).deliver_later
Notifier.welcome(User.first).deliver_later(wait: 1.hour)
Notifier.welcome(User.first).deliver_later(wait_until: 10.hours.from_now)

Options:

:wait - Enqueue the email to be delivered with a delay.
:wait_until - Enqueue the email to be delivered at (after) a specific date / time.
:queue - Enqueue the email on the specified queue.

deliver_later!(options={}) Show source

# File actionmailer/lib/action_mailer/message_delivery.rb, line 59
def deliver_later!(options={})
  enqueue_delivery :deliver_now!, options
end

Enqueues the email to be delivered through Active Job. When the job runs it will send the email using deliver_now!. That means that the message will be sent bypassing checking perform_deliveries and raise_delivery_errors, so use with caution.

Notifier.welcome(User.first).deliver_later!
Notifier.welcome(User.first).deliver_later!(wait: 1.hour)
Notifier.welcome(User.first).deliver_later!(wait_until: 10.hours.from_now)

Options:

:wait - Enqueue the email to be delivered with a delay
:wait_until - Enqueue the email to be delivered at (after) a specific date / time
:queue - Enqueue the email on the specified queue

deliver_now() Show source

# File actionmailer/lib/action_mailer/message_delivery.rb, line 94
def deliver_now
  processed_mailer.handle_exceptions do
    message.deliver
  end
end

Delivers an email:

Notifier.welcome(User.first).deliver_now

deliver_now!() Show source

# File actionmailer/lib/action_mailer/message_delivery.rb, line 84
def deliver_now!
  processed_mailer.handle_exceptions do
    message.deliver!
  end
end

Delivers an email without checking perform_deliveries and raise_delivery_errors, so use with caution.

Notifier.welcome(User.first).deliver_now!

message() Show source

# File actionmailer/lib/action_mailer/message_delivery.rb, line 36
def message
  __getobj__
end

Returns the resulting Mail::Message

processed?() Show source

# File actionmailer/lib/action_mailer/message_delivery.rb, line 41
def processed?
  @processed_mailer || @mail_message
end

Was the delegate loaded, causing the mailer action to be processed?