модуль ActiveStorage::Attached::Model

Предоставляет DSL-интерфейс уровня класса для объявления прикрепленных файлов модели Active Record.

Открытые методы экземпляров

has_many_attached(name, dependent: :purge_later) Показать исходный код

# File activestorage/lib/active_storage/attached/model.rb, line 89
      def has_many_attached(name, dependent: :purge_later)
        generated_association_methods.class_eval <<-CODE, __FILE__, __LINE__ + 1
          def #{name}
            @active_storage_attached_#{name} ||= ActiveStorage::Attached::Many.new("#{name}", self)
          end

          def #{name}=(attachables)
            if ActiveStorage.replace_on_assign_to_many
              attachment_changes["#{name}"] =
                if attachables.nil? || Array(attachables).none?
                  ActiveStorage::Attached::Changes::DeleteMany.new("#{name}", self)
                else
                  ActiveStorage::Attached::Changes::CreateMany.new("#{name}", self, attachables)
                end
            else
              if !attachables.nil? || Array(attachables).any?
                attachment_changes["#{name}"] =
                  ActiveStorage::Attached::Changes::CreateMany.new("#{name}", self, #{name}.blobs + attachables)
              end
            end
          end
        CODE

        has_many :"#{name}_attachments", -> { where(name: name) }, as: :record, class_name: "ActiveStorage::Attachment", inverse_of: :record, dependent: :destroy do
          def purge
            each(&:purge)
            reset
          end

          def purge_later
            each(&:purge_later)
            reset
          end
        end
        has_many :"#{name}_blobs", through: :"#{name}_attachments", class_name: "ActiveStorage::Blob", source: :blob

        scope :"with_attached_#{name}", -> { includes("#{name}_attachments": :blob) }

        after_save { attachment_changes[name.to_s]&.save }

        after_commit(on: %i[ create update ]) { attachment_changes.delete(name.to_s).try(:upload) }

        ActiveRecord::Reflection.add_attachment_reflection(
          self,
          name,
          ActiveRecord::Reflection.create(:has_many_attached, name, nil, { dependent: dependent }, self)
        )
      end

Указывает связь между несколькими прикреплёнными файлами и моделью.

class Gallery < ActiveRecord::Base
  has_many_attached :photos
end

На стороне модели столбцы не определены, Active Storage позаботится о сопоставлении ваших записей и прикреплённых файлов.

Чтобы избежать запросов N+1, вы можете включить прикреплённые файлы в свой запрос следующим образом:

Gallery.where(user: Current.user).with_attached_photos

Внутренне это отношение реализовано как has_many ассоциация с записью ActiveStorage::Attachment и has_many-through ассоциация с записью ActiveStorage::Blob. Эти ассоциации доступны как photos_attachments и photos_blobs. Но в большинстве случаев вам не нужно будет работать с этими ассоциациями напрямую.

Система разработана таким образом, чтобы вы работали через прокси ActiveStorage::Attached::Many, который предоставляет динамический доступ к ассоциациям и фабричным методам, таким как #attach.

Если опция :dependent не установлена, все прикреплённые файлы будут удалены (т.е. уничтожены) при уничтожении записи.

has_one_attached(name, dependent: :purge_later) Показать исходный код

# File activestorage/lib/active_storage/attached/model.rb, line 33
      def has_one_attached(name, dependent: :purge_later)
        generated_association_methods.class_eval <<-CODE, __FILE__, __LINE__ + 1
          def #{name}
            @active_storage_attached_#{name} ||= ActiveStorage::Attached::One.new("#{name}", self)
          end

          def #{name}=(attachable)
            attachment_changes["#{name}"] =
              if attachable.nil?
                ActiveStorage::Attached::Changes::DeleteOne.new("#{name}", self)
              else
                ActiveStorage::Attached::Changes::CreateOne.new("#{name}", self, attachable)
              end
          end
        CODE

        has_one :"#{name}_attachment", -> { where(name: name) }, class_name: "ActiveStorage::Attachment", as: :record, inverse_of: :record, dependent: :destroy
        has_one :"#{name}_blob", through: :"#{name}_attachment", class_name: "ActiveStorage::Blob", source: :blob

        scope :"with_attached_#{name}", -> { includes("#{name}_attachment": :blob) }

        after_save { attachment_changes[name.to_s]&.save }

        after_commit(on: %i[ create update ]) { attachment_changes.delete(name.to_s).try(:upload) }

        ActiveRecord::Reflection.add_attachment_reflection(
          self,
          name,
          ActiveRecord::Reflection.create(:has_one_attached, name, nil, { dependent: dependent }, self)
        )
      end

Указывает связь между одним прикреплённым файлом и моделью.

class User < ActiveRecord::Base
  has_one_attached :avatar
end

Столбцы на стороне модели не определены, Active Storage позаботится о сопоставлении ваших записей и прикреплённого файла.

Чтобы избежать запросов N+1, вы можете включить прикреплённый файл в свой запрос следующим образом:

User.with_attached_avatar

Внутренне это отношение реализовано как has_one ассоциация с записью ActiveStorage::Attachment и has_one-through ассоциация с записью ActiveStorage::Blob. Эти ассоциации доступны как avatar_attachment и avatar_blob. Но в большинстве случаев вам не нужно будет работать с этими ассоциациями напрямую.

Система разработана таким образом, чтобы вы работали через прокси ActiveStorage::Attached::One, который предоставляет динамический доступ к ассоциациям и фабричным методам, таким как attach.

Если опция :dependent не установлена, прикреплённый файл будет удалён (т.е. уничтожен) при уничтожении записи.

purge() Показать исходный код

# File activestorage/lib/active_storage/attached/model.rb, line 113
def purge
  each(&:purge)
  reset
end

purge_later() Показать исходный код

# File activestorage/lib/active_storage/attached/model.rb, line 118
def purge_later
  each(&:purge_later)
  reset
end