Active Storage 磁盘服务
将本地磁盘路径包装成 Active Storage 服务。有关适用于所有服务的通用 API 文档,请参见 ActiveStorage::Service
。
方法
- C
- D
- E
- H
- N
- U
属性
[读写] | root |
类公共方法
new(root:, public: false, **options) 链接
源代码:显示 | 在 GitHub 上
# File activestorage/lib/active_storage/service/disk_service.rb, line 16 def initialize(root:, public: false, **options) @root = root @public = public end
实例公共方法
compose(source_keys, destination_key, **) 链接
源代码:显示 | 在 GitHub 上
# File activestorage/lib/active_storage/service/disk_service.rb, line 105 def compose(source_keys, destination_key, **) File.open(make_path_for(destination_key), "w") do |destination_file| source_keys.each do |source_key| File.open(path_for(source_key), "rb") do |source_file| IO.copy_stream(source_file, destination_file) end end end end
delete(key) 链接
源代码:显示 | 在 GitHub 上
# File activestorage/lib/active_storage/service/disk_service.rb, line 53 def delete(key) instrument :delete, key: key do File.delete path_for(key) rescue Errno::ENOENT # Ignore files already deleted end end
delete_prefixed(prefix) 链接
源代码:显示 | 在 GitHub 上
# File activestorage/lib/active_storage/service/disk_service.rb, line 61 def delete_prefixed(prefix) instrument :delete_prefixed, prefix: prefix do Dir.glob(path_for("#{prefix}*")).each do |path| FileUtils.rm_rf(path) end end end
download(key, &block) 链接
源代码:显示 | 在 GitHub 上
# File activestorage/lib/active_storage/service/disk_service.rb, line 28 def download(key, &block) if block_given? instrument :streaming_download, key: key do stream key, &block end else instrument :download, key: key do File.binread path_for(key) rescue Errno::ENOENT raise ActiveStorage::FileNotFoundError end end end
download_chunk(key, range) 链接
源代码:显示 | 在 GitHub 上
# File activestorage/lib/active_storage/service/disk_service.rb, line 42 def download_chunk(key, range) instrument :download_chunk, key: key, range: range do File.open(path_for(key), "rb") do |file| file.seek range.begin file.read range.size end rescue Errno::ENOENT raise ActiveStorage::FileNotFoundError end end
exist?(key) 链接
源代码:显示 | 在 GitHub 上
# File activestorage/lib/active_storage/service/disk_service.rb, line 69 def exist?(key) instrument :exist, key: key do |payload| answer = File.exist? path_for(key) payload[:exist] = answer answer end end
headers_for_direct_upload(key, content_type:, **) 链接
源代码:显示 | 在 GitHub 上
# File activestorage/lib/active_storage/service/disk_service.rb, line 97 def headers_for_direct_upload(key, content_type:, **) { "Content-Type" => content_type } end
upload(key, io, checksum: nil, **) 链接
源代码:显示 | 在 GitHub 上
# File activestorage/lib/active_storage/service/disk_service.rb, line 21 def upload(key, io, checksum: nil, **) instrument :upload, key: key, checksum: checksum do IO.copy_stream(io, make_path_for(key)) ensure_integrity_of(key, checksum) if checksum end end
url_for_direct_upload(key, expires_in:, content_type:, content_length:, checksum:, custom_metadata: {}) 链接
源代码:显示 | 在 GitHub 上
# File activestorage/lib/active_storage/service/disk_service.rb, line 77 def url_for_direct_upload(key, expires_in:, content_type:, content_length:, checksum:, custom_metadata: {}) instrument :url, key: key do |payload| verified_token_with_expiration = ActiveStorage.verifier.generate( { key: key, content_type: content_type, content_length: content_length, checksum: checksum, service_name: name }, expires_in: expires_in, purpose: :blob_token ) url_helpers.update_rails_disk_service_url(verified_token_with_expiration, url_options).tap do |generated_url| payload[:url] = generated_url end end end