mirror of
https://github.com/rails/rails.git
synced 2022-11-09 12:12:34 -05:00
79 lines
2.2 KiB
Ruby
79 lines
2.2 KiB
Ruby
# frozen_string_literal: true
|
|
|
|
module ActiveStorage
|
|
# Representation of a single attachment to a model.
|
|
class Attached::One < Attached
|
|
delegate_missing_to :attachment
|
|
|
|
# Returns the associated attachment record.
|
|
#
|
|
# You don't have to call this method to access the attachment's methods as
|
|
# they are all available at the model level.
|
|
def attachment
|
|
change.present? ? change.attachment : record.public_send("#{name}_attachment")
|
|
end
|
|
|
|
def blank?
|
|
!attached?
|
|
end
|
|
|
|
# Attaches an +attachable+ to the record.
|
|
#
|
|
# If the record is persisted and unchanged, the attachment is saved to
|
|
# the database immediately. Otherwise, it'll be saved to the DB when the
|
|
# record is next saved.
|
|
#
|
|
# person.avatar.attach(params[:avatar]) # ActionDispatch::Http::UploadedFile object
|
|
# person.avatar.attach(params[:signed_blob_id]) # Signed reference to blob from direct upload
|
|
# person.avatar.attach(io: File.open("/path/to/face.jpg"), filename: "face.jpg", content_type: "image/jpg")
|
|
# person.avatar.attach(avatar_blob) # ActiveStorage::Blob object
|
|
def attach(attachable)
|
|
if record.persisted? && !record.changed?
|
|
record.update(name => attachable)
|
|
else
|
|
record.public_send("#{name}=", attachable)
|
|
end
|
|
end
|
|
|
|
# Returns +true+ if an attachment has been made.
|
|
#
|
|
# class User < ActiveRecord::Base
|
|
# has_one_attached :avatar
|
|
# end
|
|
#
|
|
# User.new.avatar.attached? # => false
|
|
def attached?
|
|
attachment.present?
|
|
end
|
|
|
|
# Deletes the attachment without purging it, leaving its blob in place.
|
|
def detach
|
|
if attached?
|
|
attachment.delete
|
|
write_attachment nil
|
|
end
|
|
end
|
|
|
|
# Directly purges the attachment (i.e. destroys the blob and
|
|
# attachment and deletes the file on the service).
|
|
def purge
|
|
if attached?
|
|
attachment.purge
|
|
write_attachment nil
|
|
end
|
|
end
|
|
|
|
# Purges the attachment through the queuing system.
|
|
def purge_later
|
|
if attached?
|
|
attachment.purge_later
|
|
write_attachment nil
|
|
end
|
|
end
|
|
|
|
private
|
|
def write_attachment(attachment)
|
|
record.public_send("#{name}_attachment=", attachment)
|
|
end
|
|
end
|
|
end
|