Class: Utopia::Static::LocalFile

Inherits:
Object
  • Object
show all
Defined in:
lib/utopia/static.rb

Overview

Represents a local file on disk which can be served directly, or passed upstream to sendfile.

Constant Summary collapse

CONTENT_LENGTH = 
Rack::CONTENT_LENGTH
CONTENT_RANGE = 
'Content-Range'.freeze

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(root, path) ⇒ LocalFile

Returns a new instance of LocalFile.



124
125
126
127
128
129
130
 
# File 'lib/utopia/static.rb', line 124

def initialize(root, path)
  @root = root
  @path = path
  @etag = Digest::SHA1.hexdigest("#{File.size(full_path)}#{mtime_date}")

  @range = nil
end

Instance Attribute Details

#etag ⇒ Object (readonly)

Returns the value of attribute etag.



134
135
136
 
# File 'lib/utopia/static.rb', line 134

def etag
  @etag
end

#path ⇒ Object (readonly)

Returns the value of attribute path.



133
134
135
 
# File 'lib/utopia/static.rb', line 133

def path
  @path
end

#range ⇒ Object (readonly)

Returns the value of attribute range.



135
136
137
 
# File 'lib/utopia/static.rb', line 135

def range
  @range
end

#root ⇒ Object (readonly)

Returns the value of attribute root.



132
133
134
 
# File 'lib/utopia/static.rb', line 132

def root
  @root
end

Instance Method Details

#bytesize ⇒ Object Also known as: size 



150
151
152
 
# File 'lib/utopia/static.rb', line 150

def bytesize
  File.size(full_path)
end

#each ⇒ Object 



161
162
163
164
165
166
167
168
169
170
171
172
173
174
 
# File 'lib/utopia/static.rb', line 161

def each
  File.open(full_path, "rb") do |file|
    file.seek(@range.begin)
    remaining = @range.end - @range.begin+1

    while remaining > 0
      break unless part = file.read([8192, remaining].min)

      remaining -= part.length

      yield part
    end
  end
end

#empty? ⇒ Boolean

This reflects whether calling each would yield anything.

Returns:

  • (Boolean) 


155
156
157
 
# File 'lib/utopia/static.rb', line 155

def empty?
  bytesize == 0
end

#full_path ⇒ Object 



142
143
144
 
# File 'lib/utopia/static.rb', line 142

def full_path
  File.join(@root, @path.components)
end

#modified?(env) ⇒ Boolean

Returns:

  • (Boolean) 


176
177
178
179
180
181
182
183
184
185
186
187
 
# File 'lib/utopia/static.rb', line 176

def modified?(env)
  if modified_since = env['HTTP_IF_MODIFIED_SINCE']
    return false if File.mtime(full_path) <= Time.parse(modified_since)
  end

  if etags = env['HTTP_IF_NONE_MATCH']
    etags = etags.split(/\s*,\s*/)
    return false if etags.include?(etag) || etags.include?('*')
  end

  return true
end

#mtime_date ⇒ Object 



146
147
148
 
# File 'lib/utopia/static.rb', line 146

def mtime_date
  File.mtime(full_path).httpdate
end

#serve(env, response_headers) ⇒ Object 



192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
 
# File 'lib/utopia/static.rb', line 192

def serve(env, response_headers)
  ranges = Rack::Utils.get_byte_ranges(env['HTTP_RANGE'], size)
  response = [200, response_headers, self]

  # puts "Requesting ranges: #{ranges.inspect} (#{size})"

  if ranges == nil or ranges.size != 1
    # No ranges, or multiple ranges (which we don't support).
    # TODO: Support multiple byte-ranges, for now just send entire file:
    response[0] = 200
    response[1][CONTENT_LENGTH] = size.to_s
    @range = 0...size
  else
    # Partial content:
    @range = ranges[0]
    partial_size = @range.count
    
    response[0] = 206
    response[1][CONTENT_LENGTH] = partial_size.to_s
    response[1][CONTENT_RANGE] = "bytes #{@range.min}-#{@range.max}/#{size}"
  end
  
  return response
end

#to_path ⇒ Object

Fit in with Rack::Sendfile



138
139
140
 
# File 'lib/utopia/static.rb', line 138

def to_path
  full_path
end