mirror of
https://github.com/rails/rails.git
synced 2022-11-09 12:12:34 -05:00
75 lines
2.2 KiB
Ruby
75 lines
2.2 KiB
Ruby
# 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. A foreign-key constraint
|
||
# on the attachments table prevents blobs from being purged if they’re still attached to any records.
|
||
#
|
||
# Attachments also have access to all methods from {ActiveStorage::Blob}[rdoc-ref:ActiveStorage::Blob].
|
||
class ActiveStorage::Attachment < ActiveStorage::Record
|
||
self.table_name = "active_storage_attachments"
|
||
|
||
belongs_to :record, polymorphic: true, touch: true
|
||
belongs_to :blob, class_name: "ActiveStorage::Blob", autosave: true
|
||
|
||
delegate_missing_to :blob
|
||
delegate :signed_id, to: :blob
|
||
|
||
after_create_commit :mirror_blob_later, :analyze_blob_later
|
||
after_destroy_commit :purge_dependent_blob_later
|
||
|
||
# Synchronously deletes the attachment and {purges the blob}[rdoc-ref:ActiveStorage::Blob#purge].
|
||
def purge
|
||
transaction do
|
||
delete
|
||
record&.touch
|
||
end
|
||
blob&.purge
|
||
end
|
||
|
||
# Deletes the attachment and {enqueues a background job}[rdoc-ref:ActiveStorage::Blob#purge_later] to purge the blob.
|
||
def purge_later
|
||
transaction do
|
||
delete
|
||
record&.touch
|
||
end
|
||
blob&.purge_later
|
||
end
|
||
|
||
def variant(transformations)
|
||
case transformations
|
||
when Symbol
|
||
variant_name = transformations
|
||
transformations = variants.fetch(variant_name) do
|
||
record_model_name = record.to_model.model_name.name
|
||
raise ArgumentError, "Cannot find variant :#{variant_name} for #{record_model_name}##{name}"
|
||
end
|
||
end
|
||
|
||
blob.variant(transformations)
|
||
end
|
||
|
||
private
|
||
def analyze_blob_later
|
||
blob.analyze_later unless blob.analyzed?
|
||
end
|
||
|
||
def mirror_blob_later
|
||
blob.mirror_later
|
||
end
|
||
|
||
def purge_dependent_blob_later
|
||
blob&.purge_later if dependent == :purge_later
|
||
end
|
||
|
||
def dependent
|
||
record.attachment_reflections[name]&.options[:dependent]
|
||
end
|
||
|
||
def variants
|
||
record.attachment_reflections[name]&.variants
|
||
end
|
||
end
|
||
|
||
ActiveSupport.run_load_hooks :active_storage_attachment, ActiveStorage::Attachment
|