まず最初に、Rackは正確に2つあります。
ラック-Webサーバーインターフェイス
ラックの基本は単純な規則です。すべてのラック準拠のWebサーバーは、指定したオブジェクトのcallメソッドを常に呼び出し、そのメソッドの結果を提供します。Rackは、この呼び出しメソッドがどのように見える必要があるか、また何を返す必要があるかを正確に指定します。それはラックです。
簡単に試してみましょう。私はWEBrickをラック準拠のWebサーバーとして使用しますが、どれでも使用できます。JSON文字列を返す簡単なWebアプリケーションを作成してみましょう。このために、config.ruというファイルを作成します。config.ruは、ラックに準拠したWebサーバーでconfig.ruのコンテンツを実行するだけの、rack gemのコマンドrackupによって自動的に呼び出されます。それでは、config.ruファイルに以下を追加しましょう：
class JSONServer
def call(env)
[200, {"Content-Type" => "application/json"}, ['{ "message" : "Hello!" }']]
end
end
map '/hello.json' do
run JSONServer.new
end
規約に指定されているように、サーバーには環境ハッシュを受け入れ、Webサーバーが提供する[ステータス、ヘッダー、本文]という形式の配列を返すcallというメソッドがあります。ラックアップを呼び出すだけで試してみましょう。デフォルトのラック準拠サーバー、おそらくWEBrickまたはMongrelが起動し、要求が処理されるのをすぐに待ちます。
$ rackup
[2012-02-19 22:39:26] INFO WEBrick 1.3.1
[2012-02-19 22:39:26] INFO ruby 1.9.3 (2012-01-17) [x86_64-darwin11.2.0]
[2012-02-19 22:39:26] INFO WEBrick::HTTPServer#start: pid=16121 port=9292
urlまたはhttp://localhost:9292/hello.jsonvoilaをカーリングまたはアクセスして、新しいJSONサーバーをテストしてみましょう。
$ curl http://localhost:9292/hello.json
{ message: "Hello!" }
できます。すごい！RailsであろうとSinatraであろうと、それがすべてのWebフレームワークの基礎です。ある時点で、それらは呼び出しメソッドを実装し、すべてのフレームワークコードを処理し、最後に典型的な[ステータス、ヘッダー、本文]形式で応答を返します。
たとえばRuby on Railsでは、ラックリクエストActionDispatch::Routing.Mapperは次のようなクラスにヒットします。
module ActionDispatch
module Routing
class Mapper
...
def initialize(app, constraints, request)
@app, @constraints, @request = app, constraints, request
end
def matches?(env)
req = @request.new(env)
...
return true
end
def call(env)
matches?(env) ? @app.call(env) : [ 404, {'X-Cascade' => 'pass'}, [] ]
end
...
end
end
したがって、基本的にRailsはルートが一致するかどうかをenvハッシュに依存してチェックします。その場合は、envハッシュをアプリケーションに渡して応答を計算し、そうでない場合はすぐに404で応答します。したがって、ラックインターフェース規則に準拠しているすべてのWebサーバーは、完全に機能するRailsアプリケーションにサービスを提供できます。
ミドルウェア
Rackは、ミドルウェアレイヤーの作成もサポートしています。彼らは基本的にリクエストを傍受し、それを使って何かを実行します。これは、用途の広いタスクに非常に役立ちます。
リクエストの所要時間も測定するロギングをJSONサーバーに追加するとします。これを行うミドルウェアロガーを作成するだけです。
class RackLogger
def initialize(app)
@app = app
end
def call(env)
@start = Time.now
@status, @headers, @body = @app.call(env)
@duration = ((Time.now - @start).to_f * 1000).round(2)
puts "#{env['REQUEST_METHOD']} #{env['REQUEST_PATH']} - Took: #{@duration} ms"
[@status, @headers, @body]
end
end
作成されると、実際のラックアプリケーションのコピーが保存されます。私たちの場合、それはJSONServerのインスタンスです。Rackはミドルウェアのcallメソッドを自動的に呼び出し、[status, headers, body]JSONServerが返すように配列を返します。
したがって、このミドルウェアでは、開始点が取られ、JSONServerへの実際の呼び出しがで行われ@app.call(env)、ロガーがロギングエントリを出力し、最後にとして応答を返します[@status, @headers, @body]。
私たちの小さなrackup.ruがこのミドルウェアを使用するようにするには、次のように使用するRackLoggerを追加します。
class JSONServer
def call(env)
[200, {"Content-Type" => "application/json"}, ['{ "message" : "Hello!" }']]
end
end
class RackLogger
def initialize(app)
@app = app
end
def call(env)
@start = Time.now
@status, @headers, @body = @app.call(env)
@duration = ((Time.now - @start).to_f * 1000).round(2)
puts "#{env['REQUEST_METHOD']} #{env['REQUEST_PATH']} - Took: #{@duration} ms"
[@status, @headers, @body]
end
end
use RackLogger
map '/hello.json' do
run JSONServer.new
end
サーバーを再起動して出来上がり。リクエストごとにログを出力します。ラックを使用すると、呼び出される複数のミドルウェアを追加順に追加できます。これは、ラックアプリケーションのコアを変更せずに機能を追加するための優れた方法です。
ラック-宝石
ラック-まず第一に-は慣習ですが、優れた機能を提供する宝石でもあります。JSONサーバーで既に使用しているものの1つであるrackupコマンド。しかし、まだまだあります！ラック宝石は、静的ファイルやディレクトリ全体の提供など、多くのユースケースに対応できる小さなアプリケーションを提供します。htmls / index.htmlにある非常に基本的なHTMLファイルなど、単純なファイルを提供する方法を見てみましょう。
<!DOCTYPE HTML>
<html>
<head>
<title>The Index</title>
</head>
<body>
<p>Index Page</p>
</body>
</html>
このファイルをウェブサイトのルートから提供したいので、config.ruに以下を追加します。
map '/' do
run Rack::File.new "htmls/index.html"
end
訪問http://localhost:9292すると、htmlファイルが完全にレンダリングされていることがわかります。簡単でしたよね？
/ javascriptsの下にいくつかのJavaScriptファイルを作成し、以下をconfig.ruに追加して、JavaScriptファイルのディレクトリ全体を追加してみましょう。
map '/javascripts' do
run Rack::Directory.new "javascripts"
end
サーバーを再起動してアクセスするhttp://localhost:9292/javascriptと、今すぐどこからでも含めることができるすべてのJavaScriptファイルのリストが表示されます。
