# Sinatra *注:本文档是英文版的翻译,内容更新有可能不及时。 如有不一致的地方,请以英文版为准。* Sinatra是一个基于Ruby语言的[DSL](http://en.wikipedia.org/wiki/Domain-specific_language)( 领域专属语言),可以轻松、快速的创建web应用。 ~~~~ruby # myapp.rb require 'sinatra' get '/' do 'Hello world!' end ~~~~ 安装gem,然后运行: ~~~~shell gem install sinatra ruby myapp.rb ~~~~ 在该地址查看: http://localhost:4567 这个时候访问地址将绑定到 127.0.0.1 和 localhost ,如果使用 vagrant 进行开发,访问会失败,此时就需要进行 ip 绑定了: ~~~~shell ruby myapp.rb -o 0.0.0.0 ~~~~ ```-o``` 这个参数就是进行 Listening 时候监听的绑定,能从通过 IP、127.0.0.1、localhost + 端口号进行访问。 安装Sintra后,最好再运行`gem install thin`安装Thin。这样,Sinatra会优先选择Thin作为服务器。 ## 路由(route) 在Sinatra中,一个路由分为两部分:HTTP方法(GET, POST等)和URL匹配范式。 每个路由都有一个要执行的代码块: ~~~~ruby get '/' do .. 显示内容 .. end post '/' do .. 创建内容 .. end put '/' do .. 更新内容 .. end delete '/' do .. 删除内容 .. end options '/' do .. 显示命令列表 .. end link '/' do .. 建立某种联系 .. end unlink '/' do .. 解除某种联系 .. end ~~~~ 路由按照它们被定义的顺序进行匹配。 第一个与请求匹配的路由会被调用。 路由范式可以包括具名参数,可通过`params`哈希表获得: ~~~~ruby get '/hello/:name' do # 匹配 "GET /hello/foo" 和 "GET /hello/bar" # params['name'] 的值是 'foo' 或者 'bar' "Hello #{params['name']}!" end ~~~~ 你同样可以通过代码块参数获得具名参数: ~~~~ruby get '/hello/:name' do |n| "Hello #{n}!" end ~~~~ 路由范式也可以包含通配符参数, 可以通过`params['splat']`数组获得。 ~~~~ruby get '/say/*/to/*' do # 匹配 /say/hello/to/world params['splat'] # => ["hello", "world"] end get '/download/*.*' do # 匹配 /download/path/to/file.xml params['splat'] # => ["path/to/file", "xml"] end ~~~~ 通过正则表达式匹配的路由: ~~~~ruby get /\A\/hello\/([\w]+)\z/ do "Hello, #{params['captures'].first}!" end ~~~~ 或者使用代码块参数: ~~~~ruby get %r{/hello/([\w]+)} do |c| "Hello, #{c}!" end ~~~~ ### 条件 路由也可以包含多样的匹配条件,比如user agent: ~~~~ruby get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do "你正在使用Songbird,版本是 #{params['agent'][0]}" end get '/foo' do # 匹配除Songbird以外的浏览器 end ~~~~ 其他可选的条件是 `host_name` 和 `provides`: ~~~~ruby get '/', :host_name => /^admin\./ do "管理员区域,无权进入!" end get '/', :provides => 'html' do haml :index end get '/', :provides => ['rss', 'atom', 'xml'] do builder :feed end ~~~~ 你也可以自定义条件: ~~~~ruby set(:probability) { |value| condition { rand <= value } } get '/win_a_car', :probability => 0.1 do "You won!" end get '/win_a_car' do "Sorry, you lost." end ~~~~ ### 返回值 路由代码块的返回值至少决定了返回给HTTP客户端的响应体, 或者至少决定了在Rack堆栈中的下一个中间件。 大多数情况下,将是一个字符串,就像上面的例子中的一样。 但是其他值也是可以接受的。 你可以返回任何对象,或者是一个合理的Rack响应, Rack body对象或者HTTP状态码: - 一个包含三个元素的数组: `[状态 (Fixnum), 头 (Hash), 响应体 (回应 #each)]` - 一个包含两个元素的数组: `[状态 (Fixnum), 响应体 (回应 #each)]` - 一个能够回应 `#each` ,只传回字符串的对象 - 一个代表状态码的数字 那样,我们可以轻松的实现例如流式传输的例子: ~~~~ruby class Stream def each 100.times { |i| yield "#{i}\n" } end end get('/') { Stream.new } ~~~~ ### 自定义路由匹配器 如上显示,Sinatra内置了对于使用字符串和正则表达式作为路由匹配的支持。 但是,它并没有只限于此。 你可以非常容易地定义你自己的匹配器: ~~~~ruby class AllButPattern Match = Struct.new(:captures) def initialize(except) @except = except @captures = Match.new([]) end def match(str) @captures unless @except === str end end def all_but(pattern) AllButPattern.new(pattern) end get all_but("/index") do # ... end ~~~~ 上面的例子可能太繁琐了, 因为它也可以用更简单的方式表述: ~~~~ruby get // do pass if request.path_info == "/index" # ... end ~~~~ 或者,使用消极向前查找: ~~~~ruby get %r{^(?!/index$)} do # ... end ~~~~ ## 静态文件 静态文件是从 `./public_folder` 目录提供服务。你可以通过设置`:public` 选项设定一个不同的位置: ~~~~ruby set :public_folder, File.dirname(__FILE__) + '/static' ~~~~ 请注意public目录名并没有被包含在URL之中。文件 `./public/css/style.css`是通过 `http://example.com/css/style.css`地址访问的。 ## 视图 / 模板 模板被假定直接位于`./views`目录。 要使用不同的视图目录: ~~~~ruby set :views, File.dirname(__FILE__) + '/templates' ~~~~ 重要提示:你只可以通过符号引用模板, 即使它们在子目录下 (在这种情况下,使用 `:'subdir/template'`)。 如果你不用符号、而用字符串的话, 填充方法会只把你传入的字符串当成内容显示出来,而不调用模板。 ### Haml模板 需要引入 `haml` gem/library以填充 HAML 模板: ~~~~ruby # 你需要在你的应用中引入 haml require 'haml' get '/' do haml :index end ~~~~ 填充 `./views/index.haml`。 [Haml的选项](http://haml.info/docs/yardoc/file.HAML_REFERENCE.html#options) 可以通过Sinatra的配置全局设定, 参见 [选项和配置](http://www.sinatrarb.com/configuration.html), 也可以个别的被覆盖。 ~~~~ruby set :haml, {:format => :html5 } # 默认的Haml输出格式是 :xhtml get '/' do haml :index, :haml_options => {:format => :html4 } # 被覆盖,变成:html4 end ~~~~ ### Erb模板 ~~~~ruby # 你需要在你的应用中引入 erb require 'erb' get '/' do erb :index end ~~~~ 这里调用的是 `./views/index.erb` ### Erubis 需要引入 `erubis` gem/library以填充 erubis 模板: ~~~~ruby # 你需要在你的应用中引入 erubis require 'erubis' get '/' do erubis :index end ~~~~ 这里调用的是 `./views/index.erubis` 使用Erubis代替Erb也是可能的: ~~~~ruby require 'erubis' Tilt.register :erb, Tilt[:erubis] get '/' do erb :index end ~~~~ 使用Erubis来填充 `./views/index.erb`。 ### Builder 模板 需要引入 `builder` gem/library 以填充 builder templates: ~~~~ruby # 需要在你的应用中引入builder require 'builder' get '/' do builder :index end ~~~~ 这里调用的是 `./views/index.builder`。 ### Nokogiri 模板 需要引入 `nokogiri` gem/library 以填充 nokogiri 模板: ~~~~ruby # 需要在你的应用中引入 nokogiri require 'nokogiri' get '/' do nokogiri :index end ~~~~ 这里调用的是 `./views/index.nokogiri`。 ### Sass 模板 需要引入 `haml` 或者 `sass` gem/library 以填充 Sass 模板: ~~~~ruby # 需要在你的应用中引入 haml 或者 sass require 'sass' get '/stylesheet.css' do sass :stylesheet end ~~~~ 这里调用的是 `./views/stylesheet.sass`。 [Sass 的选项](http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options) 可以通过Sinatra选项全局设定, 参考 [选项和配置(英文)](http://www.sinatrarb.com/configuration.html), 也可以在个体的基础上覆盖。 ~~~~ruby set :sass, {:style => :compact } # 默认的 Sass 样式是 :nested get '/stylesheet.css' do sass :stylesheet, :style => :expanded # 覆盖 end ~~~~ ### Scss 模板 需要引入 `haml` 或者 `sass` gem/library 来填充 Scss templates: ~~~~ruby # 需要在你的应用中引入 haml 或者 sass require 'sass' get '/stylesheet.css' do scss :stylesheet end ~~~~ 这里调用的是 `./views/stylesheet.scss`。 [Scss的选项](http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options) 可以通过Sinatra选项全局设定, 参考 [选项和配置(英文)](http://www.sinatrarb.com/configuration.html), 也可以在个体的基础上覆盖。 ~~~~ruby set :scss, :style => :compact # default Scss style is :nested get '/stylesheet.css' do scss :stylesheet, :style => :expanded # overridden end ~~~~ ### Less 模板 需要引入 `less` gem/library 以填充 Less 模板: ~~~~ruby # 需要在你的应用中引入 less require 'less' get '/stylesheet.css' do less :stylesheet end ~~~~ 这里调用的是 `./views/stylesheet.less`。 ### Liquid 模板 需要引入 `liquid` gem/library 来填充 Liquid 模板: ~~~~ruby # 需要在你的应用中引入 liquid require 'liquid' get '/' do liquid :index end ~~~~ 这里调用的是 `./views/index.liquid`。 因为你不能在Liquid 模板中调用 Ruby 方法 (除了 `yield`) , 你几乎总是需要传递locals给它: ~~~~ruby liquid :index, :locals => { :key => 'value' } ~~~~ ### Markdown 模板 需要引入 `rdiscount` gem/library 以填充 Markdown 模板: ~~~~ruby # 需要在你的应用中引入rdiscount require "rdiscount" get '/' do markdown :index end ~~~~ 这里调用的是 `./views/index.markdown` (`md` 和 `mkd` 也是合理的文件扩展名)。 在markdown中是不可以调用方法的,也不可以传递 locals给它。 你因此一般会结合其他的填充引擎来使用它: ~~~~ruby erb :overview, :locals => { :text => markdown(:introduction) } ~~~~ 请注意你也可以从其他模板中调用 markdown 方法: ~~~~ruby %h1 Hello From Haml! %p= markdown(:greetings) ~~~~ 既然你不能在Markdown中调用Ruby,你不能使用Markdown编写的布局。 不过,使用其他填充引擎作为模版的布局是可能的, 通过传递`:layout_engine`选项: ~~~~ruby get '/' do markdown :index, :layout_engine => :erb end ~~~~ 这将会调用 `./views/index.md` 并使用 `./views/layout.erb` 作为布局。 请记住你可以全局设定这个选项: ~~~~ruby set :markdown, :layout_engine => :haml, :layout => :post get '/' do markdown :index end ~~~~ 这将会调用 `./views/index.markdown` (和任何其他的 Markdown 模版) 并使用 `./views/post.haml` 作为布局. 也可能使用BlueCloth而不是RDiscount来解析Markdown文件: ~~~~ruby require 'bluecloth' Tilt.register 'markdown', BlueClothTemplate Tilt.register 'mkd', BlueClothTemplate Tilt.register 'md', BlueClothTemplate get '/' do markdown :index end ~~~~ 使用BlueCloth来填充 `./views/index.md` 。 ### Textile 模板 需要引入 `RedCloth` gem/library 以填充 Textile 模板: ~~~~ruby # 在你的应用中引入redcloth require "redcloth" get '/' do textile :index end ~~~~ 这里调用的是 `./views/index.textile`。 在textile中是不可以调用方法的,也不可以传递 locals给它。 你因此一般会结合其他的填充引擎来使用它: ~~~~ruby erb :overview, :locals => { :text => textile(:introduction) } ~~~~ 请注意你也可以从其他模板中调用`textile`方法: ~~~~ruby %h1 Hello From Haml! %p= textile(:greetings) ~~~~ 既然你不能在Textile中调用Ruby,你不能使用Textile编写的布局。 不过,使用其他填充引擎作为模版的布局是可能的, 通过传递`:layout_engine`选项: ~~~~ruby get '/' do textile :index, :layout_engine => :erb end ~~~~ 这将会填充 `./views/index.textile` 并使用 `./views/layout.erb` 作为布局。 请记住你可以全局设定这个选项: ~~~~ruby set :textile, :layout_engine => :haml, :layout => :post get '/' do textile :index end ~~~~ 这将会调用 `./views/index.textile` (和任何其他的 Textile 模版) 并使用 `./views/post.haml` 作为布局. ### RDoc 模板 需要引入 `RDoc` gem/library 以填充RDoc模板: ~~~~ruby # 需要在你的应用中引入rdoc/markup/to_html require "rdoc" require "rdoc/markup/to_html" get '/' do rdoc :index end ~~~~ 这里调用的是 `./views/index.rdoc`。 在rdoc中是不可以调用方法的,也不可以传递locals给它。 你因此一般会结合其他的填充引擎来使用它: ~~~~ruby erb :overview, :locals => { :text => rdoc(:introduction) } ~~~~ 请注意你也可以从其他模板中调用`rdoc`方法: ~~~~ruby %h1 Hello From Haml! %p= rdoc(:greetings) ~~~~ 既然你不能在RDoc中调用Ruby,你不能使用RDoc编写的布局。 不过,使用其他填充引擎作为模版的布局是可能的, 通过传递`:layout_engine`选项: ~~~~ruby get '/' do rdoc :index, :layout_engine => :erb end ~~~~ 这将会调用 `./views/index.rdoc` 并使用 `./views/layout.erb` 作为布局。 请记住你可以全局设定这个选项: ~~~~ruby set :rdoc, :layout_engine => :haml, :layout => :post get '/' do rdoc :index end ~~~~ 这将会调用 `./views/index.rdoc` (和任何其他的 RDoc 模版) 并使用 `./views/post.haml` 作为布局. ### Radius 模板 需要引入 `radius` gem/library 以填充 Radius 模板: ~~~~ruby # 需要在你的应用中引入radius require 'radius' get '/' do radius :index end ~~~~ 这里调用的是 `./views/index.radius`。 因为你不能在Radius 模板中调用 Ruby 方法 (除了 `yield`) , 你几乎总是需要传递locals给它: ~~~~ruby radius :index, :locals => { :key => 'value' } ~~~~ ### Markaby 模板 需要引入`markaby` gem/library以填充Markaby模板: ~~~~ruby #需要在你的应用中引入 markaby require 'markaby' get '/' do markaby :index end ~~~~ 这里调用的是 `./views/index.mab`。 你也可以使用嵌入的 Markaby: ~~~~ruby get '/' do markaby { h1 "Welcome!" } end ~~~~ ### Slim 模板 需要引入 `slim` gem/library 来填充 Slim 模板: ~~~~ruby # 需要在你的应用中引入 slim require 'slim' get '/' do slim :index end ~~~~ 这里调用的是 `./views/index.slim`。 ### Creole 模板 需要引入 `creole` gem/library 来填充 Creole 模板: ~~~~ruby # 需要在你的应用中引入 creole require 'creole' get '/' do creole :index end ~~~~ 这里调用的是 `./views/index.creole`。 ### CoffeeScript 模板 需要引入 `coffee-script` gem/library 并至少满足下面条件一项 以执行Javascript: - `node` (来自 Node.js) 在你的路径中 - 你正在运行 OSX - `therubyracer` gem/library 请察看 [github.com/josh/ruby-coffee-script](http://github.com/josh/ruby-coffee-script) 获取更新的选项。 现在你可以调用 CoffeeScript 模版了: ~~~~ruby # 需要在你的应用中引入coffee-script require 'coffee-script' get '/application.js' do coffee :application end ~~~~ 这里调用的是 `./views/application.coffee`。 ### 嵌入模板字符串 ~~~~ruby get '/' do haml '%div.title Hello World' end ~~~~ 调用嵌入模板字符串。 ### 在模板中访问变量 模板和路由执行器在同样的上下文求值。 在路由执行器中赋值的实例变量可以直接被模板访问。 ~~~~ruby get '/:id' do @foo = Foo.find(params['id']) haml '%h1= @foo.name' end ~~~~ 或者,显式地指定一个本地变量的哈希: ~~~~ruby get '/:id' do foo = Foo.find(params['id']) haml '%h1= foo.name', :locals => { :foo => foo } end ~~~~ 典型的使用情况是在别的模板中按照局部模板的方式来填充。 ### 内联模板 模板可以在源文件的末尾定义: ~~~~ruby require 'sinatra' get '/' do haml :index end __END__ @@ layout %html = yield @@ index %div.title Hello world!!!!! ~~~~ 注意:引入sinatra的源文件中定义的内联模板才能被自动载入。 如果你在其他源文件中有内联模板, 需要显式执行调用`enable :inline_templates`。 ### 具名模板 模板可以通过使用顶层 `template` 方法定义: ~~~~ruby template :layout do "%html\n =yield\n" end template :index do '%div.title Hello World!' end get '/' do haml :index end ~~~~ 如果存在名为“layout”的模板,该模板会在每个模板填充的时候被使用。 你可以单独地通过传送 `:layout => false`来禁用, 或者通过`set :haml, :layout => false`来禁用他们。 ~~~~ruby get '/' do haml :index, :layout => !request.xhr? end ~~~~ ### 关联文件扩展名 为了关联一个文件扩展名到一个模版引擎,使用 `Tilt.register`。比如,如果你喜欢使用 `tt` 作为Textile模版的扩展名,你可以这样做: ~~~~ruby Tilt.register :tt, Tilt[:textile] ~~~~ ### 添加你自己的模版引擎 首先,通过Tilt注册你自己的引擎,然后创建一个填充方法: ~~~~ruby Tilt.register :myat, MyAwesomeTemplateEngine helpers do def myat(*args) render(:myat, *args) end end get '/' do myat :index end ~~~~ 这里调用的是 `./views/index.myat`。察看 [github.com/rtomayko/tilt](https://github.com/rtomayko/tilt) 来更多了解Tilt. ## 过滤器 前置过滤器在每个请求前,在请求的上下文环境中被执行, 而且可以修改请求和响应。 在过滤器中设定的实例变量可以被路由和模板访问: ~~~~ruby before do @note = 'Hi!' request.path_info = '/foo/bar/baz' end get '/foo/*' do @note #=> 'Hi!' params['splat'] #=> 'bar/baz' end ~~~~ 后置过滤器在每个请求之后,在请求的上下文环境中执行, 而且可以修改请求和响应。 在前置过滤器和路由中设定的实例变量可以被后置过滤器访问: ~~~~ruby after do puts response.status end ~~~~ 请注意:除非你显式使用 `body` 方法,而不是在路由中直接返回字符串, 消息体在后置过滤器是不可用的, 因为它在之后才会生成。 过滤器可以可选地带有范式, 只有请求路径满足该范式时才会执行: ~~~~ruby before '/protected/*' do authenticate! end after '/create/:slug' do |slug| session['last_slug'] = slug end ~~~~ 和路由一样,过滤器也可以带有条件: ~~~~ruby before :agent => /Songbird/ do # ... end after '/blog/*', :host_name => 'example.com' do # ... end ~~~~ ## 辅助方法 使用顶层的 `helpers` 方法来定义辅助方法, 以便在路由处理器和模板中使用: ~~~~ruby helpers do def bar(name) "#{name}bar" end end get '/:name' do bar(params['name']) end ~~~~ ### 使用 Sessions Session被用来在请求之间保持状态。如果被激活,每一个用户会话 对应有一个session哈希: ~~~~ruby enable :sessions get '/' do "value = " << session['value'].inspect end get '/:value' do session['value'] = params['value'] end ~~~~ 请注意 `enable :sessions` 实际上保存所有的数据在一个cookie之中。 这可能不会总是做你想要的(比如,保存大量的数据会增加你的流量)。 你可以使用任何的Rack session中间件,为了这么做, \*不要\*调用 `enable :sessions`,而是 按照自己的需要引入你的中间件: ~~~~ruby use Rack::Session::Pool, :expire_after => 2592000 get '/' do "value = " << session['value'].inspect end get '/:value' do session['value'] = params['value'] end ~~~~ ### 挂起 要想直接地停止请求,在过滤器或者路由中使用: ~~~~ruby halt ~~~~ 你也可以指定挂起时的状态码: ~~~~ruby halt 410 ~~~~ 或者消息体: ~~~~ruby halt 'this will be the body' ~~~~ 或者两者; ~~~~ruby halt 401, 'go away!' ~~~~ 也可以带消息头: ~~~~ruby halt 402, {'Content-Type' => 'text/plain'}, 'revenge' ~~~~ ### 让路 一个路由可以放弃处理,将处理让给下一个匹配的路由,使用 `pass`: ~~~~ruby get '/guess/:who' do pass unless params['who'] == 'Frank' 'You got me!' end get '/guess/*' do 'You missed!' end ~~~~ 路由代码块被直接退出,控制流继续前进到下一个匹配的路由。 如果没有匹配的路由,将返回404。 ### 触发另一个路由 有些时候,`pass` 并不是你想要的,你希望得到的是另一个路由的结果 。简单的使用 `call` 可以做到这一点: ~~~~ruby get '/foo' do status, headers, body = call env.merge("PATH_INFO" => '/bar') [status, headers, body.map(&:upcase)] end get '/bar' do "bar" end ~~~~ 请注意在以上例子中,你可以更加简化测试并增加性能,只要简单的移动 "bar"到一个被/foo 和 `/bar`同时使用的helper。 如果你希望请求被发送到同一个应用,而不是副本, 使用 `call!` 而不是 `call`. 如果想更多了解 `call`,请察看 Rack specification。 ### 设定 消息体,状态码和消息头 通过路由代码块的返回值来设定状态码和消息体不仅是可能的,而且是推荐的。 但是,在某些场景中你可能想在作业流程中的特定点上设置消息体。 你可以通过 `body` 辅助方法这么做。 如果你这样做了, 你可以在那以后使用该方法获得消息体: ~~~~ruby get '/foo' do body "bar" end after do puts body end ~~~~ 也可以传一个代码块给 `body`,它将会被Rack处理器执行( 这将可以被用来实现streaming,参见“返回值”)。 和消息体类似,你也可以设定状态码和消息头: ~~~~ruby get '/foo' do status 418 headers \ "Allow" => "BREW, POST, GET, PROPFIND, WHEN", "Refresh" => "Refresh: 20; http://www.ietf.org/rfc/rfc2324.txt" body "I'm a tea pot!" end ~~~~ 如同 `body`, 不带参数的 `headers` 和 `status` 可以用来访问 他们你的当前值. ### 媒体(MIME)类型 使用 `send_file` 或者静态文件的时候,Sinatra可能不能识别你的媒体类型。 使用 `mime_type` 通过文件扩展名来注册它们: ~~~~ruby mime_type :foo, 'text/foo' ~~~~ 你也可以使用 `content_type` 辅助方法: ~~~~ruby get '/' do content_type :foo "foo foo foo" end ~~~~ ### 生成 URL 为了生成URL,你需要使用 `url` 辅助方法, 例如,在Haml中: ~~~~ruby %a{:href => url('/foo')} foo ~~~~ 如果使用反向代理和Rack路由,生成URL的时候会考虑这些因素。 这个方法还有一个别名 `to` (见下面的例子). ### 浏览器重定向 你可以通过 `redirect` 辅助方法触发浏览器重定向: ~~~~ruby get '/foo' do redirect to('/bar') end ~~~~ 其他参数的用法,与 `halt`相同: ~~~~ruby redirect to('/bar'), 303 redirect 'http://google.com', 'wrong place, buddy' ~~~~ 用 `redirect back`可以把用户重定向到原始页面: ~~~~ruby get '/foo' do "do something" end get '/bar' do do_something redirect back end ~~~~ 如果想传递参数给redirect,可以用query string: ~~~~ruby redirect to('/bar?sum=42') ~~~~ 或者用session: ~~~~ruby enable :sessions get '/foo' do session['secret'] = 'foo' redirect to('/bar') end get '/bar' do session['secret'] end ~~~~ ### 缓存控制 要使用HTTP缓存,必须正确地设定消息头。 你可以这样设定 Cache-Control 消息头: ~~~~ruby get '/' do cache_control :public "cache it!" end ~~~~ 核心提示: 在前置过滤器中设定缓存. ~~~~ruby before do cache_control :public, :must_revalidate, :max_age => 60 end ~~~~ 如果你正在用 `expires` 辅助方法设定对应的消息头 `Cache-Control` 会自动设定: ~~~~ruby before do expires 500, :public, :must_revalidate end ~~~~ 为了合适地使用缓存,你应该考虑使用 `etag` 和 `last_modified`方法。 推荐在执行繁重任务\*之前\*使用这些helpers,这样一来, 如果客户端在缓存中已经有相关内容,就会立即得到显示。 ~~~~ruby get '/article/:id' do @article = Article.find params['id'] last_modified @article.updated_at etag @article.sha1 erb :article end ~~~~ 使用 [weak ETag](http://en.wikipedia.org/wiki/HTTP_ETag#Strong_and_weak_validation) 也是有可能的: ~~~~ruby etag @article.sha1, :weak ~~~~ 这些辅助方法并不会为你做任何缓存,而是将必要的信息传送给你的缓存 如果你在寻找缓存的快速解决方案,试试 [rack-cache](https://github.com/rtomayko/rack-cache): ~~~~ruby require "rack/cache" require "sinatra" use Rack::Cache get '/' do cache_control :public, :max_age => 36000 sleep 5 "hello" end ~~~~ ### 发送文件 为了发送文件,你可以使用 `send_file` 辅助方法: ~~~~ruby get '/' do send_file 'foo.png' end ~~~~ 也可以带一些选项: ~~~~ruby send_file 'foo.png', :type => :jpg ~~~~ 可用的选项有:
如果被禁用,Sinatra会允许使用相对路径重定向, 但是,Sinatra就不再遵守 RFC 2616标准 (HTTP 1.1), 该标准只允许绝对路径重定向。
如果你的应用运行在一个未恰当设置的反向代理之后, 你需要启用这个选项。注意 url 辅助方法 仍然会生成绝对 URL,除非你传入 false 作为第二参数。
默认禁用。
设定 content_type 辅助方法会 自动加上字符集信息的多媒体类型。
你应该添加而不是覆盖这个选项: settings.add_charset << "application/foobar"
对每一个请求放置一个锁, 只使用进程并发处理请求。
如果你的应用不是线程安全则需启动。 默认禁用。