Class: Hyrax::Actors::FileActor

Inherits:
Object
  • Object
show all
Defined in:
app/actors/hyrax/actors/file_actor.rb

Overview

Note:

Spawns asynchronous jobs

Actions for a file identified by file_set and relation (maps to use predicate)

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(file_set, relation, user) ⇒ FileActor

Returns a new instance of FileActor.

Parameters:

  • file_set (FileSet)

    the parent FileSet

  • relation (Symbol, #to_sym)

    the type/use for the file

  • user (User)

    the user to record as the Agent acting upon the file



13
14
15
16
17
# File 'app/actors/hyrax/actors/file_actor.rb', line 13

def initialize(file_set, relation, user)
  @file_set = file_set
  @relation = normalize_relation(relation)
  @user = user
end

Instance Attribute Details

#file_setObject (readonly)

Returns the value of attribute file_set.



8
9
10
# File 'app/actors/hyrax/actors/file_actor.rb', line 8

def file_set
  @file_set
end

#relationObject (readonly)

Returns the value of attribute relation.



8
9
10
# File 'app/actors/hyrax/actors/file_actor.rb', line 8

def relation
  @relation
end

#use_valkyrieObject (readonly)

Returns the value of attribute use_valkyrie.



8
9
10
# File 'app/actors/hyrax/actors/file_actor.rb', line 8

def use_valkyrie
  @use_valkyrie
end

#userObject (readonly)

Returns the value of attribute user.



8
9
10
# File 'app/actors/hyrax/actors/file_actor.rb', line 8

def user
  @user
end

Instance Method Details

#==(other) ⇒ Object

Note:

FileSet comparison is limited to IDs, but this should be sufficient, given that most operations here are on the other side of async retrieval in Jobs (based solely on ID).



49
50
51
52
# File 'app/actors/hyrax/actors/file_actor.rb', line 49

def ==(other)
  return false unless other.is_a?(self.class)
  file_set.id == other.file_set.id && relation == other.relation && user == other.user
end

#ingest_file(io) ⇒ CharacterizeJob, FalseClass

TODO:

create a job to monitor the temp directory (or in a multi-worker system, directories!) to prune old files that have made it into the repo

Note:

Instead of calling this method, use IngestJob to avoid synchronous execution cost

Persists file as part of file_set and spawns async job to characterize and create derivatives.

Parameters:

  • io (JobIoWrapper)

    the file to save in the repository, with mime_type and original_name

Returns:

  • (CharacterizeJob, FalseClass)

    spawned job on success, false on failure

See Also:



25
26
27
28
29
30
31
32
33
34
# File 'app/actors/hyrax/actors/file_actor.rb', line 25

def ingest_file(io)
  Hydra::Works::AddFileToFileSet.call(file_set,
                                      io,
                                      relation,
                                      versioning: false)
  return false unless file_set.save
  repository_file = related_file
  create_version(repository_file, user)
  CharacterizeJob.perform_later(file_set, repository_file.id, pathhint(io))
end

#revert_to(revision_id) ⇒ CharacterizeJob, FalseClass

Reverts file and spawns async job to characterize and create derivatives.

Parameters:

  • revision_id (String)

Returns:

  • (CharacterizeJob, FalseClass)

    spawned job on success, false on failure



39
40
41
42
43
44
45
# File 'app/actors/hyrax/actors/file_actor.rb', line 39

def revert_to(revision_id)
  repository_file = related_file
  repository_file.restore_version(revision_id)
  return false unless file_set.save
  create_version(repository_file, user)
  CharacterizeJob.perform_later(file_set, repository_file.id)
end