Class: S3::Object

Inherits:
Object
  • Object
show all
Extended by:
Forwardable
Includes:
Parser
Defined in:
lib/s3/object.rb

Overview

Class responsible for handling objects stored in S3 buckets

Instance Attribute Summary collapse

Instance Method Summary collapse

Methods included from Parser

#parse_copy_object_result, #parse_error, #parse_list_all_my_buckets_result, #parse_list_bucket_result, #parse_location_constraint, #rexml_document

Instance Attribute Details

#acl ⇒ Object

Returns the value of attribute acl.



9
10
11
 
# File 'lib/s3/object.rb', line 9

def acl
  @acl
end

#bucket ⇒ Object

Returns the value of attribute bucket.



9
10
11
 
# File 'lib/s3/object.rb', line 9

def bucket
  @bucket
end

#content(reload = false) ⇒ Object

Download the content of the object, and caches it. Pass true to clear the cache and download the object again.



75
76
77
78
79
80
 
# File 'lib/s3/object.rb', line 75

def content(reload = false)
  if reload or @content.nil?
    get_object
  end
  @content
end

#content_disposition ⇒ Object

Returns the value of attribute content_disposition.



8
9
10
 
# File 'lib/s3/object.rb', line 8

def content_disposition
  @content_disposition
end

#content_encoding ⇒ Object

Returns the value of attribute content_encoding.



8
9
10
 
# File 'lib/s3/object.rb', line 8

def content_encoding
  @content_encoding
end

#content_type ⇒ Object

Returns the value of attribute content_type.



8
9
10
 
# File 'lib/s3/object.rb', line 8

def content_type
  @content_type
end

#etag ⇒ Object

Returns the value of attribute etag.



9
10
11
 
# File 'lib/s3/object.rb', line 9

def etag
  @etag
end

#key ⇒ Object

Returns the value of attribute key.



9
10
11
 
# File 'lib/s3/object.rb', line 9

def key
  @key
end

#last_modified ⇒ Object

Returns the value of attribute last_modified.



9
10
11
 
# File 'lib/s3/object.rb', line 9

def last_modified
  @last_modified
end

#size ⇒ Object

Returns the value of attribute size.



9
10
11
 
# File 'lib/s3/object.rb', line 9

def size
  @size
end

#storage_class ⇒ Object

Returns the value of attribute storage_class.



9
10
11
 
# File 'lib/s3/object.rb', line 9

def storage_class
  @storage_class
end

Instance Method Details

#==(other) ⇒ Object

Compares the object with other object. Returns true if the key of the objects are the same, and both have the same buckets (see Bucket equality)



19
20
21
 
# File 'lib/s3/object.rb', line 19

def ==(other)
  other.equal?(self) || (other.instance_of?(self.class) && self.key == other.key && self.bucket == other.bucket)
end

#cname_url ⇒ Object

Returns Object’s CNAME URL (without s3.amazonaws.com suffix) using protocol specified in Service, e.g. http://domain.com/key/with/path.extension. (you have to set the CNAME in your DNS before using the CNAME URL schema).



130
131
132
 
# File 'lib/s3/object.rb', line 130

def cname_url
  URI.escape("#{protocol}#{name}/#{key}") if bucket.vhost?
end

#copy(options = {}) ⇒ Object

Copies the file to another key and/or bucket.

Options

  • :key - New key to store object in

  • :bucket - New bucket to store object in (instance of S3::Bucket)

  • :acl - ACL of the copied object (default: “public-read”)

  • :content_type - Content type of the copied object (default: “application/octet-stream”)



98
99
100
 
# File 'lib/s3/object.rb', line 98

def copy(options = {})
  copy_object(options)
end

#destroy ⇒ Object

Destroys the file on the server



103
104
105
106
 
# File 'lib/s3/object.rb', line 103

def destroy
  delete_object
  true
end

#exists? ⇒ Boolean

Retrieves the object from the server, returns true if the object exists or false otherwise. Uses #retrieve method, but catches S3::Error::NoSuchKey exception and returns false when it happens

Returns:

  • (Boolean) 


66
67
68
69
70
71
 
# File 'lib/s3/object.rb', line 66

def exists?
  retrieve
  true
rescue Error::NoSuchKey
  false
end

#full_key ⇒ Object

Returns full key of the object: e.g. bucket-name/object/key.ext



24
25
26
 
# File 'lib/s3/object.rb', line 24

def full_key
  [name, key].join("/")
end

#inspect ⇒ Object

:nodoc:



134
135
136
 
# File 'lib/s3/object.rb', line 134

def inspect #:nodoc:
  "#<#{self.class}:/#{name}/#{key}>"
end

#retrieve ⇒ Object

Retrieves the object from the server. Method is used to download object information only (content type, size and so on). It does NOT download the content of the object (use the #content method to do it).



58
59
60
61
 
# File 'lib/s3/object.rb', line 58

def retrieve
  object_headers
  self
end

#save ⇒ Object

Saves the object, returns true if successfull.



83
84
85
86
 
# File 'lib/s3/object.rb', line 83

def save
  put_object
  true
end

#temporary_url(expires_at = Time.now + 3600) ⇒ Object

Returns a temporary url to the object that expires on the timestamp given. Defaults to one hour expire time.



116
117
118
119
120
121
122
123
 
# File 'lib/s3/object.rb', line 116

def temporary_url(expires_at = Time.now + 3600)
  signature = Signature.generate_temporary_url_signature(:bucket => name,
                                                         :resource => key,
                                                         :expires_at => expires_at,
                                                         :secret_access_key => secret_access_key)

  "#{url}?AWSAccessKeyId=#{self.bucket.service.access_key_id}&Expires=#{expires_at.to_i.to_s}&Signature=#{signature}"
end

#url ⇒ Object

Returns Object’s URL using protocol specified in service, e.g. http://domain.com.s3.amazonaws.com/key/with/path.extension



110
111
112
 
# File 'lib/s3/object.rb', line 110

def url
  URI.escape("#{protocol}#{host}/#{path_prefix}#{key}")
end