Class: ActionDispatch::Static

Inherits:
Object
  • Object
show all
Defined in:
actionpack/lib/action_dispatch/middleware/static.rb

Overview

This middleware will attempt to return the contents of a file's body from disk in the response. If a file is not found on disk, the request will be delegated to the application stack. This middleware is commonly initialized to serve assets from a server's `public/` directory.

This middleware verifies the path to ensure that only files living in the root directory can be rendered. A request cannot produce a directory traversal using this middleware. Only 'GET' and 'HEAD' requests will result in a file being returned.

Instance Method Summary collapse

Constructor Details

#initialize(app, path, cache_control = nil) ⇒ Static

Returns a new instance of Static.


105
106
107
108
# File 'actionpack/lib/action_dispatch/middleware/static.rb', line 105

def initialize(app, path, cache_control=nil)
  @app = app
  @file_handler = FileHandler.new(path, cache_control)
end

Instance Method Details

#call(env) ⇒ Object


110
111
112
113
114
115
116
117
118
119
120
121
# File 'actionpack/lib/action_dispatch/middleware/static.rb', line 110

def call(env)
  case env['REQUEST_METHOD']
  when 'GET', 'HEAD'
    path = env['PATH_INFO'].chomp('/')
    if match = @file_handler.match?(path)
      env["PATH_INFO"] = match
      return @file_handler.call(env)
    end
  end

  @app.call(env)
end