Class: Fog::AWS::Storage::File

Inherits:
Model
  • Object
show all
Defined in:
lib/fog/aws/models/storage/file.rb

Instance Attribute Summary collapse

Attributes inherited from Model

#collection, #connection

Instance Method Summary collapse

Methods inherited from Model

#initialize, #inspect, #reload, #to_json, #wait_for

Methods included from Fog::Attributes::ClassMethods

#_load, #aliases, #attribute, #attributes, #identity, #ignore_attributes, #ignored_attributes

Methods included from Fog::Attributes::InstanceMethods

#_dump, #attributes, #identity, #identity=, #merge_attributes, #new_record?, #requires

Constructor Details

This class inherits a constructor from Fog::Model

Instance Attribute Details

#body ⇒ Object 



28
29
30
31
32
33
34
 
# File 'lib/fog/aws/models/storage/file.rb', line 28

def body
  @body ||= if last_modified && (file = collection.get(identity))
    file.body
  else
    ''
  end
end

Instance Method Details

#acl=(new_acl) ⇒ Object 



20
21
22
23
24
25
26
 
# File 'lib/fog/aws/models/storage/file.rb', line 20

def acl=(new_acl)
  valid_acls = ['private', 'public-read', 'public-read-write', 'authenticated-read']
  unless valid_acls.include?(new_acl)
    raise ArgumentError.new("acl must be one of [#{valid_acls.join(', ')}]")
  end
  @acl = new_acl
end

#copy(target_directory_key, target_file_key) ⇒ Object 



40
41
42
43
44
45
 
# File 'lib/fog/aws/models/storage/file.rb', line 40

def copy(target_directory_key, target_file_key)
  requires :directory, :key
  connection.copy_object(directory.key, @key, target_directory_key, target_file_key)
  target_directory = connection.directories.new(:key => target_directory_key)
  target_directory.files.get(target_file_key)
end

#destroy ⇒ Object 



47
48
49
50
51
 
# File 'lib/fog/aws/models/storage/file.rb', line 47

def destroy
  requires :directory, :key
  connection.delete_object(directory.key, @key)
  true
end

#directory ⇒ Object 



36
37
38
 
# File 'lib/fog/aws/models/storage/file.rb', line 36

def directory
  @directory
end

#owner=(new_owner) ⇒ Object 



54
55
56
57
58
59
60
61
 
# File 'lib/fog/aws/models/storage/file.rb', line 54

def owner=(new_owner)
  if new_owner
    @owner = {
      :display_name => new_owner['DisplayName'],
      :id           => new_owner['ID']
    }
  end
end

#public_url ⇒ Object 



63
64
65
66
67
68
69
70
71
72
73
74
75
76
 
# File 'lib/fog/aws/models/storage/file.rb', line 63

def public_url
  requires :directory, :key
  if directory.public_url
    "#{directory.public_url}/#{key}"
  elsif connection.get_object_acl(directory.key, key).body['AccessControlList'].detect {|grant| grant['Grantee']['URI'] == 'http://acs.amazonaws.com/groups/global/AllUsers' && grant['Permission'] == 'READ'}
    if directory.key.to_s =~ /^(?:[a-z]|\d(?!\d{0,2}(?:\.\d{1,3}){3}$))(?:[a-z0-9]|\.(?![\.\-])|\-(?![\.])){1,61}[a-z0-9]$/
      "https://#{directory.key}.s3.amazonaws.com/#{key}"
    else
      "https://s3.amazonaws.com/#{directory.key}/#{key}"
    end
  else
    nil
  end
end

#save(options = {}) ⇒ Object 



78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
 
# File 'lib/fog/aws/models/storage/file.rb', line 78

def save(options = {})
  requires :body, :directory, :key
  if options != {}
    Formatador.display_line("[yellow][WARN] options param is deprecated, use acl= instead[/] [light_black](#{caller.first})[/]")
  end
  if @acl
    options['x-amz-acl'] ||= @acl
  end
  if content_type
    options['Content-Type'] = content_type
  end
  data = connection.put_object(directory.key, @key, @body, options)
  @etag = data.headers['ETag']
  true
end

#url(expires) ⇒ Object 



94
95
96
97
 
# File 'lib/fog/aws/models/storage/file.rb', line 94

def url(expires)
  requires :key
  collection.get_url(key, expires)
end