Skip to content

Latest commit

 

History

History
1141 lines (775 loc) · 34.4 KB

README.jp.md

File metadata and controls

1141 lines (775 loc) · 34.4 KB

Sinatra

注) 本文書は英語から翻訳したものであり、その内容が最新でない場合もあります。最新の情報はオリジナルの英語版を参照して下さい。

DSLです。

# myapp.rb
require 'sinatra'
get '/' do
  'Hello world!'
end

gemをインストールして動かしてみる。

gem install sinatra
ruby myapp.rb

localhost:4567 を見る。

ルート

Sinatraでは、ルートはHTTPメソッドとURLマッチングパターンがペアになっています。 ルートはブロックに結び付けられています。

get '/' do
  .. 何か見せる ..
end

post '/' do
  .. 何か生成する ..
end

put '/' do
  .. 何か更新する ..
end

patch '/' do
  .. 何か修正する ..
end

delete '/' do
  .. 何か削除する ..
end

options '/' do
  .. 何か満たす ..
end

link '/' do
  .. 何かリンクを張る ..
end

unlink '/' do
  .. 何かアンリンクする ..
end

ルートは定義された順番にマッチします。 リクエストに最初にマッチしたルートが呼び出されます。

ルートのパターンは名前付きパラメータを含むことができ、 paramsハッシュで取得できます。

get '/hello/:name' do
  # "GET /hello/foo" と "GET /hello/bar" にマッチ
  # params[:name] は 'foo' か 'bar'
  "Hello #{params[:name]}!"
end

また、ブロックパラメータで名前付きパラメータにアクセスすることもできます。

get '/hello/:name' do |n|
  # "GET /hello/foo" と "GET /hello/bar" にマッチ
  # params[:name] は 'foo' か 'bar'
  # n が params[:name] を保持
  "Hello #{n}!"
end

ルートパターンはsplat(またはワイルドカード)を含むこともでき、 params[:splat] で取得できます。

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

ブロックパラーメータを使用した場合:

get '/download/*.*' do |path, ext|
  [path, ext] # => ["path/to/file", "xml"]
end

正規表現を使用した場合:

get %r{/hello/([\w]+)} do
  "Hello, #{params[:captures].first}!"
end

ブロックパラーメータを使用した場合:

get %r{/hello/([\w]+)} do |c|
  "Hello, #{c}!"
end

オプショナルパラメーターを使用した場合:

get '/posts.?:format?' do
  # "GET /posts" と "GET /posts.json", "GET /posts.xml" の拡張子などにマッチ
end

ところで、ディレクトリトラバーサル保護機能を無効にしないと(下記参照)、 ルートにマッチする前にリクエストパスが修正される可能性があります。

条件

ルートにはユーザエージェントのようなさまざまな条件を含めることができます。

get '/foo', :agent => /Songbird (\d\.\d)[\d\/]*?/ do
  "You're using Songbird version #{params[:agent][0]}"
end

get '/foo' do
  # Matches non-songbird browsers
end

ほかにhost_nameprovides条件が利用可能です:

get '/', :host_name => /^admin\./ do
  "Admin Area, Access denied!"
end

get '/', :provides => 'html' do
  haml :index
end

get '/', :provides => ['rss', 'atom', 'xml'] do
  builder :feed
end

独自の条件を定義することも簡単にできます:

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ボディオブジェクト、HTTPステータスコードのいずれかとして 妥当なオブジェクトであればどのようなオブジェクトでも返すことができます:

  • 3要素の配列: [ステータス(Fixnum), ヘッダ(Hash), レスポンスボディ(#eachに応答する)]

  • 2要素の配列: [ステータス(Fixnum), レスポンスボディ(#eachに応答する)]

  • #eachに応答し、与えられたブロックに文字列を渡すオブジェクト

  • ステータスコードを表現するFixnum

そのように、例えばストリーミングの例を簡単に実装することができます:

class Stream
  def each
    100.times { |i| yield "#{i}\n" }
  end
end

get('/') { Stream.new }

静的ファイル

静的ファイルは./publicディレクトリから配信されます。 :public_folderオプションを指定することで別の場所を指定することができます。

set :public_folder, File.dirname(__FILE__) + '/static'

注意: この静的ファイル用のディレクトリ名はURL中に含まれません。 例えば、./public/css/style.csshttp://example.com/css/style.cssでアクセスできます。

ビュー / テンプレート

テンプレートは./viewsディレクトリ下に配置されています。 他のディレクトリを使用する場合の例:

set :views, File.dirname(__FILE__) + '/templates'

テンプレートはシンボルを使用して参照させることを覚えておいて下さい。 サブデレクトリでもこの場合は:'subdir/template'のようにします。 レンダリングメソッドは文字列が渡されると、そのまま文字列を出力します。

Haml テンプレート

hamlを使うにはhamlライブラリが必要です:

# hamlを読み込みます
require 'haml'

get '/' do
  haml :index
end

./views/index.hamlを表示します。

Haml’s options はSinatraの設定でグローバルに設定することができます。 Options and Configurations, を参照してそれぞれ設定を上書きして下さい。

set :haml, {:format => :html5 } # デフォルトのフォーマットは:xhtml

get '/' do
  haml :index, :haml_options => {:format => :html4 } # 上書き
end

Erb テンプレート

# erbを読み込みます
require 'erb'

get '/' do
  erb :index
end

./views/index.erbを表示します。

Erubis

erubisテンプレートを表示するには、erubisライブラリが必要です:

# erubisを読み込みます
require 'erubis'

get '/' do
  erubis :index
end

./views/index.erubisを表示します。

Builder テンプレート

builderを使うにはbuilderライブラリが必要です:

# builderを読み込みます
require 'builder'

get '/' do
  builder :index
end

./views/index.builderを表示します。

鋸 テンプレート

鋸を使うには鋸ライブラリが必要です:

# 鋸を読み込みます
require 'nokogiri'

get '/' do
  nokogiri :index
end

./views/index.nokogiriを表示します。

Sass テンプレート

Sassテンプレートを使うにはsassライブラリが必要です:

# hamlかsassを読み込みます
require 'sass'

get '/stylesheet.css' do
  sass :stylesheet
end

./views/stylesheet.sassを表示します。

Sass’ options はSinatraの設定でグローバルに設定することができます。 see Options and Configurations, を参照してそれぞれ設定を上書きして下さい。

set :sass, {:style => :compact } # デフォルトのSass styleは :nested

get '/stylesheet.css' do
  sass :stylesheet, :sass_options => {:style => :expanded } # 上書き
end

Scss テンプレート

Scssテンプレートを使うにはsassライブラリが必要です:

# hamlかsassを読み込みます
require 'sass'

get '/stylesheet.css' do
  scss :stylesheet
end

./views/stylesheet.scssを表示します。

Sass’ options はSinatraの設定でグローバルに設定することができます。 see Options and Configurations, を参照してそれぞれ設定を上書きして下さい。

set :scss, :style => :compact # デフォルトのScss styleは:nested

get '/stylesheet.css' do
  scss :stylesheet, :style => :expanded # 上書き
end

Less テンプレート

Lessテンプレートを使うにはlessライブラリが必要です:

# lessを読み込みます
require 'less'

get '/stylesheet.css' do
  less :stylesheet
end

./views/stylesheet.lessを表示します。

Liquid テンプレート

Liquidテンプレートを使うにはliquidライブラリが必要です:

# liquidを読み込みます
require 'liquid'

get '/' do
  liquid :index
end

./views/index.liquidを表示します。

LiquidテンプレートからRubyのメソッド(yieldを除く)を呼び出すことができないため、 ほぼ全ての場合にlocalsを指定する必要があるでしょう:

liquid :index, :locals => { :key => 'value' }

Markdown テンプレート

Markdownテンプレートを使うにはrdiscountライブラリが必要です:

# rdiscountを読み込みます
require "rdiscount"

get '/' do
  markdown :index
end

./views/index.markdownを表示します。(mdmkdも妥当な拡張子です)

markdownからメソッドを呼び出すことも、localsに変数を渡すこともできません。 それゆえ、他のレンダリングエンジンとの組み合わせで使うのが普通です:

erb :overview, :locals => { :text => markdown(:introduction) }

他のテンプレートからmarkdownメソッドを呼び出してもよいことに注意してください:

%h1 Hello From Haml!
%p= markdown(:greetings)

Textile テンプレート

Textileテンプレートを使うにはRedClothライブラリが必要です:

# redclothを読み込みます
require "redcloth"

get '/' do
  textile :index
end

./views/index.textileを表示します。

textileからメソッドを呼び出すことも、localsに変数を渡すこともできません。 それゆえ、他のレンダリングエンジンとの組み合わせで使うのが普通です:

erb :overview, :locals => { :text => textile(:introduction) }

他のテンプレートからtextileメソッドを呼び出してもよいことに注意してください:

%h1 Hello From Haml!
%p= textile(:greetings)

RDoc テンプレート

RDocテンプレートを使うにはRDocライブラリが必要です:

# rdoc/markup/to_htmlを読み込みます
require "rdoc"
require "rdoc/markup/to_html"

get '/' do
  rdoc :index
end

./views/index.rdocを表示します。

rdocからメソッドを呼び出すことも、localsに変数を渡すこともできません。 それゆえ、他のレンダリングエンジンとの組み合わせで使うのが普通です:

erb :overview, :locals => { :text => rdoc(:introduction) }

他のテンプレートからrdocメソッドを呼び出してもよいことに注意してください:

%h1 Hello From Haml!
%p= rdoc(:greetings)

Radius テンプレート

Radiusテンプレートを使うにはradiusライブラリが必要です:

# radiusを読み込みます
require 'radius'

get '/' do
  radius :index
end

./views/index.radiusを表示します。

RadiusテンプレートからRubyのメソッド(yieldを除く)を呼び出すことができないため、 ほぼ全ての場合にlocalsを指定する必要があるでしょう:

radius :index, :locals => { :key => 'value' }

Markaby テンプレート

Markabyテンプレートを使うにはmarkabyライブラリが必要です:

# markabyを読み込みます
require 'markaby'

get '/' do
  markaby :index
end

./views/index.mabを表示します。

RABL テンプレート

RABLテンプレートを使うにはrablライブラリが必要です:

# rablを読み込みます
require 'rabl'

get '/' do
  rabl :index
end

./views/index.rablを表示します。

Slim テンプレート

Slimテンプレートを使うにはslimライブラリが必要です:

# slimを読み込みます
require 'slim'

get '/' do
  slim :index
end

./views/index.slimを表示します。

Creole テンプレート

Creoleテンプレートを使うにはcreoleライブラリが必要です:

# creoleを読み込みます
require 'creole'

get '/' do
  creole :index
end

./views/index.creoleを表示します。

CoffeeScript テンプレート

CoffeeScriptテンプレートを表示するにはcoffee-scriptライブラリと`coffee`バイナリが必要です:

# coffee-scriptを読み込みます
require 'coffee-script'

get '/application.js' do
  coffee :application
end

./views/application.coffeeを表示します。

インラインテンプレート

get '/' do
  haml '%div.title Hello World'
end

文字列をテンプレートとして表示します。

テンプレート内で変数にアクセスする

テンプレートはルートハンドラと同じコンテキストの中で評価されます。. ルートハンドラでセットされたインスタンス変数は テンプレート内で直接使うことができます。

get '/:id' do
  @foo = Foo.find(params[:id])
  haml '%h1= @foo.name'
end

ローカル変数を明示的に定義することもできます。

get '/:id' do
  foo = Foo.find(params[:id])
  haml '%h1= foo.name', :locals => { :foo => foo }
end

このやり方は他のテンプレート内で部分テンプレートとして表示する時に典型的に使用されます。

ファイル内テンプレート

テンプレートはソースファイルの最後で定義することもできます。

require 'rubygems'
require 'sinatra'

get '/' do
  haml :index
end

__END__

@@ layout
%html
  = yield

@@ index
%div.title Hello world!!!!!

注意: sinatraをrequireするファイル内で定義されたファイル内テンプレートは自動的に読み込まれます。 他のファイルで定義されているテンプレートを使うには enable :inline_templatesを明示的に呼んでください。

名前付きテンプレート

テンプレートはトップレベルのtemplateメソッドで定義することができます。

template :layout do
  "%html\n  =yield\n"
end

template :index do
  '%div.title Hello World!'
end

get '/' do
  haml :index
end

「layout」というテンプレートが存在する場合、そのテンプレートファイルは他のテンプレートが 表示される度に使用されます。:layout => falseすることでlayoutsを無効にできます。

get '/' do
  haml :index, :layout => !request.xhr?
end

ヘルパー

トップレベルのhelpersを使用してルートハンドラやテンプレートで使うヘルパメソッドを 定義できます。

helpers do
  def bar(name)
    "#{name}bar"
  end
end

get '/:name' do
  bar(params[:name])
end

フィルタ

beforeフィルタはリクエストされたコンテキストを実行する前に評価され、 リクエストとレスポンスを変更することができます。フィルタ内でセットされた インスタンス変数はルーティングとテンプレートで使用できます。

before do
  @note = 'Hi!'
  request.path_info = '/foo/bar/baz'
end

get '/foo/*' do
  @note #=> 'Hi!'
  params[:splat] #=> 'bar/baz'
end

afterフィルタは同じコンテキストにあるリクエストの後に評価され、 同じくリクエストとレスポンスを変更することができます。 beforeフィルタとルートで設定されたインスタンス変数は、 afterフィルタからアクセスすることができます:

after do
  puts response.status
end

フィルタにはオプションとしてパターンを渡すことができ、 この場合はリクエストのパスがパターンにマッチした場合のみフィルタが評価されます:

before '/protected/*' do
  authenticate!
end

after '/create/:slug' do |slug|
  session[:last_slug] = slug
end

強制終了

ルートかbeforeフィルタ内で直ちに実行を終了する方法:

halt

ステータスを指定することができます:

halt 410

body部を指定することもできます …

halt 'ここにbodyを書く'

ステータスとbody部を指定する …

halt 401, '立ち去れ!'

ヘッダを指定:

halt 402, {'Content-Type' => 'text/plain'}, 'リベンジ'

パッシング(Passing)

ルートはpassを使って次のルートに飛ばすことができます:

get '/guess/:who' do
  pass unless params[:who] == 'Frank'
  "見つかっちゃった!"
end

get '/guess/*' do
  "はずれです!"
end

ルートブロックからすぐに抜け出し、次にマッチするルートを実行します。 マッチするルートが見当たらない場合は404が返されます。

リクエストオブジェクトへのアクセス

受信するリクエストオブジェクトは、`request`メソッドを通じてリクエストレベル(フィルタ、ルート、エラーハンドラ)からアクセスすることができます:

# アプリケーションが http://example.com/example で動作している場合
get '/foo' do
  request.body              # クライアントによって送信されたリクエストボディ(下記参照)
  request.scheme            # "http"
  request.script_name       # "/example"
  request.path_info         # "/foo"
  request.port              # 80
  request.request_method    # "GET"
  request.query_string      # ""
  request.content_length    # request.bodyの長さ
  request.media_type        # request.bodyのメディアタイプ
  request.host              # "example.com"
  request.get?              # true (他の動詞についても同様のメソッドあり)
  request.form_data?        # false
  request["SOME_HEADER"]    # SOME_HEADERヘッダの値
  request.referer           # クライアントのリファラまたは'/'
  request.user_agent        # ユーザエージェント (:agent 条件によって使用される)
  request.cookies           # ブラウザクッキーのハッシュ
  request.xhr?              # Ajaxリクエストかどうか
  request.url               # "http://example.com/example/foo"
  request.path              # "/example/foo"
  request.ip                # クライアントのIPアドレス
  request.secure?           # false
  request.env               # Rackによって渡された生のenvハッシュ
end

script_namepath_infoなどのオプションは次のように利用することもできます:

before { request.path_info = "/" }

get "/" do
  "全てのリクエストはここに来る"
end

request.bodyはIOまたはStringIOのオブジェクトです:

post "/api" do
  request.body.rewind  # 既に読まれているときのため
  data = JSON.parse request.body.read
  "Hello #{data['name']}!"
end

設定

どの環境でも起動時に1回だけ実行されます。

configure do
  ...
end

環境(RACK_ENV環境変数)が:productionに設定されている時だけ実行する方法:

configure :production do
  ...
end

環境が:production:testの場合に設定する方法:

configure :production, :test do
  ...
end

エラーハンドリング

エラーハンドラーはルートコンテキストとbeforeフィルタ内で実行します。 hamlerbhaltなどを使うこともできます。

Not Found

Sinatra::NotFoundが起きた時か レスポンスのステータスコードが 404の時にnot_foundハンドラーが発動します。

not_found do
  'ファイルが存在しません'
end

エラー

error ハンドラーはルートブロックかbeforeフィルタ内で例外が発生した時はいつでも発動します。 例外オブジェクトはRack変数sinatra.errorから取得できます。

error do
  'エラーが発生しました。 - ' + env['sinatra.error'].name
end

エラーをカスタマイズする場合は、

error MyCustomError do
  'エラーメッセージ...' + env['sinatra.error'].message
end

と書いておいて,下記のように呼び出します。

get '/' do
  raise MyCustomError, '何かがまずかったようです'
end

そうするとこうなります:

エラーメッセージ... 何かがまずかったようです

あるいは、ステータスコードに対応するエラーハンドラを設定することもできます:

error 403 do
  'Access forbidden'
end

get '/secret' do
  403
end

範囲指定もできます:

error 400..510 do
  'Boom'
end

開発環境として実行している場合、Sinatraは特別なnot_founderrorハンドラーを インストールしています。

MIMEタイプ

send_fileか静的ファイルを使う時、Sinatraが理解でいないMIMEタイプがある場合があります。 その時は mime_type を使ってファイル拡張子毎に登録して下さい。

mime_type :foo, 'text/foo'

これはcontent_typeヘルパで利用することができます:

content_type :foo

Rackミドルウェア

SinatraはRackフレームワーク用の 最小限の標準インターフェース 上で動作しています。Rack中でもアプリケーションデベロッパー 向けに一番興味深い機能はミドルウェア(サーバとアプリケーション間に介在し、モニタリング、HTTPリクエストとレスポンス の手動操作ができるなど、一般的な機能のいろいろなことを提供するもの)をサポートすることです。

Sinatraではトップレベルのuse メソッドを使ってRackにパイプラインを構築します。

require 'sinatra'
require 'my_custom_middleware'

use Rack::Lint
use MyCustomMiddleware

get '/hello' do
  'Hello World'
end

use Rack::Builder DSLで定義されていることと全て一致します。 例えば use メソッドはブロック構文のように複数の引数を受け取ることができます。

use Rack::Auth::Basic do |username, password|
  username == 'admin' && password == 'secret'
end

Rackはログ、デバッギング、URLルーティング、認証、セッションなどいろいろな機能を備えた標準的ミドルウェアです。 Sinatraはその多くのコンポーネントを自動で使うよう基本設定されているため、useで明示的に指定する必要はありません。

テスト

SinatraでのテストはRack-basedのテストライブラリかフレームワークを使って書くことができます。 Rack::Test をおすすめします。やり方:

require 'my_sinatra_app'
require 'rack/test'

class MyAppTest < Test::Unit::TestCase
  include Rack::Test::Methods

  def app
    Sinatra::Application
  end

  def test_my_default
    get '/'
    assert_equal 'Hello World!', last_response.body
  end

  def test_with_params
    get '/meet', :name => 'Frank'
    assert_equal 'Hello Frank!', last_response.body
  end

  def test_with_rack_env
    get '/', {}, 'HTTP_USER_AGENT' => 'Songbird'
    assert_equal "あなたはSongbirdを使ってますね!", last_response.body
  end
end

注意: ビルトインのSinatra::TestモジュールとSinatra::TestHarnessクラスは 0.9.2リリース以降、廃止予定になっています。

Sinatra::Base - ミドルウェア、ライブラリ、 モジュラーアプリ

トップレベル(グローバル領域)上でいろいろ定義していくのは軽量アプリならうまくいきますが、 RackミドルウェアやRails metal、サーバのコンポーネントを含んだシンプルな ライブラリやSinatraの拡張プログラムを考慮するような場合はそうとは限りません。 トップレベルのDSLがネームスペースを汚染したり、設定を変えてしまうこと(例:./publicや./view)がありえます。 そこでSinatra::Baseの出番です。

require 'sinatra/base'

class MyApp < Sinatra::Base
  set :sessions, true
  set :foo, 'bar'

  get '/' do
    'Hello world!'
  end
end

このMyAppは独立したRackコンポーネントで、RackミドルウェアやRackアプリケーション Rails metalとして使用することができます。config.ruファイル内で use か、または run でこのクラスを指定するか、ライブラリとしてサーバコンポーネントをコントロールします。

MyApp.run! :host => 'localhost', :port => 9090

Sinatra::Baseのサブクラスで使えるメソッドはトップレベルのDSLを経由して確実に使うことができます。 ほとんどのトップレベルで記述されたアプリは、以下の2点を修正することでSinatra::Baseコンポーネントに変えることができます。

  • sinatraの代わりにsinatra/baseを読み込む

(そうしない場合、SinatraのDSLメソッドの全てがメインネームスペースにインポートされます)

  • ルート、エラーハンドラー、フィルター、オプションをSinatra::Baseのサブクラスに書く

Sinatra::Base はまっさらです。ビルトインサーバを含む、ほとんどのオプションがデフォルト で無効になっています。オプション詳細についてはOptions and Configuration をご覧下さい。

補足: SinatraのトップレベルDSLはシンプルな委譲(delgation)システムで実装されています。 Sinatra::Applicationクラス(Sinatra::Baseの特別なサブクラス)は、トップレベルに送られる :get、 :put、 :post、:delete、 :before、:error、:not_found、 :configure、:set messagesのこれら 全てを受け取ります。 詳細を閲覧されたい方はこちら(英語): Sinatra::Delegator mixin included into the main namespace.

Sinatraをミドルウェアとして利用する

Sinatraは他のRackミドルウェアを利用することができるだけでなく、 全てのSinatraアプリケーションは、それ自体ミドルウェアとして別のRackエンドポイントの前に追加することが可能です。

このエンドポイントには、別のSinatraアプリケーションまたは他のRackベースのアプリケーション(Rails/Ramaze/Camping/…)が用いられるでしょう。

require 'sinatra/base'

class LoginScreen < Sinatra::Base
  enable :sessions

  get('/login') { haml :login }

  post('/login') do
    if params[:name] = 'admin' and params[:password] = 'admin'
      session['user_name'] = params[:name]
    else
      redirect '/login'
    end
  end
end

class MyApp < Sinatra::Base
  # middleware will run before filters
  use LoginScreen

  before do
    unless session['user_name']
      halt "Access denied, please <a href='/login'>login</a>."
    end
  end

  get('/') { "Hello #{session['user_name']}." }
end

スコープとバインディング

現在のスコープはどのメソッドや変数が利用可能かを決定します。

アプリケーション/クラスのスコープ

全てのSinatraアプリケーションはSinatra::Baseのサブクラスに相当します。 もしトップレベルDSLを利用しているならば(require 'sinatra')このクラスはSinatra::Applicationであり、 そうでなければ、あなたが明示的に作成したサブクラスです。 クラスレベルでは`get`や`before`のようなメソッドを持っています。 しかし`request`オブジェクトや`session`には、全てのリクエストのために1つのアプリケーションクラスが存在するためアクセスできません。

`set`によって作られたオプションはクラスレベルのメソッドです:

class MyApp < Sinatra::Base
  # Hey, I'm in the application scope!
  set :foo, 42
  foo # => 42

  get '/foo' do
    # Hey, I'm no longer in the application scope!
  end
end

次の場所ではアプリケーションスコープバインディングを持ちます:

  • アプリケーションのクラス本体

  • 拡張によって定義されたメソッド

  • `helpers`に渡されたブロック

  • `set`の値として使われるProcまたはブロック

このスコープオブジェクト(クラス)は次のように利用できます:

  • configureブロックに渡されたオブジェクト経由(configure { |c| ... })

  • リクエストスコープの中での`settings`

リクエスト/インスタンスのスコープ

やってくるリクエストごとに、あなたのアプリケーションクラスの新しいインスタンスが作成され、全てのハンドラブロックがそのスコープで実行されます。 このスコープの内側からは`request`や`session`オブジェクトにアクセスすることができ、`erb`や`haml`のような表示メソッドを呼び出すことができます。 リクエストスコープの内側からは、`settings`ヘルパによってアプリケーションスコープにアクセスすることができます。

class MyApp < Sinatra::Base
  # Hey, I'm in the application scope!
  get '/define_route/:name' do
    # Request scope for '/define_route/:name'
    @value = 42

    settings.get("/#{params[:name]}") do
      # Request scope for "/#{params[:name]}"
      @value # => nil (not the same request)
    end

    "Route defined!"
  end
end

次の場所ではリクエストスコープバインディングを持ちます:

  • get/head/post/put/delete ブロック

  • before/after フィルタ

  • helper メソッド

  • テンプレート/ビュー

デリゲートスコープ

デリゲートスコープは、単にクラススコープにメソッドを転送します。 しかしながら、クラスのバインディングを持っていないため、クラススコープと全く同じふるまいをするわけではありません: 委譲すると明示的に示されたメソッドのみが利用可能であり、またクラススコープと変数/状態を共有することはできません(注: 異なった`self`を持っています)。 Sinatra::Delegator.delegate :method_nameを呼び出すことによってデリゲートするメソッドを明示的に追加することができます。

次の場所ではデリゲートスコープを持ちます:

  • もしrequire "sinatra"しているならば、トップレベルバインディング

  • `Sinatra::Delegator` mixinでextendされたオブジェクト

コードをご覧ください: ここでは Sinatra::Delegator mixinmain 名前空間にincludeされています.

コマンドライン

Sinatraアプリケーションは直接実行できます。

ruby myapp.rb [-h] [-x] [-e ENVIRONMENT] [-p PORT] [-o HOST] [-s HANDLER]

オプション:

-h # ヘルプ
-p # ポート指定(デフォルトは4567)
-o # ホスト指定(デフォルトは0.0.0.0)
-e # 環境を指定 (デフォルトはdevelopment)
-s # rackserver/handlerを指定 (デフォルトはthin)
-x # mutex lockを付ける (デフォルトはoff)

最新開発版について

Sinatraの開発版を使いたい場合は、ローカルに開発版を落として、 LOAD_PATHsinatra/libディレクトリを指定して実行して下さい。

cd myapp
git clone git://github.com/sinatra/sinatra.git
ruby -Isinatra/lib myapp.rb

sinatra/libディレクトリをアプリケーションのLOAD_PATHに追加する方法もあります。

$LOAD_PATH.unshift File.dirname(__FILE__) + '/sinatra/lib'
require 'rubygems'
require 'sinatra'

get '/about' do
  "今使ってるバージョンは" + Sinatra::VERSION
end

Sinatraのソースを更新する方法:

cd myproject/sinatra
git pull

その他

日本語サイト

英語サイト