aboutsummaryrefslogtreecommitdiffstats
path: root/activestorage/app/models/active_storage/attachment.rb
blob: ad43845e4e69e74a3a8a37da5474e636b05dbb45 (plain) (blame)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
# frozen_string_literal: true

require "active_support/core_ext/module/delegation"

# Attachments associate records with blobs. Usually that's a one record-many blobs relationship,
# but it is possible to associate many different records with the same blob. If you're doing that,
# you'll want to declare with <tt>has_one/many_attached :thingy, dependent: false</tt>, so that destroying
# any one record won't destroy the blob as well. (Then you'll need to do your own garbage collecting, though).
class ActiveStorage::Attachment < ActiveRecord::Base
  self.table_name = "active_storage_attachments"

  belongs_to :record, polymorphic: true
  belongs_to :blob, class_name: "ActiveStorage::Blob"

  delegate_missing_to :blob

  # Purging an attachment will purge the blob (delete the file on the service, then destroy the record)
  # and then destroy the attachment itself.
  def purge
    blob.purge
    destroy
  end

  # Purging an attachment means purging the blob, which means talking to the service, which means
  # talking over the Internet. Whenever you're doing that, it's a good idea to put that work in a job,
  # so it doesn't hold up other operations. That's what +purge_later+ provides.
  def purge_later
    ActiveStorage::PurgeJob.perform_later(self)
  end
end