class ActiveStorage::Service::MirrorService

Parent:: ActiveStorage::Service

Active Storage Mirror Service

Wraps a set of mirror services and provides a single ActiveStorage::Service object that will all have the files uploaded to them. A primary service is designated to answer calls to:

download
exists?
url
url_for_direct_upload
headers_for_direct_upload

Атрибуты

mirrors[R]

primary[R]

Открытые методы класса

new(primary:, mirrors:) Показать исходный код

# File activestorage/lib/active_storage/service/mirror_service.rb, line 31
def initialize(primary:, mirrors:)
  @primary, @mirrors = primary, mirrors
end

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

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

# File activestorage/lib/active_storage/service/mirror_service.rb, line 45
def delete(key)
  perform_across_services :delete, key
end

Удалить файл по ключу key на всех сервисах.

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

# File activestorage/lib/active_storage/service/mirror_service.rb, line 50
def delete_prefixed(prefix)
  perform_across_services :delete_prefixed, prefix
end

Удалить файлы по ключам, начинающимся с prefix, на всех сервисах.

mirror(key, checksum:) Показать исходный код

# File activestorage/lib/active_storage/service/mirror_service.rb, line 59
def mirror(key, checksum:)
  instrument :mirror, key: key, checksum: checksum do
    if (mirrors_in_need_of_mirroring = mirrors.select { |service| !service.exist?(key) }).any?
      primary.open(key, checksum: checksum) do |io|
        mirrors_in_need_of_mirroring.each do |service|
          io.rewind
          service.upload key, io, checksum: checksum
        end
      end
    end
  end
end

Скопировать файл по ключу key с основного сервиса на каждый из зеркальных сервисов, если он там ещё не существует.

upload(key, io, checksum: nil, **options) Показать исходный код

# File activestorage/lib/active_storage/service/mirror_service.rb, line 38
def upload(key, io, checksum: nil, **options)
  io.rewind
  primary.upload key, io, checksum: checksum, **options
  mirror_later key, checksum: checksum
end

Загрузить io на key все сервисы. Загрузка на основной сервис выполняется синхронно, а на зеркальные — асинхронно. Если предоставлен checksum, все сервисы гарантируют соответствие при завершении загрузки или выбросят исключение ActiveStorage::IntegrityError.