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 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70 71 72 73 74 75 76 77 78 79
|
# frozen_string_literal: true
module ActiveStorage
# = Active Storage \Attached \Many
#
# Decorated proxy object representing of multiple attachments to a model.
class Attached::Many < Attached
##
# :method: purge
#
# Directly purges each associated attachment (i.e. destroys the blobs and
# attachments and deletes the files on the service).
delegate :purge, to: :purge_many
##
# :method: purge_later
#
# Purges each associated attachment through the queuing system.
delegate :purge_later, to: :purge_many
##
# :method: detach
#
# Deletes associated attachments without purging them, leaving their respective blobs in place.
delegate :detach, to: :detach_many
delegate_missing_to :attachments
# Returns all the associated attachment records.
#
# All methods called on this proxy object that aren't listed here will automatically be delegated to +attachments+.
def attachments
change.present? ? change.attachments : record.public_send("#{name}_attachments")
end
# Returns all attached blobs.
def blobs
change.present? ? change.blobs : record.public_send("#{name}_blobs")
end
# Attaches one or more +attachables+ to the record.
#
# If the record is persisted and unchanged, the attachments are saved to
# the database immediately. Otherwise, they'll be saved to the DB when the
# record is next saved.
#
# document.images.attach(params[:images]) # Array of ActionDispatch::Http::UploadedFile objects
# document.images.attach(params[:signed_blob_id]) # Signed reference to blob from direct upload
# document.images.attach(io: File.open("/path/to/racecar.jpg"), filename: "racecar.jpg", content_type: "image/jpeg")
# document.images.attach([ first_blob, second_blob ])
def attach(*attachables)
record.public_send("#{name}=", blobs + attachables.flatten)
if record.persisted? && !record.changed?
return if !record.save
end
record.public_send("#{name}")
end
# Returns true if any attachments have been made.
#
# class Gallery < ApplicationRecord
# has_many_attached :photos
# end
#
# Gallery.new.photos.attached? # => false
def attached?
attachments.any?
end
private
def purge_many
Attached::Changes::PurgeMany.new(name, record, attachments)
end
def detach_many
Attached::Changes::DetachMany.new(name, record, attachments)
end
end
end
|