Базовый класс Action Mailbox

Базовый класс для всех почтовых ящиков приложения. Не предназначен для прямого наследования. Наследуйте от ApplicationMailbox вместо этого, так как именно там настраивается маршрутизация, специфичная для приложения. Эта маршрутизация задаётся следующими способами:

class ApplicationMailbox < ActionMailbox::Base
  # Any of the recipients of the mail (whether to, cc, bcc) are matched against the regexp.
  routing /^replies@/i => :replies

  # Any of the recipients of the mail (whether to, cc, bcc) needs to be an exact match for the string.
  routing "help@example.com" => :help

  # Any callable (proc, lambda, etc) object is passed the inbound_email record and is a match if true.
  routing ->(inbound_email) { inbound_email.mail.to.size > 2 } => :multiple_recipients

  # Any object responding to #match? is called with the inbound_email record as an argument. Match if true.
  routing CustomAddress.new => :custom

  # Any inbound_email that has not been already matched will be sent to the BackstopMailbox.
  routing :all => :backstop
end

Приложениям почтовых ящиков необходимо переопределить метод process, который вызывается фреймворком после выполнения обратных вызовов. Доступные обратные вызовы: before_processing, after_processing, и around_processing. Основной случай использования — обеспечение выполнения определённых предварительных условий для обработки с помощью обратных вызовов before_processing.

Если какое-либо предварительное условие не выполняется, вы можете остановить обработку, используя метод #bounced!, который незаметно предотвратит дальнейшую обработку, но фактически не отправит никакое уведомление о возврате. Вы также можете сочетать это поведение с вызовом класса Action Mailer, ответственного за отправку фактического сообщения об ошибке. Это делается с помощью метода bounce_with, который принимает объект письма, возвращённый методом Action Mailer, например так:

class ForwardsMailbox < ApplicationMailbox
  before_processing :ensure_sender_is_a_user

  private
    def ensure_sender_is_a_user
      unless User.exist?(email_address: mail.from)
        bounce_with UserRequiredMailer.missing(inbound_email)
      end
    end
end

В процессе обработки входящего письма отслеживается статус. Перед началом обработки письмо обычно имеет статус pending. После начала обработки, непосредственно перед вызовами обратных функций и метода process, статус меняется на processing. Если обработка завершается успешно, статус меняется на delivered. Если происходит возврат, то bounced. Если возникает необработанное исключение, то failed.

Исключения можно обрабатывать на уровне класса, используя привычный подход ActiveSupport::Rescuable:

class ForwardsMailbox < ApplicationMailbox
  rescue_from(ApplicationSpecificVerificationError) { bounced! }
end