These methods will be included into any Active Job object, adding callbacks for perform
and enqueue
methods.
Methods
Instance Public methods
after_enqueue(*filters, &blk)
Defines a callback that will get called right after the job is enqueued.
class VideoProcessJob < ActiveJob::Base
queue_as :default
after_enqueue do |job|
result = job.successfully_enqueued? ? "success" : "failure"
$statsd.increment "enqueue-video-job.#{result}"
end
def perform(video_id)
Video.find(video_id).process
end
end
📝 Source code
# File activejob/lib/active_job/callbacks.rb, line 144
def after_enqueue(*filters, &blk)
set_callback(:enqueue, :after, *filters, &blk)
end
🔎 See on GitHub
after_perform(*filters, &blk)
Defines a callback that will get called right after the job’s perform method has finished.
class VideoProcessJob < ActiveJob::Base
queue_as :default
after_perform do |job|
UserMailer.notify_video_processed(job.arguments.first)
end
def perform(video_id)
Video.find(video_id).process
end
end
📝 Source code
# File activejob/lib/active_job/callbacks.rb, line 72
def after_perform(*filters, &blk)
set_callback(:perform, :after, *filters, &blk)
end
🔎 See on GitHub
around_enqueue(*filters, &blk)
Defines a callback that will get called around the enqueuing of the job.
class VideoProcessJob < ActiveJob::Base
queue_as :default
around_enqueue do |job, block|
$statsd.time "video-job.process" do
block.call
end
end
def perform(video_id)
Video.find(video_id).process
end
end
📝 Source code
# File activejob/lib/active_job/callbacks.rb, line 165
def around_enqueue(*filters, &blk)
set_callback(:enqueue, :around, *filters, &blk)
end
🔎 See on GitHub
around_perform(*filters, &blk)
Defines a callback that will get called around the job’s perform method.
class VideoProcessJob < ActiveJob::Base
queue_as :default
around_perform do |job, block|
UserMailer.notify_video_started_processing(job.arguments.first)
block.call
UserMailer.notify_video_processed(job.arguments.first)
end
def perform(video_id)
Video.find(video_id).process
end
end
You can access the return value of the job only if the execution wasn’t halted.
class VideoProcessJob < ActiveJob::Base
around_perform do |job, block|
value = block.call
puts value # => "Hello World!"
end
def perform
"Hello World!"
end
end
📝 Source code
# File activejob/lib/active_job/callbacks.rb, line 105
def around_perform(*filters, &blk)
set_callback(:perform, :around, *filters, &blk)
end
🔎 See on GitHub
before_enqueue(*filters, &blk)
Defines a callback that will get called right before the job is enqueued.
class VideoProcessJob < ActiveJob::Base
queue_as :default
before_enqueue do |job|
$statsd.increment "enqueue-video-job.try"
end
def perform(video_id)
Video.find(video_id).process
end
end
📝 Source code
# File activejob/lib/active_job/callbacks.rb, line 124
def before_enqueue(*filters, &blk)
set_callback(:enqueue, :before, *filters, &blk)
end
🔎 See on GitHub
before_perform(*filters, &blk)
Defines a callback that will get called right before the job’s perform method is executed.
class VideoProcessJob < ActiveJob::Base
queue_as :default
before_perform do |job|
UserMailer.notify_video_started_processing(job.arguments.first)
end
def perform(video_id)
Video.find(video_id).process
end
end
📝 Source code
# File activejob/lib/active_job/callbacks.rb, line 53
def before_perform(*filters, &blk)
set_callback(:perform, :before, *filters, &blk)
end
🔎 See on GitHub