Spec-Zone.ru › Ruby on Rails 8.0

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

Active Storage Прикреплённый Модель

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

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

*_attachment() Показать исходный код 
# File activestorage/lib/active_storage/attached/model.rb, line 13

Возвращает прикрепление для has_one_attached.

User.last.avatar_attachment
*_attachments() Показать исходный код 
# File activestorage/lib/active_storage/attached/model.rb, line 20

Возвращает прикрепления для has_many_attached.

Gallery.last.photos_attachments
*_blob() Показать исходный код 
# File activestorage/lib/active_storage/attached/model.rb, line 27

Возвращает blob для прикрепления has_one_attached.

User.last.avatar_blob
*_blobs() Показать исходный код 
# File activestorage/lib/active_storage/attached/model.rb, line 34

Возвращает blobs для прикреплений has_many_attached.

Gallery.last.photos_blobs
has_many_attached(name, dependent: :purge_later, service: nil, strict_loading: false) { |reflection| ... } Показать исходный код 
# File activestorage/lib/active_storage/attached/model.rb, line 210
      def has_many_attached(name, dependent: :purge_later, service: nil, strict_loading: false)
        ActiveStorage::Blob.validate_service_configuration(service, self, name) unless service.is_a?(Proc)

        generated_association_methods.class_eval <<-CODE, __FILE__, __LINE__ + 1
          # frozen_string_literal: true
          def #{name}
            @active_storage_attached ||= {}
            @active_storage_attached[:#{name}] ||= ActiveStorage::Attached::Many.new("#{name}", self)
          end

          def #{name}=(attachables)
            attachables = Array(attachables).compact_blank
            pending_uploads = attachment_changes["#{name}"].try(:pending_uploads)

            attachment_changes["#{name}"] = if attachables.none?
              ActiveStorage::Attached::Changes::DeleteMany.new("#{name}", self)
            else
              ActiveStorage::Attached::Changes::CreateMany.new("#{name}", self, attachables, pending_uploads: pending_uploads)
            end
          end
        CODE

        has_many :"#{name}_attachments", -> { where(name: name) }, as: :record, class_name: "ActiveStorage::Attachment", inverse_of: :record, dependent: :destroy, strict_loading: strict_loading
        has_many :"#{name}_blobs", through: :"#{name}_attachments", class_name: "ActiveStorage::Blob", source: :blob, strict_loading: strict_loading

        scope :"with_attached_#{name}", -> {
          if ActiveStorage.track_variants
            includes("#{name}_attachments": { blob: {
              variant_records: { image_attachment: :blob },
              preview_image_attachment: { blob: { variant_records: { image_attachment: :blob } } }
            } })
          else
            includes("#{name}_attachments": :blob)
          end
        }

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

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

        reflection = ActiveRecord::Reflection.create(
          :has_many_attached,
          name,
          nil,
          { dependent: dependent, service_name: service },
          self
        )
        yield reflection if block_given?
        ActiveRecord::Reflection.add_attachment_reflection(self, name, reflection)
      end

Определяет отношение между множеством прикреплений и моделью.

class Gallery < ApplicationRecord
  has_many_attached :photos
end

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

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

Вместо этого has_many_attached генерирует прокси ActiveStorage::Attached::Many для доступа к ассоциациям и методам фабрики, таким как attach:

user.photos.attach(uploaded_file)

Опция :dependent по умолчанию равна :purge_later. Это означает, что прикрепления будут удалены (т.е. уничтожены) в фоновом режиме всякий раз, когда запись уничтожается. Если в приложении не установлен адаптер очереди ActiveJob::Backend, установите его в purge вместо этого.

Если вам нужно, чтобы прикрепление использовало службу, отличную от глобально настроенной, передайте опцию :service. Например:

class Gallery < ActiveRecord::Base
  has_many_attached :photos, service: :s3
end

:service также может быть задано как лямбда-выражение, и оно будет вызываться с экземпляром модели:

class Gallery < ActiveRecord::Base
  has_many_attached :photos, service: ->(gallery) { gallery.personal? ? :personal_s3 : :s3 }
end

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

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

Если вам нужно включить strict_loading для предотвращения ленивой загрузки прикреплений, передайте опцию :strict_loading. Вы можете сделать так:

class Gallery < ApplicationRecord
  has_many_attached :photos, strict_loading: true
end

Примечание: Active Storage использует полиморфные ассоциации, которые, в свою очередь, хранят имена классов в базе данных. При переименовании классов, использующих has_many, убедитесь, что вы также обновите имена классов в столбце полиморфного типа active_storage_attachments.record_type соответствующих строк.

has_one_attached(name, dependent: :purge_later, service: nil, strict_loading: false) { |reflection| ... } Показать исходный код 
# File activestorage/lib/active_storage/attached/model.rb, line 108
      def has_one_attached(name, dependent: :purge_later, service: nil, strict_loading: false)
        ActiveStorage::Blob.validate_service_configuration(service, self, name) unless service.is_a?(Proc)

        generated_association_methods.class_eval <<-CODE, __FILE__, __LINE__ + 1
          # frozen_string_literal: true
          def #{name}
            @active_storage_attached ||= {}
            @active_storage_attached[:#{name}] ||= ActiveStorage::Attached::One.new("#{name}", self)
          end

          def #{name}=(attachable)
            attachment_changes["#{name}"] =
              if attachable.nil? || attachable == ""
                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, strict_loading: strict_loading
        has_one :"#{name}_blob", through: :"#{name}_attachment", class_name: "ActiveStorage::Blob", source: :blob, strict_loading: strict_loading

        scope :"with_attached_#{name}", -> {
          if ActiveStorage.track_variants
            includes("#{name}_attachment": { blob: {
              variant_records: { image_attachment: :blob },
              preview_image_attachment: { blob: { variant_records: { image_attachment: :blob } } }
            } })
          else
            includes("#{name}_attachment": :blob)
          end
        }

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

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

        reflection = ActiveRecord::Reflection.create(
          :has_one_attached,
          name,
          nil,
          { dependent: dependent, service_name: service },
          self
        )
        yield reflection if block_given?
        ActiveRecord::Reflection.add_attachment_reflection(self, name, reflection)
      end

Определяет отношение между одним прикреплением и моделью.

class User < ApplicationRecord
  has_one_attached :avatar
end

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

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

Вместо этого has_one_attached генерирует прокси ActiveStorage::Attached::One для доступа к ассоциациям и методам фабрики, таким как attach:

user.avatar.attach(uploaded_file)

Опция :dependent по умолчанию равна :purge_later. Это означает, что прикрепление будет удалено (т.е. уничтожено) в фоновом режиме всякий раз, когда запись уничтожается. Если в приложении не установлен адаптер очереди ActiveJob::Backend, установите его в purge вместо этого.

Если вам нужно, чтобы прикрепление использовало службу, отличную от глобально настроенной, передайте опцию :service. Например:

class User < ActiveRecord::Base
  has_one_attached :avatar, service: :s3
end

:service также может быть задано как лямбда-выражение, и оно будет вызываться с экземпляром модели:

class User < ActiveRecord::Base
  has_one_attached :avatar, service: ->(user) { user.in_europe_region? ? :s3_europe : :s3_usa }
end

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

User.with_attached_avatar

Если вам нужно включить strict_loading для предотвращения ленивой загрузки прикрепления, передайте опцию :strict_loading . Вы можете сделать так:

class User < ApplicationRecord
  has_one_attached :avatar, strict_loading: true
end

Примечание: Active Storage использует полиморфные ассоциации, которые, в свою очередь, хранят имена классов в базе данных. При переименовании классов, использующих has_one_attached, убедитесь, что вы также обновили имена классов в столбце полиморфного типа active_storage_attachments.record_type соответствующих строк.

with_attached_*() Показать исходный код 
# File activestorage/lib/active_storage/attached/model.rb, line 54
    class_methods do
      # Specifies the relation between a single attachment and the model.
      #
      #   class User < ApplicationRecord
      #     has_one_attached :avatar
      #   end
      #
      # There is no column defined on the model side, Active Storage takes
      # care of the mapping between your records and the attachment.
      #
      # Under the covers, this relationship is implemented as a +has_one+ association to a
      # ActiveStorage::Attachment record and a +has_one-through+ association to a
      # ActiveStorage::Blob record. These associations are available as +avatar_attachment+
      # and +avatar_blob+. But you shouldn't need to work with these associations directly in
      # most circumstances.
      #
      # Instead, +has_one_attached+ generates an ActiveStorage::Attached::One proxy to
      # provide access to the associations and factory methods, like +attach+:
      #
      #   user.avatar.attach(uploaded_file)
      #
      # The +:dependent+ option defaults to +:purge_later+. This means the attachment will be
      # purged (i.e. destroyed) in the background whenever the record is destroyed.
      # If an ActiveJob::Backend queue adapter is not set in the application set it to
      # +purge+ instead.
      #
      # If you need the attachment to use a service which differs from the globally configured one,
      # pass the +:service+ option. For example:
      #
      #   class User < ActiveRecord::Base
      #     has_one_attached :avatar, service: :s3
      #   end
      #
      # +:service+ can also be specified as a proc, and it will be called with the model instance:
      #
      #   class User < ActiveRecord::Base
      #     has_one_attached :avatar, service: ->(user) { user.in_europe_region? ? :s3_europe : :s3_usa }
      #   end
      #
      # To avoid N+1 queries, you can include the attached blobs in your query like so:
      #
      #   User.with_attached_avatar
      #
      # If you need to enable +strict_loading+ to prevent lazy loading of attachment,
      # pass the +:strict_loading+ option. You can do:
      #
      #   class User < ApplicationRecord
      #     has_one_attached :avatar, strict_loading: true
      #   end
      #
      # Note: Active Storage relies on polymorphic associations, which in turn store class names in the database.
      # When renaming classes that use <tt>has_one_attached</tt>, make sure to also update the class names in the
      # <tt>active_storage_attachments.record_type</tt> polymorphic type column of
      # the corresponding rows.
      def has_one_attached(name, dependent: :purge_later, service: nil, strict_loading: false)
        ActiveStorage::Blob.validate_service_configuration(service, self, name) unless service.is_a?(Proc)

        generated_association_methods.class_eval <<-CODE, __FILE__, __LINE__ + 1
          # frozen_string_literal: true
          def #{name}
            @active_storage_attached ||= {}
            @active_storage_attached[:#{name}] ||= ActiveStorage::Attached::One.new("#{name}", self)
          end

          def #{name}=(attachable)
            attachment_changes["#{name}"] =
              if attachable.nil? || attachable == ""
                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, strict_loading: strict_loading
        has_one :"#{name}_blob", through: :"#{name}_attachment", class_name: "ActiveStorage::Blob", source: :blob, strict_loading: strict_loading

        scope :"with_attached_#{name}", -> {
          if ActiveStorage.track_variants
            includes("#{name}_attachment": { blob: {
              variant_records: { image_attachment: :blob },
              preview_image_attachment: { blob: { variant_records: { image_attachment: :blob } } }
            } })
          else
            includes("#{name}_attachment": :blob)
          end
        }

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

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

        reflection = ActiveRecord::Reflection.create(
          :has_one_attached,
          name,
          nil,
          { dependent: dependent, service_name: service },
          self
        )
        yield reflection if block_given?
        ActiveRecord::Reflection.add_attachment_reflection(self, name, reflection)
      end

      # Specifies the relation between multiple attachments and the model.
      #
      #   class Gallery < ApplicationRecord
      #     has_many_attached :photos
      #   end
      #
      # There are no columns defined on the model side, Active Storage takes
      # care of the mapping between your records and the attachments.
      #
      # Under the covers, this relationship is implemented as a +has_many+ association to a
      # ActiveStorage::Attachment record and a +has_many-through+ association to a
      # ActiveStorage::Blob record. These associations are available as +photos_attachments+
      # and +photos_blobs+. But you shouldn't need to work with these associations directly in
      # most circumstances.
      #
      # Instead, +has_many_attached+ generates an ActiveStorage::Attached::Many proxy to
      # provide access to the associations and factory methods, like +attach+:
      #
      #   user.photos.attach(uploaded_file)
      #
      # The +:dependent+ option defaults to +:purge_later+. This means the attachments will be
      # purged (i.e. destroyed) in the background whenever the record is destroyed.
      # If an ActiveJob::Backend queue adapter is not set in the application set it to
      # +purge+ instead.
      #
      # If you need the attachment to use a service which differs from the globally configured one,
      # pass the +:service+ option. For example:
      #
      #   class Gallery < ActiveRecord::Base
      #     has_many_attached :photos, service: :s3
      #   end
      #
      # +:service+ can also be specified as a proc, and it will be called with the model instance:
      #
      #   class Gallery < ActiveRecord::Base
      #     has_many_attached :photos, service: ->(gallery) { gallery.personal? ? :personal_s3 : :s3 }
      #   end
      #
      # To avoid N+1 queries, you can include the attached blobs in your query like so:
      #
      #   Gallery.where(user: Current.user).with_attached_photos
      #
      # If you need to enable +strict_loading+ to prevent lazy loading of attachments,
      # pass the +:strict_loading+ option. You can do:
      #
      #   class Gallery < ApplicationRecord
      #     has_many_attached :photos, strict_loading: true
      #   end
      #
      # Note: Active Storage relies on polymorphic associations, which in turn store class names in the database.
      # When renaming classes that use <tt>has_many</tt>, make sure to also update the class names in the
      # <tt>active_storage_attachments.record_type</tt> polymorphic type column of
      # the corresponding rows.
      def has_many_attached(name, dependent: :purge_later, service: nil, strict_loading: false)
        ActiveStorage::Blob.validate_service_configuration(service, self, name) unless service.is_a?(Proc)

        generated_association_methods.class_eval <<-CODE, __FILE__, __LINE__ + 1
          # frozen_string_literal: true
          def #{name}
            @active_storage_attached ||= {}
            @active_storage_attached[:#{name}] ||= ActiveStorage::Attached::Many.new("#{name}", self)
          end

          def #{name}=(attachables)
            attachables = Array(attachables).compact_blank
            pending_uploads = attachment_changes["#{name}"].try(:pending_uploads)

            attachment_changes["#{name}"] = if attachables.none?
              ActiveStorage::Attached::Changes::DeleteMany.new("#{name}", self)
            else
              ActiveStorage::Attached::Changes::CreateMany.new("#{name}", self, attachables, pending_uploads: pending_uploads)
            end
          end
        CODE

        has_many :"#{name}_attachments", -> { where(name: name) }, as: :record, class_name: "ActiveStorage::Attachment", inverse_of: :record, dependent: :destroy, strict_loading: strict_loading
        has_many :"#{name}_blobs", through: :"#{name}_attachments", class_name: "ActiveStorage::Blob", source: :blob, strict_loading: strict_loading

        scope :"with_attached_#{name}", -> {
          if ActiveStorage.track_variants
            includes("#{name}_attachments": { blob: {
              variant_records: { image_attachment: :blob },
              preview_image_attachment: { blob: { variant_records: { image_attachment: :blob } } }
            } })
          else
            includes("#{name}_attachments": :blob)
          end
        }

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

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

        reflection = ActiveRecord::Reflection.create(
          :has_many_attached,
          name,
          nil,
          { dependent: dependent, service_name: service },
          self
        )
        yield reflection if block_given?
        ActiveRecord::Reflection.add_attachment_reflection(self, name, reflection)
      end
    end

Включает прикрепленные blobs в ваш запрос, чтобы избежать N+1 запросов.

Если ActiveStorage.track_variants включено, оно также включит записи вариантов и их прикреплённые blobs.

User.with_attached_avatar

Используйте множественное число для has_many_attached:

Gallery.with_attached_photos

© 2004–2021 David Heinemeier Hansson
Licensed under the MIT License.

Spec-Zone.ru

Настройки Оффлайн Что нового Помощь О нас
Spec-Zone .ru
спецификации, руководства, описания, API