class ActiveStorage::Attachment

Parent:: ActiveStorage::Record

Active Storage Прикрепление

Прикрепления связывают записи с блобами. Обычно это отношение «одна запись — много блобов», но можно связать много разных записей с одним и тем же блобом. Ограничение внешнего ключа в таблице прикреплений предотвращает удаление блобов, если они всё ещё прикреплены к каким-либо записям.

Прикрепления также имеют доступ ко всем методам из ActiveStorage::Blob.

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

# preloads attachments, their corresponding blobs, and variant records (if using `ActiveStorage.track_variants`)
User.all.with_attached_avatars

# preloads blobs and variant records (if using `ActiveStorage.track_variants`)
User.first.avatars.with_all_variant_records

Публичные методы класса

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

# File activestorage/app/models/active_storage/attachment.rb, line 45
scope :with_all_variant_records, -> { includes(blob: {
  variant_records: { image_attachment: :blob },
  preview_image_attachment: { blob: { variant_records: { image_attachment: :blob } } }

Немедленная загрузка всех записей вариантов прикрепления сразу.

User.first.avatars.with_all_variant_records

Публичные методы экземпляра

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

# File activestorage/app/models/active_storage/attachment.rb, line 31
belongs_to :blob, class_name: "ActiveStorage::Blob", autosave: true, inverse_of: :attachments

Возвращает связанный ActiveStorage::Blob.

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

# File activestorage/app/models/active_storage/attachment.rb, line 101
def preview(transformations)
  transformations = transformations_by_name(transformations)
  blob.preview(transformations)
end

Возвращает экземпляр ActiveStorage::Preview для прикрепления с набором transformations. Пример:

video.preview(resize_to_limit: [100, 100]).processed.url

или, если вы используете предварительно определенные варианты:

video.preview(:thumb).processed.url

См. ActiveStorage::Blob::Representable#preview для получения дополнительной информации.

Вызывает ArgumentError если transformations является Symbol, который является неизвестным предварительно определенным вариантом прикрепления.

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

# File activestorage/app/models/active_storage/attachment.rb, line 51
def purge
  transaction do
    delete
    record.touch if record&.persisted?
  end
  blob&.purge
end

Синхронно удаляет прикрепление и удаляет блок.

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

# File activestorage/app/models/active_storage/attachment.rb, line 60
def purge_later
  transaction do
    delete
    record.touch if record&.persisted?
  end
  blob&.purge_later
end

Удаляет прикрепление и вызывает задачу фонового выполнения для удаления блока.

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

# File activestorage/app/models/active_storage/attachment.rb, line 25
belongs_to :record, polymorphic: true, touch: ActiveStorage.touch_attachment_records

Возвращает связанную запись.

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

# File activestorage/app/models/active_storage/attachment.rb, line 120
def representation(transformations)
  transformations = transformations_by_name(transformations)
  blob.representation(transformations)
end

Возвращает ActiveStorage::Preview или ActiveStorage::Variant для прикрепления с набором transformations. Пример:

avatar.representation(resize_to_limit: [100, 100]).processed.url

или, если вы используете предварительно определенные варианты:

avatar.representation(:thumb).processed.url

См. ActiveStorage::Blob::Representable#representation для получения дополнительной информации.

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

# File activestorage/app/models/active_storage/attachment.rb, line 82
def variant(transformations)
  transformations = transformations_by_name(transformations)
  blob.variant(transformations)
end

Возвращает экземпляр ActiveStorage::Variant или ActiveStorage::VariantWithRecord для прикрепления с набором transformations. Пример:

avatar.variant(resize_to_limit: [100, 100]).processed.url

или, если вы используете предварительно определенные варианты:

avatar.variant(:thumb).processed.url

См. ActiveStorage::Blob::Representable#variant для получения дополнительной информации.