Sha256: 517d756ec2445509b01613cc79efd5163e9bf3036e88fb123ab5c274ceafab9b

Contents?: true

Size: 1.92 KB

Versions: 29

Compression:

Stored size: 1.92 KB

Contents

# frozen_string_literal: true

module ActiveStorage
  # Decorated proxy object representing of multiple attachments to a model.
  class Attached::Many < Attached
    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
      record.public_send("#{name}_attachments")
    end

    # 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 ])
    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

    # Returns true if any attachments has been made.
    #
    #   class Gallery < ActiveRecord::Base
    #     has_many_attached :photos
    #   end
    #
    #   Gallery.new.photos.attached? # => false
    def attached?
      attachments.any?
    end

    # Deletes associated attachments without purging them, leaving their respective blobs in place.
    def detach
      attachments.destroy_all if attached?
    end

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


    ##
    # :method: purge_later
    #
    # Purges each associated attachment through the queuing system.
  end
end

Version data entries

29 entries across 29 versions & 2 rubygems

Version Path
activestorage-5.2.8.1 lib/active_storage/attached/many.rb
activestorage-5.2.8 lib/active_storage/attached/many.rb
activestorage-5.2.7.1 lib/active_storage/attached/many.rb
activestorage-5.2.7 lib/active_storage/attached/many.rb
activestorage-5.2.6.3 lib/active_storage/attached/many.rb
activestorage-5.2.6.2 lib/active_storage/attached/many.rb
activestorage-5.2.6.1 lib/active_storage/attached/many.rb
activestorage-5.2.6 lib/active_storage/attached/many.rb
activestorage-5.2.4.6 lib/active_storage/attached/many.rb
activestorage-5.2.5 lib/active_storage/attached/many.rb
activestorage-5.2.4.5 lib/active_storage/attached/many.rb
activestorage-5.2.4.4 lib/active_storage/attached/many.rb
activestorage-5.2.4.3 lib/active_storage/attached/many.rb
activestorage-5.2.4.2 lib/active_storage/attached/many.rb
activestorage-5.2.4.1 lib/active_storage/attached/many.rb
activestorage-5.2.4 lib/active_storage/attached/many.rb
activestorage-5.2.4.rc1 lib/active_storage/attached/many.rb
spiral_form-0.1.1 vendor/bundle/gems/activestorage-5.2.3/lib/active_storage/attached/many.rb
spiral_form-0.1.0 vendor/bundle/gems/activestorage-5.2.3/lib/active_storage/attached/many.rb
activestorage-5.2.3 lib/active_storage/attached/many.rb