123456789_123456789_123456789_123456789_123456789_

Class: ActiveStorage::Attached::Many

Relationships & Source Files
Super Chains via Extension / Inclusion / Inheritance
Class Chain:
self, ::ActiveStorage::Attached
Instance Chain:
self, ::ActiveStorage::Attached
Inherits: ActiveStorage::Attached
Defined in: activestorage/lib/active_storage/attached/many.rb

Overview

Decorated proxy object representing of multiple attachments to a model.

Class Method Summary

::ActiveStorage::Attached - Inherited

.new

Instance Attribute Summary

::ActiveStorage::Attached - Inherited

#dependent, #name, #record

Instance Method Summary

  • #attach(*attachables)

    Associates one or several attachments with the current record, saving them to the database.

  • #attachments

    Returns all the associated attachment records.

  • #detach

    Deletes associated attachments without purging them, leaving their respective blobs in place.

  • #purge

    Directly purges each associated attachment (i.e.

  • #purge_later

    Purges each associated attachment through the queuing system.

Constructor Details

This class inherits a constructor from ActiveStorage::Attached

Instance Attribute Details

#attached? ⇒ Boolean (readonly)

Returns true if any attachments has been made.

class Gallery < ActiveRecord::Base
  has_many_attached :photos
end

Gallery.new.photos.attached? # => false
[ GitHub ] 

  


# File 'activestorage/lib/active_storage/attached/many.rb', line 38



def attached?
  attachments.any?
end


  







Instance Method Details



  

    #attach(*attachables)  
  



  

    

Associates one or several attachments with the current record, saving them to the database.



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/jpg")
document.images.attach([ first_blob, second_blob ])


  



  [ GitHub ]


  

  


# File 'activestorage/lib/active_storage/attached/many.rb', line 21



def attach(*attachables)
  attachables.flatten.collect do |attachable|
    if record.new_record?
      attachments.build(record: record, blob: create_blob_from(attachable))
    else
      attachments.create!(record: record, blob: create_blob_from(attachable))
    end
  end
end


  








  

    #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.


  



  [ GitHub ]


  

  


# File 'activestorage/lib/active_storage/attached/many.rb', line 11



def attachments
  record.public_send("#{name}_attachments")
end


  








  

    #detach  
  



  

    

Deletes associated attachments without purging them, leaving their respective blobs in place.


  



  [ GitHub ]


  

  


# File 'activestorage/lib/active_storage/attached/many.rb', line 43



def detach
  attachments.destroy_all if attached?
end


  








  

    #purge  
  



  

    

Directly purges each associated attachment (i.e. destroys the blobs and attachments and deletes the files on the service).


  



  [ GitHub ]


  

  


# File 'activestorage/lib/active_storage/attached/many.rb', line 48



rdoc_method :method: purge


  








  

    #purge_later  
  



  

    

Purges each associated attachment through the queuing system.


  



  [ GitHub ]


  

  


# File 'activestorage/lib/active_storage/attached/many.rb', line 55



rdoc_method :method: purge_later