Class: Valkyrie::StorageAdapter

Inherits:
Object
  • Object
show all
Defined in:
lib/valkyrie/storage_adapter.rb

Overview

StorageAdapter is the primary DataMapper object for binary content persistence.

Used to register and locate adapters for individual
storage backends (such as fedora, disk, etc)

Defined Under Namespace

Classes: File, FileNotFound, StreamFile

Class Method Summary collapse

Class Method Details

.adapter_for(id:) ⇒ Valkyrie::StorageAdapter

Return the registered storage adapter which handles the given ID.



56
57
58
59
60
61
 
# File 'lib/valkyrie/storage_adapter.rb', line 56

def adapter_for(id:)
  # TODO: Determine the appropriate response when we have an unhandled :id
  storage_adapters.values.find do |storage_adapter|
    storage_adapter.handles?(id: id)
  end
end

.delete(id:) ⇒ Object

Search through all registered storage adapters until it finds one that can handle the passed in identifier. Then call delete on that adapter with the given identifier.



49
50
51
 
# File 'lib/valkyrie/storage_adapter.rb', line 49

def delete(id:)
  adapter_for(id: id).delete(id: id)
end

.find(short_name) ⇒ Valkyrie::StorageAdapter

Find the adapter associated with the provided short name

Raises:

  • Valkyrie::StorageAdapter::AdapterNotFoundError when we are unable to find the named adapter



29
30
31
32
33
 
# File 'lib/valkyrie/storage_adapter.rb', line 29

def find(short_name)
  storage_adapters.fetch(short_name)
rescue KeyError
  raise "Unable to find #{self} with short_name of #{short_name.inspect}. Registered adapters are #{storage_adapters.keys.inspect}"
end

.find_by(id:) ⇒ Valkyrie::StorageAdapter::File

Search through all registered storage adapters until it finds one that can handle the passed in identifier. The call find_by on that adapter with the given identifier.

Raises:

  • Valkyrie::StorageAdapter::FileNotFound if nothing is found



41
42
43
 
# File 'lib/valkyrie/storage_adapter.rb', line 41

def find_by(id:)
  adapter_for(id: id).find_by(id: id)
end

.register(storage_adapter, short_name) ⇒ void

This method returns an undefined value.

Add a storage adapter to the registry under the provided short name



15
16
17
 
# File 'lib/valkyrie/storage_adapter.rb', line 15

def register(storage_adapter, short_name)
  storage_adapters[short_name] = storage_adapter
end

.unregister(short_name) ⇒ void 



21
22
23
 
# File 'lib/valkyrie/storage_adapter.rb', line 21

def unregister(short_name)
  storage_adapters.delete(short_name)
end