sinatra 1.4.0.c → 1.4.0.d

Sign up to get free protection for your applications and to get access to all the features.

Potentially problematic release.


This version of sinatra might be problematic. Click here for more details.

@@ -0,0 +1,2136 @@
1
+ # Sinatra
2
+
3
+ *注:本文档仅仅是英文版的翻译,会出现内容没有及时更新的情况发生。
4
+ 如有不一致的地方,请以英文版为准。*
5
+
6
+ Sinatra是一个基于Ruby语言,以最小精力为代价快速创建web应用为目的的[DSL](http://en.wikipedia.org/wiki/Domain-specific_language)(
7
+ 领域专属语言):
8
+
9
+ ~~~~ {.ruby}
10
+ # myapp.rb
11
+ require 'sinatra'
12
+
13
+ get '/' do
14
+ 'Hello world!'
15
+ end
16
+ ~~~~
17
+
18
+ 安装gem然后运行:
19
+
20
+ ~~~~ {.shell}
21
+ gem install sinatra
22
+ ruby myapp.rb
23
+ ~~~~
24
+
25
+ 在该地址查看: [localhost:4567](http://localhost:4567)
26
+
27
+ 推荐同时运行`gem install thin`,Sinatra会优先选择thin作为服务器。
28
+
29
+ ## 路由
30
+
31
+ 在Sinatra中,一个路由是一个HTTP方法与URL匹配范式的配对。
32
+ 每个路由都与一个代码块关联:
33
+
34
+ ~~~~ {.ruby}
35
+ get '/' do
36
+ .. 显示一些事物 ..
37
+ end
38
+
39
+ post '/' do
40
+ .. 创建一些事物 ..
41
+ end
42
+
43
+ put '/' do
44
+ .. 更新一些事物 ..
45
+ end
46
+
47
+ delete '/' do
48
+ .. 消灭一些事物 ..
49
+ end
50
+
51
+ options '/' do
52
+ .. 满足一些事物 ..
53
+ end
54
+ ~~~~
55
+
56
+ 路由按照它们被定义的顺序进行匹配。 第一个与请求匹配的路由会被调用。
57
+
58
+ 路由范式可以包括具名参数,可通过`params`哈希表获得:
59
+
60
+ ~~~~ {.ruby}
61
+ get '/hello/:name' do
62
+ # 匹配 "GET /hello/foo" 和 "GET /hello/bar"
63
+ # params[:name] 的值是 'foo' 或者 'bar'
64
+ "Hello #{params[:name]}!"
65
+ end
66
+ ~~~~
67
+
68
+ 你同样可以通过代码块参数获得具名参数:
69
+
70
+ ~~~~ {.ruby}
71
+ get '/hello/:name' do |n|
72
+ "Hello #{n}!"
73
+ end
74
+ ~~~~
75
+
76
+ 路由范式也可以包含通配符参数, 可以通过`params[:splat]`数组获得。
77
+
78
+ ~~~~ {.ruby}
79
+ get '/say/*/to/*' do
80
+ # 匹配 /say/hello/to/world
81
+ params[:splat] # => ["hello", "world"]
82
+ end
83
+
84
+ get '/download/*.*' do
85
+ # 匹配 /download/path/to/file.xml
86
+ params[:splat] # => ["path/to/file", "xml"]
87
+ end
88
+ ~~~~
89
+
90
+ 通过正则表达式匹配的路由:
91
+
92
+ ~~~~ {.ruby}
93
+ get %r{/hello/([\w]+)} do
94
+ "Hello, #{params[:captures].first}!"
95
+ end
96
+ ~~~~
97
+
98
+ 或者使用代码块参数:
99
+
100
+ ~~~~ {.ruby}
101
+ get %r{/hello/([\w]+)} do |c|
102
+ "Hello, #{c}!"
103
+ end
104
+ ~~~~
105
+
106
+ ### 条件
107
+
108
+ 路由也可以包含多样的匹配条件,比如user agent:
109
+
110
+ ~~~~ {.ruby}
111
+ get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do
112
+ "你正在使用Songbird,版本是 #{params[:agent][0]}"
113
+ end
114
+
115
+ get '/foo' do
116
+ # 匹配除Songbird以外的浏览器
117
+ end
118
+ ~~~~
119
+
120
+ 其他可选的条件是 `host_name` 和 `provides`:
121
+
122
+ ~~~~ {.ruby}
123
+ get '/', :host_name => /^admin\./ do
124
+ "管理员区域,无权进入!"
125
+ end
126
+
127
+ get '/', :provides => 'html' do
128
+ haml :index
129
+ end
130
+
131
+ get '/', :provides => ['rss', 'atom', 'xml'] do
132
+ builder :feed
133
+ end
134
+ ~~~~
135
+
136
+ 你也可以很轻松地定义自己的条件:
137
+
138
+ ~~~~ {.ruby}
139
+ set(:probability) { |value| condition { rand <= value } }
140
+
141
+ get '/win_a_car', :probability => 0.1 do
142
+ "You won!"
143
+ end
144
+
145
+ get '/win_a_car' do
146
+ "Sorry, you lost."
147
+ end
148
+ ~~~~
149
+
150
+ ### 返回值
151
+
152
+ 路由代码块的返回值至少决定了返回给HTTP客户端的响应体,
153
+ 或者至少决定了在Rack堆栈中的下一个中间件。
154
+ 大多数情况下,将是一个字符串,就像上面的例子中的一样。
155
+ 但是其他值也是可以接受的。
156
+
157
+ 你可以返回任何对象,或者是一个合理的Rack响应, Rack
158
+ body对象或者HTTP状态码:
159
+
160
+ - 一个包含三个元素的数组:
161
+ `[状态 (Fixnum), 头 (Hash), 响应体 (回应 #each)]`
162
+
163
+ - 一个包含两个元素的数组: `[状态 (Fixnum), 响应体 (回应 #each)]`
164
+
165
+ - 一个能够回应 `#each` ,只传回字符串的对象
166
+
167
+ - 一个代表状态码的数字
168
+
169
+ 那样,我们可以轻松的实现例如流式传输的例子:
170
+
171
+ ~~~~ {.ruby}
172
+ class Stream
173
+ def each
174
+ 100.times { |i| yield "#{i}\n" }
175
+ end
176
+ end
177
+
178
+ get('/') { Stream.new }
179
+ ~~~~
180
+
181
+ ### 自定义路由匹配器
182
+
183
+ 如上显示,Sinatra内置了对于使用字符串和正则表达式作为路由匹配的支持。
184
+ 但是,它并没有只限于此。 你可以非常容易地定义你自己的匹配器:
185
+
186
+ ~~~~ {.ruby}
187
+ class AllButPattern
188
+ Match = Struct.new(:captures)
189
+
190
+ def initialize(except)
191
+ @except = except
192
+ @captures = Match.new([])
193
+ end
194
+
195
+ def match(str)
196
+ @captures unless @except === str
197
+ end
198
+ end
199
+
200
+ def all_but(pattern)
201
+ AllButPattern.new(pattern)
202
+ end
203
+
204
+ get all_but("/index") do
205
+ # ...
206
+ end
207
+ ~~~~
208
+
209
+ 请注意上面的例子可能超工程了, 因为它也可以用更简单的方式表述:
210
+
211
+ ~~~~ {.ruby}
212
+ get // do
213
+ pass if request.path_info == "/index"
214
+ # ...
215
+ end
216
+ ~~~~
217
+
218
+ 或者,使用消极向前查找:
219
+
220
+ ~~~~ {.ruby}
221
+ get %r{^(?!/index$)} do
222
+ # ...
223
+ end
224
+ ~~~~
225
+
226
+ ## 静态文件
227
+
228
+ 静态文件是从 `./public_folder` 目录提供服务。你可以通过设置`:public`
229
+ 选项设定一个不同的位置:
230
+
231
+ ~~~~ {.ruby}
232
+ set :public_folder, File.dirname(__FILE__) + '/static'
233
+ ~~~~
234
+
235
+ 请注意public目录名并没有被包含在URL之中。文件
236
+ `./public/css/style.css`是通过
237
+ `http://example.com/css/style.css`地址访问的。
238
+
239
+ ## 视图 / 模板
240
+
241
+ 模板被假定直接位于`./views`目录。 要使用不同的视图目录:
242
+
243
+ ~~~~ {.ruby}
244
+ set :views, File.dirname(__FILE__) + '/templates'
245
+ ~~~~
246
+
247
+ 请记住一件非常重要的事情,你只可以通过符号引用模板, 即使它们在子目录下
248
+ (在这种情况下,使用 `:'subdir/template'`)。 你必须使用一个符号,
249
+ 因为渲染方法会直接地渲染任何传入的字符串。
250
+
251
+ ### Haml模板
252
+
253
+ 需要引入 `haml` gem/library以渲染 HAML 模板:
254
+
255
+ ~~~~ {.ruby}
256
+ # 你需要在你的应用中引入 haml
257
+ require 'haml'
258
+
259
+ get '/' do
260
+ haml :index
261
+ end
262
+ ~~~~
263
+
264
+ 渲染 `./views/index.haml`。
265
+
266
+ [Haml的选项](http://haml.info/docs/yardoc/file.HAML_REFERENCE.html#options)
267
+ 可以通过Sinatra的配置全局设定, 参见
268
+ [选项和配置](http://www.sinatrarb.com/configuration.html),
269
+ 也可以个别的被覆盖。
270
+
271
+ ~~~~ {.ruby}
272
+ set :haml, {:format => :html5 } # 默认的Haml输出格式是 :xhtml
273
+
274
+ get '/' do
275
+ haml :index, :haml_options => {:format => :html4 } # 被覆盖,变成:html4
276
+ end
277
+ ~~~~
278
+
279
+ ### Erb模板
280
+
281
+ ~~~~ {.ruby}
282
+ # 你需要在你的应用中引入 erb
283
+ require 'erb'
284
+
285
+ get '/' do
286
+ erb :index
287
+ end
288
+ ~~~~
289
+
290
+ 渲染 `./views/index.erb`
291
+
292
+ ### Erubis
293
+
294
+ 需要引入 `erubis` gem/library以渲染 erubis 模板:
295
+
296
+ ~~~~ {.ruby}
297
+ # 你需要在你的应用中引入 erubis
298
+ require 'erubis'
299
+
300
+ get '/' do
301
+ erubis :index
302
+ end
303
+ ~~~~
304
+
305
+ 渲染 `./views/index.erubis`
306
+
307
+ 使用Erubis代替Erb也是可能的:
308
+
309
+ ~~~~ {.ruby}
310
+ require 'erubis'
311
+ Tilt.register :erb, Tilt[:erubis]
312
+
313
+ get '/' do
314
+ erb :index
315
+ end
316
+ ~~~~
317
+
318
+ 使用Erubis来渲染 `./views/index.erb`。
319
+
320
+ ### Builder 模板
321
+
322
+ 需要引入 `builder` gem/library 以渲染 builder templates:
323
+
324
+ ~~~~ {.ruby}
325
+ # 需要在你的应用中引入builder
326
+ require 'builder'
327
+
328
+ get '/' do
329
+ builder :index
330
+ end
331
+ ~~~~
332
+
333
+ 渲染 `./views/index.builder`。
334
+
335
+ ### Nokogiri 模板
336
+
337
+ 需要引入 `nokogiri` gem/library 以渲染 nokogiri 模板:
338
+
339
+ ~~~~ {.ruby}
340
+ # 需要在你的应用中引入 nokogiri
341
+ require 'nokogiri'
342
+
343
+ get '/' do
344
+ nokogiri :index
345
+ end
346
+ ~~~~
347
+
348
+ 渲染 `./views/index.nokogiri`。
349
+
350
+ ### Sass 模板
351
+
352
+ 需要引入 `haml` 或者 `sass` gem/library 以渲染 Sass 模板:
353
+
354
+ ~~~~ {.ruby}
355
+ # 需要在你的应用中引入 haml 或者 sass
356
+ require 'sass'
357
+
358
+ get '/stylesheet.css' do
359
+ sass :stylesheet
360
+ end
361
+ ~~~~
362
+
363
+ 渲染 `./views/stylesheet.sass`。
364
+
365
+ [Sass
366
+ 的选项](http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options)
367
+ 可以通过Sinatra选项全局设定, 参考
368
+ [选项和配置(英文)](http://www.sinatrarb.com/configuration.html),
369
+ 也可以在个体的基础上覆盖。
370
+
371
+ ~~~~ {.ruby}
372
+ set :sass, {:style => :compact } # 默认的 Sass 样式是 :nested
373
+
374
+ get '/stylesheet.css' do
375
+ sass :stylesheet, :style => :expanded # 覆盖
376
+ end
377
+ ~~~~
378
+
379
+ ### Scss 模板
380
+
381
+ 需要引入 `haml` 或者 `sass` gem/library 来渲染 Scss templates:
382
+
383
+ ~~~~ {.ruby}
384
+ # 需要在你的应用中引入 haml 或者 sass
385
+ require 'sass'
386
+
387
+ get '/stylesheet.css' do
388
+ scss :stylesheet
389
+ end
390
+ ~~~~
391
+
392
+ 渲染 `./views/stylesheet.scss`。
393
+
394
+ [Scss的选项](http://sass-lang.com/docs/yardoc/file.SASS_REFERENCE.html#options)
395
+ 可以通过Sinatra选项全局设定, 参考
396
+ [选项和配置(英文)](http://www.sinatrarb.com/configuration.html),
397
+ 也可以在个体的基础上覆盖。
398
+
399
+ ~~~~ {.ruby}
400
+ set :scss, :style => :compact # default Scss style is :nested
401
+
402
+ get '/stylesheet.css' do
403
+ scss :stylesheet, :style => :expanded # overridden
404
+ end
405
+ ~~~~
406
+
407
+ ### Less 模板
408
+
409
+ 需要引入 `less` gem/library 以渲染 Less 模板:
410
+
411
+ ~~~~ {.ruby}
412
+ # 需要在你的应用中引入 less
413
+ require 'less'
414
+
415
+ get '/stylesheet.css' do
416
+ less :stylesheet
417
+ end
418
+ ~~~~
419
+
420
+ 渲染 `./views/stylesheet.less`。
421
+
422
+ ### Liquid 模板
423
+
424
+ 需要引入 `liquid` gem/library 来渲染 Liquid 模板:
425
+
426
+ ~~~~ {.ruby}
427
+ # 需要在你的应用中引入 liquid
428
+ require 'liquid'
429
+
430
+ get '/' do
431
+ liquid :index
432
+ end
433
+ ~~~~
434
+
435
+ 渲染 `./views/index.liquid`。
436
+
437
+ 因为你不能在Liquid 模板中调用 Ruby 方法 (除了 `yield`) ,
438
+ 你几乎总是需要传递locals给它:
439
+
440
+ ~~~~ {.ruby}
441
+ liquid :index, :locals => { :key => 'value' }
442
+ ~~~~
443
+
444
+ ### Markdown 模板
445
+
446
+ 需要引入 `rdiscount` gem/library 以渲染 Markdown 模板:
447
+
448
+ ~~~~ {.ruby}
449
+ # 需要在你的应用中引入rdiscount
450
+ require "rdiscount"
451
+
452
+ get '/' do
453
+ markdown :index
454
+ end
455
+ ~~~~
456
+
457
+ 渲染 `./views/index.markdown` (`md` 和 `mkd` 也是合理的文件扩展名)。
458
+
459
+ 在markdown中是不可以调用方法的,也不可以传递 locals给它。
460
+ 你因此一般会结合其他的渲染引擎来使用它:
461
+
462
+ ~~~~ {.ruby}
463
+ erb :overview, :locals => { :text => markdown(:introduction) }
464
+ ~~~~
465
+
466
+ 请注意你也可以从其他模板中调用 markdown 方法:
467
+
468
+ ~~~~ {.ruby}
469
+ %h1 Hello From Haml!
470
+ %p= markdown(:greetings)
471
+ ~~~~
472
+
473
+ 既然你不能在Markdown中调用Ruby,你不能使用Markdown编写的布局。
474
+ 不过,使用其他渲染引擎作为模版的布局是可能的,
475
+ 通过传递`:layout_engine`选项:
476
+
477
+ ~~~~ {.ruby}
478
+ get '/' do
479
+ markdown :index, :layout_engine => :erb
480
+ end
481
+ ~~~~
482
+
483
+ 这将会渲染 `./views/index.md` 并使用 `./views/layout.erb` 作为布局。
484
+
485
+ 请记住你可以全局设定这个选项:
486
+
487
+ ~~~~ {.ruby}
488
+ set :markdown, :layout_engine => :haml, :layout => :post
489
+
490
+ get '/' do
491
+ markdown :index
492
+ end
493
+ ~~~~
494
+
495
+ 这将会渲染 `./views/index.markdown` (和任何其他的 Markdown 模版) 并使用
496
+ `./views/post.haml` 作为布局.
497
+
498
+ 也可能使用BlueCloth而不是RDiscount来解析Markdown文件:
499
+
500
+ ~~~~ {.ruby}
501
+ require 'bluecloth'
502
+
503
+ Tilt.register 'markdown', BlueClothTemplate
504
+ Tilt.register 'mkd', BlueClothTemplate
505
+ Tilt.register 'md', BlueClothTemplate
506
+
507
+ get '/' do
508
+ markdown :index
509
+ end
510
+ ~~~~
511
+
512
+ 使用BlueCloth来渲染 `./views/index.md` 。
513
+
514
+ ### Textile 模板
515
+
516
+ 需要引入 `RedCloth` gem/library 以渲染 Textile 模板:
517
+
518
+ ~~~~ {.ruby}
519
+ # 在你的应用中引入redcloth
520
+ require "redcloth"
521
+
522
+ get '/' do
523
+ textile :index
524
+ end
525
+ ~~~~
526
+
527
+ 渲染 `./views/index.textile`。
528
+
529
+ 在textile中是不可以调用方法的,也不可以传递 locals给它。
530
+ 你因此一般会结合其他的渲染引擎来使用它:
531
+
532
+ ~~~~ {.ruby}
533
+ erb :overview, :locals => { :text => textile(:introduction) }
534
+ ~~~~
535
+
536
+ 请注意你也可以从其他模板中调用`textile`方法:
537
+
538
+ ~~~~ {.ruby}
539
+ %h1 Hello From Haml!
540
+ %p= textile(:greetings)
541
+ ~~~~
542
+
543
+ 既然你不能在Textile中调用Ruby,你不能使用Textile编写的布局。
544
+ 不过,使用其他渲染引擎作为模版的布局是可能的,
545
+ 通过传递`:layout_engine`选项:
546
+
547
+ ~~~~ {.ruby}
548
+ get '/' do
549
+ textile :index, :layout_engine => :erb
550
+ end
551
+ ~~~~
552
+
553
+ 这将会渲染 `./views/index.textile` 并使用 `./views/layout.erb`
554
+ 作为布局。
555
+
556
+ 请记住你可以全局设定这个选项:
557
+
558
+ ~~~~ {.ruby}
559
+ set :textile, :layout_engine => :haml, :layout => :post
560
+
561
+ get '/' do
562
+ textile :index
563
+ end
564
+ ~~~~
565
+
566
+ 这将会渲染 `./views/index.textile` (和任何其他的 Textile 模版) 并使用
567
+ `./views/post.haml` 作为布局.
568
+
569
+ ### RDoc 模板
570
+
571
+ 需要引入 `RDoc` gem/library 以渲染RDoc模板:
572
+
573
+ ~~~~ {.ruby}
574
+ # 需要在你的应用中引入rdoc/markup/to_html
575
+ require "rdoc"
576
+ require "rdoc/markup/to_html"
577
+
578
+ get '/' do
579
+ rdoc :index
580
+ end
581
+ ~~~~
582
+
583
+ 渲染 `./views/index.rdoc`。
584
+
585
+ 在rdoc中是不可以调用方法的,也不可以传递locals给它。
586
+ 你因此一般会结合其他的渲染引擎来使用它:
587
+
588
+ ~~~~ {.ruby}
589
+ erb :overview, :locals => { :text => rdoc(:introduction) }
590
+ ~~~~
591
+
592
+ 请注意你也可以从其他模板中调用`rdoc`方法:
593
+
594
+ ~~~~ {.ruby}
595
+ %h1 Hello From Haml!
596
+ %p= rdoc(:greetings)
597
+ ~~~~
598
+
599
+ 既然你不能在RDoc中调用Ruby,你不能使用RDoc编写的布局。
600
+ 不过,使用其他渲染引擎作为模版的布局是可能的,
601
+ 通过传递`:layout_engine`选项:
602
+
603
+ ~~~~ {.ruby}
604
+ get '/' do
605
+ rdoc :index, :layout_engine => :erb
606
+ end
607
+ ~~~~
608
+
609
+ 这将会渲染 `./views/index.rdoc` 并使用 `./views/layout.erb` 作为布局。
610
+
611
+ 请记住你可以全局设定这个选项:
612
+
613
+ ~~~~ {.ruby}
614
+ set :rdoc, :layout_engine => :haml, :layout => :post
615
+
616
+ get '/' do
617
+ rdoc :index
618
+ end
619
+ ~~~~
620
+
621
+ 这将会渲染 `./views/index.rdoc` (和任何其他的 RDoc 模版) 并使用
622
+ `./views/post.haml` 作为布局.
623
+
624
+ ### Radius 模板
625
+
626
+ 需要引入 `radius` gem/library 以渲染 Radius 模板:
627
+
628
+ ~~~~ {.ruby}
629
+ # 需要在你的应用中引入radius
630
+ require 'radius'
631
+
632
+ get '/' do
633
+ radius :index
634
+ end
635
+ ~~~~
636
+
637
+ 渲染 `./views/index.radius`。
638
+
639
+ 因为你不能在Radius 模板中调用 Ruby 方法 (除了 `yield`) ,
640
+ 你几乎总是需要传递locals给它:
641
+
642
+ ~~~~ {.ruby}
643
+ radius :index, :locals => { :key => 'value' }
644
+ ~~~~
645
+
646
+ ### Markaby 模板
647
+
648
+ 需要引入`markaby` gem/library以渲染Markaby模板:
649
+
650
+ ~~~~ {.ruby}
651
+ #需要在你的应用中引入 markaby
652
+ require 'markaby'
653
+
654
+ get '/' do
655
+ markaby :index
656
+ end
657
+ ~~~~
658
+
659
+ 渲染 `./views/index.mab`。
660
+
661
+ 你也可以使用嵌入的 Markaby:
662
+
663
+ ~~~~ {.ruby}
664
+ get '/' do
665
+ markaby { h1 "Welcome!" }
666
+ end
667
+ ~~~~
668
+
669
+ ### Slim 模板
670
+
671
+ 需要引入 `slim` gem/library 来渲染 Slim 模板:
672
+
673
+ ~~~~ {.ruby}
674
+ # 需要在你的应用中引入 slim
675
+ require 'slim'
676
+
677
+ get '/' do
678
+ slim :index
679
+ end
680
+ ~~~~
681
+
682
+ 渲染 `./views/index.slim`。
683
+
684
+ ### Creole 模板
685
+
686
+ 需要引入 `creole` gem/library 来渲染 Creole 模板:
687
+
688
+ ~~~~ {.ruby}
689
+ # 需要在你的应用中引入 creole
690
+ require 'creole'
691
+
692
+ get '/' do
693
+ creole :index
694
+ end
695
+ ~~~~
696
+
697
+ 渲染 `./views/index.creole`。
698
+
699
+ ### CoffeeScript 模板
700
+
701
+ 需要引入 `coffee-script` gem/library 并至少满足下面条件一项
702
+ 以执行Javascript:
703
+
704
+ - `node` (来自 Node.js) 在你的路径中
705
+
706
+ - 你正在运行 OSX
707
+
708
+ - `therubyracer` gem/library
709
+
710
+ 请察看
711
+ [github.com/josh/ruby-coffee-script](http://github.com/josh/ruby-coffee-script)
712
+ 获取更新的选项。
713
+
714
+ 现在你可以渲染 CoffeeScript 模版了:
715
+
716
+ ~~~~ {.ruby}
717
+ # 需要在你的应用中引入coffee-script
718
+ require 'coffee-script'
719
+
720
+ get '/application.js' do
721
+ coffee :application
722
+ end
723
+ ~~~~
724
+
725
+ 渲染 `./views/application.coffee`。
726
+
727
+ ### 嵌入模板字符串
728
+
729
+ ~~~~ {.ruby}
730
+ get '/' do
731
+ haml '%div.title Hello World'
732
+ end
733
+ ~~~~
734
+
735
+ 渲染嵌入模板字符串。
736
+
737
+ ### 在模板中访问变量
738
+
739
+ 模板和路由执行器在同样的上下文求值。
740
+ 在路由执行器中赋值的实例变量可以直接被模板访问。
741
+
742
+ ~~~~ {.ruby}
743
+ get '/:id' do
744
+ @foo = Foo.find(params[:id])
745
+ haml '%h1= @foo.name'
746
+ end
747
+ ~~~~
748
+
749
+ 或者,显式地指定一个本地变量的哈希:
750
+
751
+ ~~~~ {.ruby}
752
+ get '/:id' do
753
+ foo = Foo.find(params[:id])
754
+ haml '%h1= foo.name', :locals => { :foo => foo }
755
+ end
756
+ ~~~~
757
+
758
+ 典型的使用情况是在别的模板中按照局部模板的方式来渲染。
759
+
760
+ ### 内联模板
761
+
762
+ 模板可以在源文件的末尾定义:
763
+
764
+ ~~~~ {.ruby}
765
+ require 'sinatra'
766
+
767
+ get '/' do
768
+ haml :index
769
+ end
770
+
771
+ __END__
772
+
773
+ @@ layout
774
+ %html
775
+ = yield
776
+
777
+ @@ index
778
+ %div.title Hello world!!!!!
779
+ ~~~~
780
+
781
+ 注意:引入sinatra的源文件中定义的内联模板才能被自动载入。
782
+ 如果你在其他源文件中有内联模板,
783
+ 需要显式执行调用`enable :inline_templates`。
784
+
785
+ ### 具名模板
786
+
787
+ 模板可以通过使用顶层 `template` 方法定义:
788
+
789
+ ~~~~ {.ruby}
790
+ template :layout do
791
+ "%html\n =yield\n"
792
+ end
793
+
794
+ template :index do
795
+ '%div.title Hello World!'
796
+ end
797
+
798
+ get '/' do
799
+ haml :index
800
+ end
801
+ ~~~~
802
+
803
+ 如果存在名为“layout”的模板,该模板会在每个模板渲染的时候被使用。
804
+ 你可以单独地通过传送 `:layout => false`来禁用,
805
+ 或者通过`set :haml, :layout => false`来禁用他们。
806
+
807
+ ~~~~ {.ruby}
808
+ get '/' do
809
+ haml :index, :layout => !request.xhr?
810
+ end
811
+ ~~~~
812
+
813
+ ### 关联文件扩展名
814
+
815
+ 为了关联一个文件扩展名到一个模版引擎,使用
816
+ `Tilt.register`。比如,如果你喜欢使用 `tt`
817
+ 作为Textile模版的扩展名,你可以这样做:
818
+
819
+ ~~~~ {.ruby}
820
+ Tilt.register :tt, Tilt[:textile]
821
+ ~~~~
822
+
823
+ ### 添加你自己的模版引擎
824
+
825
+ 首先,通过Tilt注册你自己的引擎,然后创建一个渲染方法:
826
+
827
+ ~~~~ {.ruby}
828
+ Tilt.register :myat, MyAwesomeTemplateEngine
829
+
830
+ helpers do
831
+ def myat(*args) render(:myat, *args) end
832
+ end
833
+
834
+ get '/' do
835
+ myat :index
836
+ end
837
+ ~~~~
838
+
839
+ 渲染 `./views/index.myat`。察看
840
+ [github.com/rtomayko/tilt](https://github.com/rtomayko/tilt)
841
+ 来更多了解Tilt.
842
+
843
+ ## 过滤器
844
+
845
+ 前置过滤器在每个请求前,在请求的上下文环境中被执行,
846
+ 而且可以修改请求和响应。 在过滤器中设定的实例变量可以被路由和模板访问:
847
+
848
+ ~~~~ {.ruby}
849
+ before do
850
+ @note = 'Hi!'
851
+ request.path_info = '/foo/bar/baz'
852
+ end
853
+
854
+ get '/foo/*' do
855
+ @note #=> 'Hi!'
856
+ params[:splat] #=> 'bar/baz'
857
+ end
858
+ ~~~~
859
+
860
+ 后置过滤器在每个请求之后,在请求的上下文环境中执行,
861
+ 而且可以修改请求和响应。
862
+ 在前置过滤器和路由中设定的实例变量可以被后置过滤器访问:
863
+
864
+ ~~~~ {.ruby}
865
+ after do
866
+ puts response.status
867
+ end
868
+ ~~~~
869
+
870
+ 请注意:除非你显式使用 `body` 方法,而不是在路由中直接返回字符串,
871
+ 消息体在后置过滤器是不可用的, 因为它在之后才会生成。
872
+
873
+ 过滤器可以可选地带有范式, 只有请求路径满足该范式时才会执行:
874
+
875
+ ~~~~ {.ruby}
876
+ before '/protected/*' do
877
+ authenticate!
878
+ end
879
+
880
+ after '/create/:slug' do |slug|
881
+ session[:last_slug] = slug
882
+ end
883
+ ~~~~
884
+
885
+ 和路由一样,过滤器也可以带有条件:
886
+
887
+ ~~~~ {.ruby}
888
+ before :agent => /Songbird/ do
889
+ # ...
890
+ end
891
+
892
+ after '/blog/*', :host_name => 'example.com' do
893
+ # ...
894
+ end
895
+ ~~~~
896
+
897
+ ## 辅助方法
898
+
899
+ 使用顶层的 `helpers` 方法来定义辅助方法, 以便在路由处理器和模板中使用:
900
+
901
+ ~~~~ {.ruby}
902
+ helpers do
903
+ def bar(name)
904
+ "#{name}bar"
905
+ end
906
+ end
907
+
908
+ get '/:name' do
909
+ bar(params[:name])
910
+ end
911
+ ~~~~
912
+
913
+ ### 使用 Sessions
914
+
915
+ Session被用来在请求之间保持状态。如果被激活,每一个用户会话
916
+ 对应有一个session哈希:
917
+
918
+ ~~~~ {.ruby}
919
+ enable :sessions
920
+
921
+ get '/' do
922
+ "value = " << session[:value].inspect
923
+ end
924
+
925
+ get '/:value' do
926
+ session[:value] = params[:value]
927
+ end
928
+ ~~~~
929
+
930
+ 请注意 `enable :sessions` 实际上保存所有的数据在一个cookie之中。
931
+ 这可能不会总是做你想要的(比如,保存大量的数据会增加你的流量)。
932
+ 你可以使用任何的Rack session中间件,为了这么做, \*不要\*调用
933
+ `enable :sessions`,而是 按照自己的需要引入你的中间件:
934
+
935
+ ~~~~ {.ruby}
936
+ use Rack::Session::Pool, :expire_after => 2592000
937
+
938
+ get '/' do
939
+ "value = " << session[:value].inspect
940
+ end
941
+
942
+ get '/:value' do
943
+ session[:value] = params[:value]
944
+ end
945
+ ~~~~
946
+
947
+ ### 挂起
948
+
949
+ 要想直接地停止请求,在过滤器或者路由中使用:
950
+
951
+ ~~~~ {.ruby}
952
+ halt
953
+ ~~~~
954
+
955
+ 你也可以指定挂起时的状态码:
956
+
957
+ ~~~~ {.ruby}
958
+ halt 410
959
+ ~~~~
960
+
961
+ 或者消息体:
962
+
963
+ ~~~~ {.ruby}
964
+ halt 'this will be the body'
965
+ ~~~~
966
+
967
+ 或者两者;
968
+
969
+ ~~~~ {.ruby}
970
+ halt 401, 'go away!'
971
+ ~~~~
972
+
973
+ 也可以带消息头:
974
+
975
+ ~~~~ {.ruby}
976
+ halt 402, {'Content-Type' => 'text/plain'}, 'revenge'
977
+ ~~~~
978
+
979
+ ### 让路
980
+
981
+ 一个路由可以放弃处理,将处理让给下一个匹配的路由,使用 `pass`:
982
+
983
+ ~~~~ {.ruby}
984
+ get '/guess/:who' do
985
+ pass unless params[:who] == 'Frank'
986
+ 'You got me!'
987
+ end
988
+
989
+ get '/guess/*' do
990
+ 'You missed!'
991
+ end
992
+ ~~~~
993
+
994
+ 路由代码块被直接退出,控制流继续前进到下一个匹配的路由。
995
+ 如果没有匹配的路由,将返回404。
996
+
997
+ ### 触发另一个路由
998
+
999
+ 有些时候,`pass` 并不是你想要的,你希望得到的是另一个路由的结果
1000
+ 。简单的使用 `call` 可以做到这一点:
1001
+
1002
+ ~~~~ {.ruby}
1003
+ get '/foo' do
1004
+ status, headers, body = call env.merge("PATH_INFO" => '/bar')
1005
+ [status, headers, body.map(&:upcase)]
1006
+ end
1007
+
1008
+ get '/bar' do
1009
+ "bar"
1010
+ end
1011
+ ~~~~
1012
+
1013
+ 请注意在以上例子中,你可以更加简化测试并增加性能,只要简单的移动
1014
+
1015
+ <tt>"bar"</tt>到一个被<tt>/foo</tt>
1016
+
1017
+ 和 `/bar`同时使用的helper。
1018
+
1019
+ 如果你希望请求被发送到同一个应用,而不是副本, 使用 `call!` 而不是
1020
+ `call`.
1021
+
1022
+ 察看 Rack specification 如果你想更多了解 `call`.
1023
+
1024
+ ### 设定 消息体,状态码和消息头
1025
+
1026
+ 通过路由代码块的返回值来设定状态码和消息体不仅是可能的,而且是推荐的。
1027
+ 但是,在某些场景中你可能想在作业流程中的特定点上设置消息体。 你可以通过
1028
+ `body` 辅助方法这么做。 如果你这样做了,
1029
+ 你可以在那以后使用该方法获得消息体:
1030
+
1031
+ ~~~~ {.ruby}
1032
+ get '/foo' do
1033
+ body "bar"
1034
+ end
1035
+
1036
+ after do
1037
+ puts body
1038
+ end
1039
+ ~~~~
1040
+
1041
+ 也可以传一个代码块给 `body`,它将会被Rack处理器执行(
1042
+ 这将可以被用来实现streaming,参见“返回值”)。
1043
+
1044
+ 和消息体类似,你也可以设定状态码和消息头:
1045
+
1046
+ ~~~~ {.ruby}
1047
+ get '/foo' do
1048
+ status 418
1049
+ headers \
1050
+ "Allow" => "BREW, POST, GET, PROPFIND, WHEN",
1051
+ "Refresh" => "Refresh: 20; http://www.ietf.org/rfc/rfc2324.txt"
1052
+ body "I'm a tea pot!"
1053
+ end
1054
+ ~~~~
1055
+
1056
+ 如同 `body`, 不带参数的 `headers` 和 `status` 可以用来访问
1057
+ 他们你的当前值.
1058
+
1059
+ ### 媒体类型
1060
+
1061
+ 当使用 `send_file` 或者静态文件的场合,你的媒体类型可能
1062
+ Sinatra并不理解。使用 `mime_type` 通过文件扩展名来注册它们:
1063
+
1064
+ ~~~~ {.ruby}
1065
+ mime_type :foo, 'text/foo'
1066
+ ~~~~
1067
+
1068
+ 你也可以通过 `content_type` 辅助方法使用:
1069
+
1070
+ ~~~~ {.ruby}
1071
+ get '/' do
1072
+ content_type :foo
1073
+ "foo foo foo"
1074
+ end
1075
+ ~~~~
1076
+
1077
+ ### 生成 URL
1078
+
1079
+ 为了生成URL,你需要使用 `url` 辅助方法, 例如,在Haml中:
1080
+
1081
+ ~~~~ {.ruby}
1082
+ %a{:href => url('/foo')} foo
1083
+ ~~~~
1084
+
1085
+ 它会根据反向代理和Rack路由,如果有的话,来计算生成的URL。
1086
+
1087
+ 这个方法还有一个别名 `to` (见下面的例子).
1088
+
1089
+ ### 浏览器重定向
1090
+
1091
+ 你可以通过 `redirect` 辅助方法触发浏览器重定向:
1092
+
1093
+ ~~~~ {.ruby}
1094
+ get '/foo' do
1095
+ redirect to('/bar')
1096
+ end
1097
+ ~~~~
1098
+
1099
+ 任何额外的参数都会被以 `halt`相同的方式来处理:
1100
+
1101
+ ~~~~ {.ruby}
1102
+ redirect to('/bar'), 303
1103
+ redirect 'http://google.com', 'wrong place, buddy'
1104
+ ~~~~
1105
+
1106
+ 你可以方便的通过 `redirect back`把用户重定向到来自的页面:
1107
+
1108
+ ~~~~ {.ruby}
1109
+ get '/foo' do
1110
+ "<a href='/bar'>do something</a>"
1111
+ end
1112
+
1113
+ get '/bar' do
1114
+ do_something
1115
+ redirect back
1116
+ end
1117
+ ~~~~
1118
+
1119
+ 为了传递参数给redirect,或者加入query:
1120
+
1121
+ ~~~~ {.ruby}
1122
+ redirect to('/bar?sum=42')
1123
+ ~~~~
1124
+
1125
+ 或者使用session:
1126
+
1127
+ ~~~~ {.ruby}
1128
+ enable :sessions
1129
+
1130
+ get '/foo' do
1131
+ session[:secret] = 'foo'
1132
+ redirect to('/bar')
1133
+ end
1134
+
1135
+ get '/bar' do
1136
+ session[:secret]
1137
+ end
1138
+ ~~~~
1139
+
1140
+ ### 缓存控制
1141
+
1142
+ 正确地设定消息头是恰当的HTTP缓存的基础。
1143
+
1144
+ 你可以方便的设定 Cache-Control 消息头,像这样:
1145
+
1146
+ ~~~~ {.ruby}
1147
+ get '/' do
1148
+ cache_control :public
1149
+ "cache it!"
1150
+ end
1151
+ ~~~~
1152
+
1153
+ 核心提示: 在前置过滤器中设定缓存.
1154
+
1155
+ ~~~~ {.ruby}
1156
+ before do
1157
+ cache_control :public, :must_revalidate, :max_age => 60
1158
+ end
1159
+ ~~~~
1160
+
1161
+ 如果你正在用 `expires` 辅助方法设定对应的消息头 `Cache-Control`
1162
+ 会自动设定:
1163
+
1164
+ ~~~~ {.ruby}
1165
+ before do
1166
+ expires 500, :public, :must_revalidate
1167
+ end
1168
+ ~~~~
1169
+
1170
+ 为了合适地使用缓存,你应该考虑使用 `etag` 和 `last_modified`方法。.
1171
+ 推荐在执行繁重任务\*之前\*使用这些helpers,
1172
+ 他们会立刻发送响应,如果客户端在缓存中已经有了当前版本。
1173
+
1174
+ ~~~~ {.ruby}
1175
+ get '/article/:id' do
1176
+ @article = Article.find params[:id]
1177
+ last_modified @article.updated_at
1178
+ etag @article.sha1
1179
+ erb :article
1180
+ end
1181
+ ~~~~
1182
+
1183
+ 使用 [weak
1184
+ ETag](http://en.wikipedia.org/wiki/HTTP_ETag#Strong_and_weak_validation)
1185
+ 也是有可能的:
1186
+
1187
+ ~~~~ {.ruby}
1188
+ etag @article.sha1, :weak
1189
+ ~~~~
1190
+
1191
+ 这些辅助方法并不会为你做任何缓存,而是将必要的信息传送给你的缓存
1192
+ 如果你在寻找缓存的快速解决方案,试试
1193
+ [rack-cache](https://github.com/rtomayko/rack-cache):
1194
+
1195
+ ~~~~ {.ruby}
1196
+ require "rack/cache"
1197
+ require "sinatra"
1198
+
1199
+ use Rack::Cache
1200
+
1201
+ get '/' do
1202
+ cache_control :public, :max_age => 36000
1203
+ sleep 5
1204
+ "hello"
1205
+ end
1206
+ ~~~~
1207
+
1208
+ ### 发送文件
1209
+
1210
+ 为了发送文件,你可以使用 `send_file` 辅助方法:
1211
+
1212
+ ~~~~ {.ruby}
1213
+ get '/' do
1214
+ send_file 'foo.png'
1215
+ end
1216
+ ~~~~
1217
+
1218
+ 也可以带一些选项:
1219
+
1220
+ ~~~~ {.ruby}
1221
+ send_file 'foo.png', :type => :jpg
1222
+ ~~~~
1223
+
1224
+ 可用的选项有:
1225
+
1226
+ <dl>
1227
+ <dt>filename</dt>
1228
+ <dd>响应中的文件名,默认是真实文件的名字。</dd>
1229
+
1230
+ <dt>last_modified</dt>
1231
+ <dd>Last-Modified 消息头的值,默认是文件的mtime(修改时间)。</dd>
1232
+
1233
+ <dt>type</dt>
1234
+ <dd>使用的内容类型,如果没有会从文件扩展名猜测。</dd>
1235
+
1236
+ <dt>disposition</dt>
1237
+ <dd>
1238
+ 用于 Content-Disposition,可能的包括: <tt>nil</tt> (默认), <tt>:attachment</tt> 和
1239
+ <tt>:inline</tt>
1240
+ </dd>
1241
+
1242
+ <dt>length</dt>
1243
+ <dd>Content-Length 的值,默认是文件的大小。</dd>
1244
+ </dl>
1245
+
1246
+ 如果Rack处理器支持,Ruby进程除streaming以外的方式会被使用。
1247
+ 如果你使用这个辅助方法, Sinatra会自动处理range请求。
1248
+
1249
+ ### 访问请求对象
1250
+
1251
+ 传入的请求对象可以在请求层(过滤器,路由,错误处理) 通过 `request`
1252
+ 方法被访问:
1253
+
1254
+ ~~~~ {.ruby}
1255
+ # 在 http://example.com/example 上运行的应用
1256
+ get '/foo' do
1257
+ request.body # 被客户端设定的请求体(见下)
1258
+ request.scheme # "http"
1259
+ request.script_name # "/example"
1260
+ request.path_info # "/foo"
1261
+ request.port # 80
1262
+ request.request_method # "GET"
1263
+ request.query_string # ""
1264
+ request.content_length # request.body的长度
1265
+ request.media_type # request.body的媒体类型
1266
+ request.host # "example.com"
1267
+ request.get? # true (其他动词也具有类似方法)
1268
+ request.form_data? # false
1269
+ request["SOME_HEADER"] # SOME_HEADER header的值
1270
+ request.referrer # 客户端的referrer 或者 '/'
1271
+ request.user_agent # user agent (被 :agent 条件使用)
1272
+ request.cookies # 浏览器 cookies 哈希
1273
+ request.xhr? # 这是否是ajax请求?
1274
+ request.url # "http://example.com/example/foo"
1275
+ request.path # "/example/foo"
1276
+ request.ip # 客户端IP地址
1277
+ request.secure? # false(如果是ssl则为true)
1278
+ request.forwarded? # true (如果是运行在反向代理之后)
1279
+ request.env # Rack中使用的未处理的env哈希
1280
+ end
1281
+ ~~~~
1282
+
1283
+ 一些选项,例如 `script_name` 或者 `path_info` 也是可写的:
1284
+
1285
+ ~~~~ {.ruby}
1286
+ before { request.path_info = "/" }
1287
+
1288
+ get "/" do
1289
+ "all requests end up here"
1290
+ end
1291
+ ~~~~
1292
+
1293
+ `request.body` 是一个IO或者StringIO对象:
1294
+
1295
+ ~~~~ {.ruby}
1296
+ post "/api" do
1297
+ request.body.rewind # 如果已经有人读了它
1298
+ data = JSON.parse request.body.read
1299
+ "Hello #{data['name']}!"
1300
+ end
1301
+ ~~~~
1302
+
1303
+ ### 附件
1304
+
1305
+ 你可以使用 `attachment` 辅助方法来告诉浏览器响应
1306
+ 应当被写入磁盘而不是在浏览器中显示。
1307
+
1308
+ ~~~~ {.ruby}
1309
+ get '/' do
1310
+ attachment
1311
+ "store it!"
1312
+ end
1313
+ ~~~~
1314
+
1315
+ 你也可以传递一个文件名:
1316
+
1317
+ ~~~~ {.ruby}
1318
+ get '/' do
1319
+ attachment "info.txt"
1320
+ "store it!"
1321
+ end
1322
+ ~~~~
1323
+
1324
+ ### 查找模板文件
1325
+
1326
+ `find_template` 辅助方法被用于在渲染时查找模板文件:
1327
+
1328
+ ~~~~ {.ruby}
1329
+ find_template settings.views, 'foo', Tilt[:haml] do |file|
1330
+ puts "could be #{file}"
1331
+ end
1332
+ ~~~~
1333
+
1334
+ 这并不是很有用。但是在你需要重载这个方法
1335
+ 来实现你自己的查找机制的时候有用。 比如,如果你想支持多于一个视图目录:
1336
+
1337
+ ~~~~ {.ruby}
1338
+ set :views, ['views', 'templates']
1339
+
1340
+ helpers do
1341
+ def find_template(views, name, engine, &block)
1342
+ Array(views).each { |v| super(v, name, engine, &block) }
1343
+ end
1344
+ end
1345
+ ~~~~
1346
+
1347
+ 另一个例子是为不同的引擎使用不同的目录:
1348
+
1349
+ ~~~~ {.ruby}
1350
+ set :views, :sass => 'views/sass', :haml => 'templates', :default => 'views'
1351
+
1352
+ helpers do
1353
+ def find_template(views, name, engine, &block)
1354
+ _, folder = views.detect { |k,v| engine == Tilt[k] }
1355
+ folder ||= views[:default]
1356
+ super(folder, name, engine, &block)
1357
+ end
1358
+ end
1359
+ ~~~~
1360
+
1361
+ 你可以很容易地包装成一个扩展然后与他人分享!
1362
+
1363
+ 请注意 `find_template` 并不会检查文件真的存在,
1364
+ 而是对任何可能的路径调用给入的代码块。这并不会带来性能问题, 因为
1365
+ `render` 会在找到文件的时候马上使用 `break` 。
1366
+ 同样的,模板的路径(和内容)会在除development mode以外的场合
1367
+ 被缓存。你应该时刻提醒自己这一点, 如果你真的想写一个非常疯狂的方法。
1368
+
1369
+ ## 配置
1370
+
1371
+ 运行一次,在启动的时候,在任何环境下:
1372
+
1373
+ ~~~~ {.ruby}
1374
+ configure do
1375
+ # setting one option
1376
+ set :option, 'value'
1377
+
1378
+ # setting multiple options
1379
+ set :a => 1, :b => 2
1380
+
1381
+ # same as `set :option, true`
1382
+ enable :option
1383
+
1384
+ # same as `set :option, false`
1385
+ disable :option
1386
+
1387
+ # you can also have dynamic settings with blocks
1388
+ set(:css_dir) { File.join(views, 'css') }
1389
+ end
1390
+ ~~~~
1391
+
1392
+ 只当环境 (RACK\_ENV environment 变量) 被设定为 `:production`的时候运行:
1393
+
1394
+ ~~~~ {.ruby}
1395
+ configure :production do
1396
+ ...
1397
+ end
1398
+ ~~~~
1399
+
1400
+ 当环境被设定为 `:production` 或者 `:test`的时候运行:
1401
+
1402
+ ~~~~ {.ruby}
1403
+ configure :production, :test do
1404
+ ...
1405
+ end
1406
+ ~~~~
1407
+
1408
+ 你可以使用 `settings` 获得这些配置:
1409
+
1410
+ ~~~~ {.ruby}
1411
+ configure do
1412
+ set :foo, 'bar'
1413
+ end
1414
+
1415
+ get '/' do
1416
+ settings.foo? # => true
1417
+ settings.foo # => 'bar'
1418
+ ...
1419
+ end
1420
+ ~~~~
1421
+
1422
+ ### 可选的设置
1423
+
1424
+ <dl>
1425
+ <dt>absolute_redirects</dt>
1426
+ <dd>
1427
+ <p>
1428
+ 如果被禁用,Sinatra会允许使用相对路径重定向, 但是,Sinatra就不再遵守
1429
+ RFC 2616标准 (HTTP 1.1), 该标准只允许绝对路径重定向。
1430
+
1431
+ <p>
1432
+ 如果你的应用运行在一个未恰当设置的反向代理之后,
1433
+ 你需要启用这个选项。注意 <tt>url</tt> 辅助方法 仍然会生成绝对 URL,除非你传入
1434
+ <tt>false</tt> 作为第二参数。
1435
+
1436
+ <p>
1437
+ 默认禁用。
1438
+ </dd>
1439
+
1440
+ <dt>add_charsets</dt>
1441
+ <dd>
1442
+ <p>
1443
+ 设定 <tt>content_type</tt> 辅助方法会 自动加上字符集信息的多媒体类型。
1444
+ </p>
1445
+
1446
+ <p>
1447
+ 你应该添加而不是覆盖这个选项:
1448
+ <tt>settings.add_charsets << "application/foobar"</tt>
1449
+ </p>
1450
+ </dd>
1451
+
1452
+ <dt>app_file</dt>
1453
+ <dd>
1454
+ 主应用文件,用来检测项目的根路径, views和public文件夹和内联模板。
1455
+ </dd>
1456
+
1457
+ <dt>bind</dt>
1458
+ <dd>
1459
+ 绑定的IP 地址 (默认: 0.0.0.0)。 仅对于内置的服务器有用。
1460
+ </dd>
1461
+
1462
+ <dt>default_encoding</dt>
1463
+ <dd>
1464
+ 默认编码 (默认为 <tt>"utf-8"</tt>)。
1465
+ </dd>
1466
+
1467
+ <dt>dump_errors</dt>
1468
+ <dd>
1469
+ 在log中显示错误。
1470
+ </dd>
1471
+
1472
+ <dt>environment</dt>
1473
+ <dd>
1474
+ 当前环境,默认是 <tt>ENV['RACK_ENV']</tt>, 或者 <tt>"development"</tt> 如果不可用。
1475
+ </dd>
1476
+
1477
+ <dt>logging</dt>
1478
+ <dd>
1479
+ 使用logger
1480
+ </dd>
1481
+
1482
+ <dt>lock</dt>
1483
+ <dd>
1484
+ <p>
1485
+ 对每一个请求放置一个锁, 只使用进程并发处理请求。
1486
+ </p>
1487
+
1488
+ <p>
1489
+ 如果你的应用不是线程安全则需启动。 默认禁用。
1490
+ </p>
1491
+ </dd>
1492
+
1493
+ <dt>method_override</dt>
1494
+ <dd>
1495
+ 使用 <tt>_method</tt> 魔法以允许在旧的浏览器中在 表单中使用 put/delete 方法
1496
+ </dd>
1497
+
1498
+ <dt>port</dt>
1499
+ <dd>
1500
+ 监听的端口号。只对内置服务器有用。
1501
+ </dd>
1502
+
1503
+ <dt>prefixed_redirects</dt>
1504
+ <dd>
1505
+ 是否添加 <tt>request.script_name</tt> 到
1506
+ 重定向请求,如果没有设定绝对路径。那样的话 <tt>redirect '/foo'</tt> 会和
1507
+ <tt>redirect to('/foo')</tt>起相同作用。默认禁用。
1508
+ </dd>
1509
+
1510
+ <dt>public_folder</dt>
1511
+ <dd>
1512
+ public文件夹的位置。
1513
+ </dd>
1514
+
1515
+ <dt>reload_templates</dt>
1516
+ <dd>
1517
+ 是否每个请求都重新载入模板。 在development mode和 Ruby 1.8.6
1518
+ 中被企业(用来 消除一个Ruby内存泄漏的bug)。
1519
+ </dd>
1520
+
1521
+ <dt>root</dt>
1522
+ <dd>
1523
+ 项目的根目录。
1524
+ </dd>
1525
+
1526
+ <dt>raise_errors</dt>
1527
+ <dd>
1528
+ 抛出异常(应用会停下)。
1529
+ </dd>
1530
+
1531
+ <dt>run</dt>
1532
+ <dd>
1533
+ 如果启用,Sinatra会开启web服务器。 如果使用rackup或其他方式则不要启用。
1534
+ </dd>
1535
+
1536
+ <dt>running</dt>
1537
+ <dd>
1538
+ 内置的服务器在运行吗? 不要修改这个设置!
1539
+ </dd>
1540
+
1541
+ <dt>server</dt>
1542
+ <dd>
1543
+ 服务器,或用于内置服务器的列表。 默认是 [‘thin’, ‘mongrel’, ‘webrick’],
1544
+ 顺序表明了 优先级。
1545
+ </dd>
1546
+
1547
+ <dt>sessions</dt>
1548
+ <dd>
1549
+ 开启基于cookie的sesson。
1550
+ </dd>
1551
+
1552
+ <dt>show_exceptions</dt>
1553
+ <dd>
1554
+ 在浏览器中显示一个stack trace。
1555
+ </dd>
1556
+
1557
+ <dt>static</dt>
1558
+ <dd>
1559
+ Sinatra是否处理静态文件。 当服务器能够处理则禁用。 禁用会增强性能。
1560
+ 默认开启。
1561
+ </dd>
1562
+
1563
+ <dt>views</dt>
1564
+ <dd>
1565
+ views 文件夹。
1566
+ </dd>
1567
+ </dl>
1568
+
1569
+ ## 错误处理
1570
+
1571
+ 错误处理在与路由和前置过滤器相同的上下文中运行,
1572
+ 这意味着你可以使用许多好东西,比如 `haml`, `erb`, `halt`,等等。
1573
+
1574
+ ### 未找到
1575
+
1576
+ 当一个 `Sinatra::NotFound` 错误被抛出的时候,
1577
+ 或者响应状态码是404,`not_found` 处理器会被调用:
1578
+
1579
+ ~~~~ {.ruby}
1580
+ not_found do
1581
+ 'This is nowhere to be found'
1582
+ end
1583
+ ~~~~
1584
+
1585
+ ### 错误
1586
+
1587
+ `error` 处理器,在任何路由代码块或者过滤器抛出异常的时候会被调用。
1588
+ 异常对象可以通过`sinatra.error` Rack 变量获得:
1589
+
1590
+ ~~~~ {.ruby}
1591
+ error do
1592
+ 'Sorry there was a nasty error - ' + env['sinatra.error'].name
1593
+ end
1594
+ ~~~~
1595
+
1596
+ 自定义错误:
1597
+
1598
+ ~~~~ {.ruby}
1599
+ error MyCustomError do
1600
+ 'So what happened was...' + env['sinatra.error'].message
1601
+ end
1602
+ ~~~~
1603
+
1604
+ 那么,当这个发生的时候:
1605
+
1606
+ ~~~~ {.ruby}
1607
+ get '/' do
1608
+ raise MyCustomError, 'something bad'
1609
+ end
1610
+ ~~~~
1611
+
1612
+ 你会得到:
1613
+
1614
+ So what happened was... something bad
1615
+
1616
+ 另一种替代方法是,为一个状态码安装错误处理器:
1617
+
1618
+ ~~~~ {.ruby}
1619
+ error 403 do
1620
+ 'Access forbidden'
1621
+ end
1622
+
1623
+ get '/secret' do
1624
+ 403
1625
+ end
1626
+ ~~~~
1627
+
1628
+ 或者一个范围:
1629
+
1630
+ ~~~~ {.ruby}
1631
+ error 400..510 do
1632
+ 'Boom'
1633
+ end
1634
+ ~~~~
1635
+
1636
+ 在运行在development环境下时,Sinatra会安装特殊的 `not_found` 和 `error`
1637
+ 处理器。
1638
+
1639
+ ## Rack 中间件
1640
+
1641
+ Sinatra 依靠 [Rack](http://rack.rubyforge.org/), 一个面向Ruby
1642
+ web框架的最小标准接口。
1643
+ Rack的一个最有趣的面向应用开发者的能力是支持“中间件”——坐落在服务器和你的应用之间,
1644
+ 监视 并/或 操作HTTP请求/响应以 提供多样类型的常用功能。
1645
+
1646
+ Sinatra 让建立Rack中间件管道异常简单, 通过顶层的 `use` 方法:
1647
+
1648
+ ~~~~ {.ruby}
1649
+ require 'sinatra'
1650
+ require 'my_custom_middleware'
1651
+
1652
+ use Rack::Lint
1653
+ use MyCustomMiddleware
1654
+
1655
+ get '/hello' do
1656
+ 'Hello World'
1657
+ end
1658
+ ~~~~
1659
+
1660
+ `use` 的语义和在
1661
+ [Rack::Builder](http://rack.rubyforge.org/doc/classes/Rack/Builder.html)
1662
+ DSL(在rack文件中最频繁使用)中定义的完全一样。例如,`use` 方法接受
1663
+ 多个/可变 参数,包括代码块:
1664
+
1665
+ ~~~~ {.ruby}
1666
+ use Rack::Auth::Basic do |username, password|
1667
+ username == 'admin' && password == 'secret'
1668
+ end
1669
+ ~~~~
1670
+
1671
+ Rack中分布有多样的标准中间件,针对日志,
1672
+ 调试,URL路由,认证和session处理。 Sinatra会自动使用这里面的大部分组件,
1673
+ 所以你一般不需要显示地 `use` 他们。
1674
+
1675
+ ## 测试
1676
+
1677
+ Sinatra的测试可以使用任何基于Rack的测试程序库或者框架来编写。
1678
+ [Rack::Test](http://gitrdoc.com/brynary/rack-test) 是推荐候选:
1679
+
1680
+ ~~~~ {.ruby}
1681
+ require 'my_sinatra_app'
1682
+ require 'test/unit'
1683
+ require 'rack/test'
1684
+
1685
+ class MyAppTest < Test::Unit::TestCase
1686
+ include Rack::Test::Methods
1687
+
1688
+ def app
1689
+ Sinatra::Application
1690
+ end
1691
+
1692
+ def test_my_default
1693
+ get '/'
1694
+ assert_equal 'Hello World!', last_response.body
1695
+ end
1696
+
1697
+ def test_with_params
1698
+ get '/meet', :name => 'Frank'
1699
+ assert_equal 'Hello Frank!', last_response.body
1700
+ end
1701
+
1702
+ def test_with_rack_env
1703
+ get '/', {}, 'HTTP_USER_AGENT' => 'Songbird'
1704
+ assert_equal "You're using Songbird!", last_response.body
1705
+ end
1706
+ end
1707
+ ~~~~
1708
+
1709
+ 请注意: 内置的 Sinatra::Test 模块和 Sinatra::TestHarness 类 在 0.9.2
1710
+ 版本已废弃。
1711
+
1712
+ ## Sinatra::Base - 中间件,程序库和模块化应用
1713
+
1714
+ 把你的应用定义在顶层,对于微型应用这会工作得很好,
1715
+ 但是在构建可复用的组件时候会带来客观的不利, 比如构建Rack中间件,Rails
1716
+ metal,带有服务器组件的简单程序库,
1717
+ 或者甚至是Sinatra扩展。顶层的DSL污染了Object命名空间,
1718
+ 并假定了一个微型应用风格的配置 (例如, 单一的应用文件, ./public 和
1719
+ ./views 目录,日志,异常细节页面,等等)。 这时应该让 Sinatra::Base
1720
+ 走到台前了:
1721
+
1722
+ ~~~~ {.ruby}
1723
+ require 'sinatra/base'
1724
+
1725
+ class MyApp < Sinatra::Base
1726
+ set :sessions, true
1727
+ set :foo, 'bar'
1728
+
1729
+ get '/' do
1730
+ 'Hello world!'
1731
+ end
1732
+ end
1733
+ ~~~~
1734
+
1735
+ Sinatra::Base子类可用的方法实际上就是通过顶层 DSL 可用的方法。
1736
+ 大部分顶层应用可以通过两个改变转换成Sinatra::Base组件:
1737
+
1738
+ - 你的文件应当引入 `sinatra/base` 而不是 `sinatra`;
1739
+ 否则,所有的Sinatra的 DSL 方法将会被引进到 主命名空间。
1740
+
1741
+ - 把你的应用的路由,错误处理,过滤器和选项放在
1742
+ 一个Sinatra::Base的子类中。
1743
+
1744
+ `+Sinatra::Base+` 是一张白纸。大部分的选项默认是禁用的,
1745
+ 包含内置的服务器。参见
1746
+ [选项和配置](http://sinatra.github.com/configuration.html)
1747
+ 查看可用选项的具体细节和他们的行为。
1748
+
1749
+ ### 模块化 vs. 传统的方式
1750
+
1751
+ 与通常的认识相反,传统的方式没有任何错误。
1752
+ 如果它适合你的应用,你不需要转换到模块化的应用。
1753
+
1754
+ 和模块化方式相比只有两个缺点:
1755
+
1756
+ - 你对每个Ruby进程只能定义一个Sinatra应用,如果你需要更多,
1757
+ 切换到模块化方式。
1758
+
1759
+ - 传统方式使用代理方法污染了 Object 。如果你打算 把你的应用封装进一个
1760
+ library/gem,转换到模块化方式。
1761
+
1762
+ 没有任何原因阻止你混合模块化和传统方式。
1763
+
1764
+ 如果从一种转换到另一种,你需要注意settings中的 一些微小的不同:
1765
+
1766
+ Setting Classic Modular
1767
+
1768
+ app_file file loading sinatra nil
1769
+ run $0 == app_file false
1770
+ logging true false
1771
+ method_override true false
1772
+ inline_templates true false
1773
+
1774
+ ### 运行一个模块化应用
1775
+
1776
+ 有两种方式运行一个模块化应用,使用 `run!`来运行:
1777
+
1778
+ ~~~~ {.ruby}
1779
+ # my_app.rb
1780
+ require 'sinatra/base'
1781
+
1782
+ class MyApp < Sinatra::Base
1783
+ # ... app code here ...
1784
+
1785
+ # start the server if ruby file executed directly
1786
+ run! if app_file == $0
1787
+ end
1788
+ ~~~~
1789
+
1790
+ 运行:
1791
+
1792
+ ruby my_app.rb
1793
+
1794
+ 或者使用一个 `config.ru`,允许你使用任何Rack处理器:
1795
+
1796
+ ~~~~ {.ruby}
1797
+ # config.ru
1798
+ require './my_app'
1799
+ run MyApp
1800
+ ~~~~
1801
+
1802
+ 运行:
1803
+
1804
+ rackup -p 4567
1805
+
1806
+ ### 使用config.ru运行传统方式的应用
1807
+
1808
+ 编写你的应用:
1809
+
1810
+ ~~~~ {.ruby}
1811
+ # app.rb
1812
+ require 'sinatra'
1813
+
1814
+ get '/' do
1815
+ 'Hello world!'
1816
+ end
1817
+ ~~~~
1818
+
1819
+ 加入相应的 `config.ru`:
1820
+
1821
+ ~~~~ {.ruby}
1822
+ require './app'
1823
+ run Sinatra::Application
1824
+ ~~~~
1825
+
1826
+ ### 什么时候用 config.ru?
1827
+
1828
+ 以下情况你可能需要使用 `config.ru`:
1829
+
1830
+ - 你要使用不同的 Rack 处理器部署 (Passenger, Unicorn, Heroku, …).
1831
+
1832
+ - 你想使用一个或者多个 `Sinatra::Base`的子类.
1833
+
1834
+ - 你只想把Sinatra当作中间件使用,而不是端点。
1835
+
1836
+ **你并不需要切换到`config.ru`仅仅因为你切换到模块化方式,
1837
+ 你同样不需要切换到模块化方式, 仅仅因为要运行 `config.ru`.**
1838
+
1839
+ ### 把Sinatra当成中间件来使用
1840
+
1841
+ 不仅Sinatra有能力使用其他的Rack中间件,任何Sinatra
1842
+ 应用程序都可以反过来自身被当作中间件,被加在任何Rack端点前面。
1843
+ 这个端点可以是任何Sinatra应用,或者任何基于Rack的应用程序
1844
+ (Rails/Ramaze/Camping/…)。
1845
+
1846
+ ~~~~ {.ruby}
1847
+ require 'sinatra/base'
1848
+
1849
+ class LoginScreen < Sinatra::Base
1850
+ enable :sessions
1851
+
1852
+ get('/login') { haml :login }
1853
+
1854
+ post('/login') do
1855
+ if params[:name] = 'admin' and params[:password] = 'admin'
1856
+ session['user_name'] = params[:name]
1857
+ else
1858
+ redirect '/login'
1859
+ end
1860
+ end
1861
+ end
1862
+
1863
+ class MyApp < Sinatra::Base
1864
+ # 在前置过滤器前运行中间件
1865
+ use LoginScreen
1866
+
1867
+ before do
1868
+ unless session['user_name']
1869
+ halt "Access denied, please <a href='/login'>login</a>."
1870
+ end
1871
+ end
1872
+
1873
+ get('/') { "Hello #{session['user_name']}." }
1874
+ end
1875
+ ~~~~
1876
+
1877
+ ## 变量域和绑定
1878
+
1879
+ 当前所在的变量域决定了哪些方法和变量是可用的。
1880
+
1881
+ ### 应用/类 变量域
1882
+
1883
+ 每个Sinatra应用相当与Sinatra::Base的一个子类。
1884
+ 如果你在使用顶层DSL(`require 'sinatra'`),那么这个类就是
1885
+ Sinatra::Application,或者这个类就是你显式创建的子类。
1886
+ 在类层面,你具有的方法类似于 \`get\` 或者 \`before\`,但是你不能访问
1887
+ \`request\` 对象或者 \`session\`, 因为对于所有的请求,
1888
+ 只有单一的应用类。
1889
+
1890
+ 通过 \`set\` 创建的选项是类层面的方法:
1891
+
1892
+ ~~~~ {.ruby}
1893
+ class MyApp < Sinatra::Base
1894
+ # 嘿,我在应用变量域!
1895
+ set :foo, 42
1896
+ foo # => 42
1897
+
1898
+ get '/foo' do
1899
+ # 嘿,我不再处于应用变量域了!
1900
+ end
1901
+ end
1902
+ ~~~~
1903
+
1904
+ 在下列情况下你将拥有应用变量域的绑定:
1905
+
1906
+ - 在应用类中
1907
+
1908
+ - 在扩展中定义的方法
1909
+
1910
+ - 传递给 \`helpers\` 的代码块
1911
+
1912
+ - 用作\`set\`值的过程/代码块
1913
+
1914
+ 你可以访问变量域对象(就是应用类)就像这样:
1915
+
1916
+ - 通过传递给代码块的对象 (`configure { |c| ... }`)
1917
+
1918
+ - 在请求变量域中使用\`settings\`
1919
+
1920
+ ### 请求/实例 变量域
1921
+
1922
+ 对于每个进入的请求,一个新的应用类的实例会被创建
1923
+ 所有的处理器代码块在该变量域被运行。在这个变量域中, 你可以访问
1924
+ \`request\` 和 \`session\` 对象,或者调用渲染方法比如 \`erb\` 或者
1925
+ \`haml\`。你可以在请求变量域当中通过\`settings\`辅助方法
1926
+ 访问应用变量域:
1927
+
1928
+ ~~~~ {.ruby}
1929
+ class MyApp < Sinatra::Base
1930
+ # 嘿,我在应用变量域!
1931
+ get '/define_route/:name' do
1932
+ # 针对 '/define_route/:name' 的请求变量域
1933
+ @value = 42
1934
+
1935
+ settings.get("/#{params[:name]}") do
1936
+ # 针对 "/#{params[:name]}" 的请求变量域
1937
+ @value # => nil (并不是相同的请求)
1938
+ end
1939
+
1940
+ "Route defined!"
1941
+ end
1942
+ end
1943
+ ~~~~
1944
+
1945
+ 在以下情况将获得请求变量域:
1946
+
1947
+ - get/head/post/put/delete 代码块
1948
+
1949
+ - 前置/后置 过滤器
1950
+
1951
+ - 辅助方法
1952
+
1953
+ - 模板/视图
1954
+
1955
+ ### 代理变量域
1956
+
1957
+ 代理变量域只是把方法转送到类变量域。可是,
1958
+ 他并非表现得100%类似于类变量域, 因为你并不能获得类的绑定:
1959
+ 只有显式地标记为供代理使用的方法才是可用的,
1960
+ 而且你不能和类变量域共享变量/状态。(解释:你有了一个不同的 \`self\`)。
1961
+ 你可以显式地增加方法代理,通过调用
1962
+ `Sinatra::Delegator.delegate :method_name`。
1963
+
1964
+ 在以下情况将获得代理变量域:
1965
+
1966
+ - 顶层的绑定,如果你做过 `require "sinatra"`
1967
+
1968
+ - 在扩展了 \`Sinatra::Delegator\` mixin的对象
1969
+
1970
+ 自己在这里看一下代码: [Sinatra::Delegator
1971
+ mixin](http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/base.rb#L1128)
1972
+ 已经
1973
+ [被包含进了主命名空间](http://github.com/sinatra/sinatra/blob/ceac46f0bc129a6e994a06100aa854f606fe5992/lib/sinatra/main.rb#L28)。
1974
+
1975
+ ## 命令行
1976
+
1977
+ Sinatra 应用可以被直接运行:
1978
+
1979
+ ruby myapp.rb [-h] [-x] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]
1980
+
1981
+ 选项是:
1982
+
1983
+ -h # help
1984
+ -p # 设定端口 (默认是 4567)
1985
+ -o # 设定主机名 (默认是 0.0.0.0)
1986
+ -e # 设定环境 (默认是 development)
1987
+ -s # 限定 rack 服务器/处理器 (默认是 thin)
1988
+ -x # 打开互斥锁 (默认是 off)
1989
+
1990
+ ## 必要条件
1991
+
1992
+ 推荐在 Ruby 1.8.7, 1.9.2, JRuby 或者 Rubinius 上安装Sinatra。
1993
+
1994
+ 下面的Ruby版本是官方支持的:
1995
+
1996
+ <dl>
1997
+ <dt>Ruby 1.8.6</dt>
1998
+ <dd>
1999
+ 不推荐在1.8.6上安装Sinatra, 但是直到Sinatra
2000
+ 1.3.0发布才会放弃对它的支持。 RDoc 和
2001
+ CoffeScript模板不被这个Ruby版本支持。
2002
+ 1.8.6在它的Hash实现中包含一个内存泄漏问题,
2003
+ 该问题会被1.1.1版本之前的Sinatra引发。
2004
+ 当前版本使用性能下降的代价排除了这个问题。你需要把Rack降级到1.1.x,
2005
+ 因为Rack \>= 1.2不再支持1.8.6。
2006
+ </dd>
2007
+
2008
+ <dt>Ruby 1.8.7</dt>
2009
+ <dd>
2010
+ 1.8.7 被完全支持,但是,如果没有特别原因, 我们推荐你升级到 1.9.2
2011
+ 或者切换到 JRuby 或者 Rubinius.
2012
+ </dd>
2013
+
2014
+ <dt>Ruby 1.9.2</dt>
2015
+ <dd>
2016
+ 1.9.2 被支持而且推荐。注意 Radius 和 Markaby 模板并不和1.9兼容。不要使用
2017
+ 1.9.2p0, 它被已知会产生 segmentation faults.
2018
+ </dd>
2019
+
2020
+ <dt>Rubinius</dt>
2021
+ <dd>
2022
+ Rubinius 被官方支持 (Rubinius \>= 1.2.2), 除了Textile模板。
2023
+ </dd>
2024
+
2025
+ <dt>JRuby</dt>
2026
+ <dd>
2027
+ JRuby 被官方支持 (JRuby \>= 1.5.6)。 目前未知和第三方模板库有关的问题,
2028
+ 但是,如果你选择了JRuby,请查看一下JRuby rack 处理器, 因为 Thin web
2029
+ 服务器还没有在JRuby上获得支持。
2030
+ </dd>
2031
+ </dl>
2032
+
2033
+ 我们也会时刻关注新的Ruby版本。
2034
+
2035
+ 下面的 Ruby 实现没有被官方支持, 但是已知可以运行 Sinatra:
2036
+
2037
+ - JRuby 和 Rubinius 老版本
2038
+
2039
+ - MacRuby
2040
+
2041
+ - Maglev
2042
+
2043
+ - IronRuby
2044
+
2045
+ - Ruby 1.9.0 and 1.9.1
2046
+
2047
+ 不被官方支持的意思是,如果在不被支持的平台上有运行错误,
2048
+ 我们假定不是我们的问题,而是平台的问题。
2049
+
2050
+ Sinatra应该会运行在任何支持上述Ruby实现的操作系统。
2051
+
2052
+ ## 紧追前沿
2053
+
2054
+ 如果你喜欢使用 Sinatra 的最新鲜的代码,请放心的使用 master
2055
+ 分支来运行你的程序,它会非常的稳定。
2056
+
2057
+ cd myapp
2058
+ git clone git://github.com/sinatra/sinatra.git
2059
+ ruby -Isinatra/lib myapp.rb
2060
+
2061
+ 我们也会不定期的发布预发布gems,所以你也可以运行
2062
+
2063
+ gem install sinatra --pre
2064
+
2065
+ 来获得最新的特性。
2066
+
2067
+ ### 通过Bundler
2068
+
2069
+ 如果你想使用最新的Sinatra运行你的应用,通过
2070
+ [Bundler](http://gembundler.com/) 是推荐的方式。
2071
+
2072
+ 首先,安装bundler,如果你还没有安装:
2073
+
2074
+ gem install bundler
2075
+
2076
+ 然后,在你的项目目录下,创建一个 `Gemfile`:
2077
+
2078
+ ~~~~ {.ruby}
2079
+ source :rubygems
2080
+ gem 'sinatra', :git => "git://github.com/sinatra/sinatra.git"
2081
+
2082
+ # 其他的依赖关系
2083
+ gem 'haml' # 举例,如果你想用haml
2084
+ gem 'activerecord', '~> 3.0' # 也许你还需要 ActiveRecord 3.x
2085
+ ~~~~
2086
+
2087
+ 请注意在这里你需要列出你的应用的所有依赖关系。 Sinatra的直接依赖关系
2088
+ (Rack and Tilt) 将会, 自动被Bundler获取和添加。
2089
+
2090
+ 现在你可以像这样运行你的应用:
2091
+
2092
+ bundle exec ruby myapp.rb
2093
+
2094
+ ### 使用自己的
2095
+
2096
+ 创建一个本地克隆并通过 `sinatra/lib` 目录运行你的应用, 通过
2097
+ `$LOAD_PATH`:
2098
+
2099
+ cd myapp
2100
+ git clone git://github.com/sinatra/sinatra.git
2101
+ ruby -Isinatra/lib myapp.rb
2102
+
2103
+ 为了在未来更新 Sinatra 源代码:
2104
+
2105
+ cd myapp/sinatra
2106
+ git pull
2107
+
2108
+ ### 全局安装
2109
+
2110
+ 你可以自行编译 gem :
2111
+
2112
+ git clone git://github.com/sinatra/sinatra.git
2113
+ cd sinatra
2114
+ rake sinatra.gemspec
2115
+ rake install
2116
+
2117
+ 如果你以root身份安装 gems,最后一步应该是
2118
+
2119
+ sudo rake install
2120
+
2121
+ ## 更多
2122
+
2123
+ - [项目主页(英文)](http://www.sinatrarb.com/) - 更多的文档,
2124
+ 新闻,和其他资源的链接。
2125
+
2126
+ - [贡献](http://www.sinatrarb.com/contributing) - 找到了一个bug?
2127
+ 需要帮助?有了一个 patch?
2128
+
2129
+ - [问题追踪](http://github.com/sinatra/sinatra/issues)
2130
+
2131
+ - [Twitter](http://twitter.com/sinatra)
2132
+
2133
+ - [邮件列表](http://groups.google.com/group/sinatrarb/topics)
2134
+
2135
+ - [IRC: \#sinatra](irc://chat.freenode.net/#sinatra) on
2136
+ [freenode.net](http://freenode.net)