.gitignore CONTRIBUTING TODO assets/book.css book-order.txt book/.gitignore book/Configuration.markdown book/Contributing.markdown book/Deployment.markdown book/ErrorHandling.markdown book/Filters.markdown book/Handlers.markdown book/Helpers.markdown book/Introduction.markdown book/Models.markdown @@ -1,8 +1,30 @@ Rack Middleware =============== -"use" ------ +Sinatra rides on [Rack][rack], a minimal standard interface for Ruby web frameworks. One of Rack’s most interesting capabilities for application developers is support for “middleware” — components that sit between the server and your application monitoring and/or manipulating the HTTP request/response to provide various types of common functionality. -// TODO: What useful rack middleware is out there? Is there any 3rd party stuff available outside of the builtin ones? +Sinatra makes building Rack middleware pipelines a cinch via a top-level "use" method: + + require 'sinatra' + require 'my_custom_middleware' + + use Rack::Lint + use MyCustomMiddleware + + get '/hello' do + 'Hello World' + end + + +The semantics of "use" are identical to those defined for the [Rack::Builder][rack_builder] DSL (most frequently used from rackup files). For example, the use method accepts multiple/variable args as well as blocks: + + use Rack::Auth::Basic do |username, password| + username == 'admin' && password == 'secret' + end + + +Rack is distributed with a variety of standard middleware for logging, debugging, URL routing, authentication, and session handling. Sinatra uses many of of these components automatically based on configuration so you typically don’t have to use them explicitly. + +[rack]: http://rack.rubyforge.org/ +[rack_builder]: http://rack.rubyforge.org/doc/classes/Rack/Builder.html book/RackMiddleware.markdown book/Routes.markdown book/TOC.markdown book/Views.markdown images/.gitignore sinatra-book.thor source/.gitignore 94751c02e682085b8d22beb081662b5f06bb1af9 root taylorrf@gmail.com http://github.com/cschneid/sinatra-book/commit/afb57f831877f7113acd5690a8e059c89c49df8b afb57f831877f7113acd5690a8e059c89c49df8b 2008-12-28T08:05:37-08:00 2008-12-27T20:02:22-08:00 add content for RackMiddleware Signed-off-by: Chris Schneider <chris@christopher-schneider.com> 0b05d5fb34f85439928e3707bff6b66274563965 Chris Schneider chris@christopher-schneider.com