文章原文地址：https://github.com/mperham/sidekiq/wiki/Active-Job

Active Job

Active Job Introduction

---

Rails 4.2 引入了 Active Job。Active Job 是一个为了与任务执行者进行交互而提供的标准的接口。Active Job 可以被配置成与 Sidekiq 一起工作。

需要注意的是，许多高级的 Sidekiq 特性（sidekiq_options） 无法通过ActiveJob控制或者配置，例如，保存回溯（backtraces）

Active Job Setup

---

Active Job 装配器可能被设置为 :sidekiq 或者它仅仅简单的使用默认的 :inline。在 config/application.rb 中像这样做是可行的：

class Application < Rails::Application
    #...
    config.active_job.queue_adapter = :sidekiq
end 

我们可以用发生器来创建一个新的任务。

rails generate job Example

上面的命令将会创建 /app/jobs/example_job.rb

class ExampleJob < ActiveJob::Base
    # Set the Queue as Default
    queue_as :default
    
    def perform(*args)
      # Perform Job
    end
end

Usage

---

任务可以在任何地方被添加到任务队列。我们可以通过以下方式添加一个任务到队列当中：

    ExampleJob.perform_later args

这样，Sidekiq 会为我们运行这个任务。如果任务因为某些原因失败了，Sidekiq 通常会重试这些任务。

Customizing error handling

---

Activejob 不支持 Sidekiq 的丰富的 retry 特性.取而代之的是，它为编写任务的重试功能提供了一个简单抽象，在你遇到特定的异常时。

class ExampleJob < ActiveJob::Base
  rescue_from(ErrorLoadingSite) do
    retry_job wait: 5.minutes, queue: :low_priority 
  end 

  def perform(*args)
    # Perform Job
  end
end

警告： 如果你使用ActiveJob实现重试功能，你将会失去一系列的 Sidekiq 的功能：

1. 可视化网页（Retries 选项卡将会是空）
2. 你不能使用 Sidekiq::RetrySet 的 API 来进行重试任务
3. Sidekiq 的 日期将不会包含任务错误或回溯
4. 错误将不会被报告给Sidekiq的全局错误处理函数
5. 你将无法使用一些与 AJ 的重试有关的高级 Sidekiq 的特性

Action Mailer

---

Action Mailer 现在带来了一个名为 #deliver_later 的方法，这个方法会异步（你的邮件将会在后台任务中发送）的发邮件。如果 Active Job 被设置成用 Sdiekiq ，我们可以使用 #deliver_later 方法。不同于 Sidekiq，使用 Active Job 会用全局ID 来序列化所有的 activerecord 实例对象。之后这些实例对象可能会被反序列化。

发件人会被放进邮件队列。记住启动 sidekiq 处理上面所说的队列：

bundle exec sidekiq -q default -q mailers

为了发送一条普通信息到任务队列中，我们可以使用：

UserMailer.welcome_email(@user).deliver_later

如果你想绕过任务队列并且异步执行任务，你可以使用：

UserMailer.welcome_email(@user).deliver_now

使用 Sidekiq 我们可以选择设置延迟来发送邮件。我们也能通过 Active Job 做同样的事情。

在 Sidekiq 中，以前的发送延迟消息的语法：

UserMailer.delay_for(1.hour).welcome_email(@user.id)
UserMailer.delay_until(5.days.from_now).welcome_email(@user.id)

新的语法通过 Active Job 发送延迟消息：

UserMailer.welcome_email(@user).deliver_later(wait: 1.hour)
UserMailer.welcome_email(@user).deliver_later(wait_until: 10.hours.from_now)

Limitations

---

ActiveJob 使用全局ID，允许序列化全部的 ActiveRecord 对象 作为 #perform 方法的一个参数，结果就是

def perform(user_id)
  user = User.find(user_id)
  user.send_welcome_email!
end

可以被替换为

def perform(user)
  user.send_welcome_email!
end

不幸的是这就意味着如果 User 记录在任务已经进入队列但是 perform 方法被执行之前被删掉了，异常的处理方式会发生变化。对于通常的 Sdiekiq，你可以这样子来处理：

def perform(user_id)
  user = User.find_by(id: user_id)

  if user
    user.send_welcome_email!
  else
    # handle a deleted user record
  end
end

而使用 ActiveJob ，那么 perform(user) 将反而 raise 缺失记录异常作为反序列化 User 实例的一部分。

你可以这样解决这个问题：

class MyJob < ActiveJob::Base
  rescue_from ActiveJob::DeserializationError do |exception|
    # handle a deleted user record
  end

  # ...
end

Job ID

---

ActiveJob 有自己的 Job ID ，但是这对于 Sidekiq 来说没有意义。在 Rails 5 中，你将能够获得 Sidekiq 的 JID，通过使用 provider_job_id 方法

job = SomeJob.perform_later
jid = job.provider_job_id

Commercial Features

---

许多 Sidekiq 专业版和商业版的特性，如果你尝试使用 ActiveJob 来利用这些特性那么它们将会以无法预料的方式停止。举个例子，创建一批 ActiveJobs 能在基本情况下运行良好，但是如果在那些任务中使用 ActiveJob 的重试机制将会失败。如有疑问，不要混用 AJ 和 Sidekiq 的原生 APIs