Module: ActiveJob::Exceptions
Relationships & Source Files | |
Namespace Children | |
Modules:
| |
Extension / Inclusion / Inheritance Descendants | |
Included In:
ActionMailer::DeliveryJob,
ActionMailer::MailDeliveryJob,
ActionMailer::Parameterized::DeliveryJob,
Base ,
::ActiveRecord::DestroyAssociationAsyncJob
| |
Super Chains via Extension / Inclusion / Inheritance | |
Class Chain:
self,
::ActiveSupport::Concern
|
|
Defined in: | activejob/lib/active_job/exceptions.rb |
Overview
Provides behavior for retrying and discarding jobs on exceptions.
Constant Summary
-
JITTER_DEFAULT =
private
# File 'activejob/lib/active_job/exceptions.rb', line 129Object.new
Class Method Summary
::ActiveSupport::Concern
- Extended
class_methods | Define class methods from given block. |
included | Evaluate given block in context of base class, so that you can write class macros here. |
prepended | Evaluate given block in context of base class, so that you can write class macros here. |
Instance Method Summary
-
#retry_job(options = {})
Reschedules the job to be re-executed.
DSL Calls
included
[ GitHub ]10 11 12
# File 'activejob/lib/active_job/exceptions.rb', line 10
included do class_attribute :retry_jitter, instance_accessor: false, instance_predicate: false, default: 0.0 end
Instance Method Details
#retry_job(options = {})
Reschedules the job to be re-executed. This is useful in combination with the rescue_from
option. When you rescue an exception from your job you can ask Active Job to retry performing your job.
Options
-
:wait
- Enqueues the job with the specified delay in seconds -
:wait_until
- Enqueues the job at the time specified -
:queue
- Enqueues the job on the specified queue -
:priority
- Enqueues the job with the specified priority
Examples
class SiteScraperJob < ActiveJob::Base
rescue_from(ErrorLoadingSite) do
retry_job queue: :low_priority
end
def perform(*args)
# raise ErrorLoadingSite if cannot scrape
end
end
# File 'activejob/lib/active_job/exceptions.rb', line 122
def retry_job( = {}) instrument :enqueue_retry, .slice(:error, :wait) do enqueue end end