Ruby on Rails中Rack中間件的基礎(chǔ)學(xué)習(xí)教程

rack是ruby服務(wù)器和rack應(yīng)用程序之間的一個(gè)框架，rails,sinatra都是基于rack構(gòu)建的，都屬于rack應(yīng)用程序。

rack提供了一個(gè)標(biāo)準(zhǔn)的接口，用于與服務(wù)器進(jìn)行交互。標(biāo)準(zhǔn)的rack程序是一個(gè)可以響應(yīng)call的對象，可以是對象、Proc、lambda甚至是method，它接收env參數(shù)（環(huán)境對象），返回一個(gè)數(shù)組，數(shù)組包括：

• 狀態(tài)(status)，http響應(yīng)狀態(tài)碼
• 可以是hash，為http的header信息
• 擁有each方法的對象，each返回字符串

rack通過中間件來進(jìn)行擴(kuò)展，即對原始的rack程序進(jìn)行裝飾，在原有返回?cái)?shù)組的基礎(chǔ)上進(jìn)一步處理，并返回rack對象

簡單的rack程序

require 'rack'

app = lambda{|env|[200,{},["hello from rack"]]}
Rack::Handler::WEBrick.run app

使用中間件的rack程序：
require 'rack'

class Decorator
 def initialize(app)
  @app = app
 end
 def call(env)
  status, headers, body = @app.call(env)
  new_body = "from middleware input br/>"
  body.each{|str| new_body  str}
  headers['Content-Length'] = new_body.bytesize.to_s
  [status, headers, [new_body]]
 end
end

app = lambda{|env|[200,{},["hello from rack"]]}
Rack::Handler::WEBrick.run Decorator.new(app)

上面使用中間件的方法在使用多個(gè)時(shí)容易混亂，rack有一個(gè)Builder類可以有效管理
使用如下
require 'rack'

require 'decorator'

app = Rack::Builder.new{
 use Rack::ContentLength
 use Decorator
 run lambda {|env| [200, {"Content-Type"=>"text/html"}, ["hello world"]]}
}.to_app
Rack::Handler::WEBrick.run app

使用Rack::Builder的map方法，可以創(chuàng)建有路由的rack程序
require 'rack'

app = Rack::Builder.new {
 map '/hello' do
run lambda {|env| [200, {"Content-Type" => "text/html"}, ["hello"]] } end
map '/world' do
run lambda {|env| [200, {"Content-Type" => "text/html"}, ["world"]] }
end
map '/' do
run lambda {|env| [200, {"Content-Type" => "text/html"}, ["all"]] } end
}.to_app
Rack::Handler::WEBrick.run app, :Port => 3000

由于rails的全棧性，rack中間件很多，在一些高并發(fā)但業(yè)務(wù)簡單的網(wǎng)站或api使用時(shí)
響應(yīng)時(shí)間過長，在這種情況下可以考慮使用rack或者sinatra。

啟動一個(gè)rack程序有兩種方式：

1.直接使用ruby運(yùn)行.rb文件,默認(rèn)在8080啟動服務(wù)，無日志文件
2.使用rackup，默認(rèn)在9292 啟動服務(wù)，有日志文件，rackup可使用 -o 指定ip, －p 指定端口號

require 'rack'
app = lambda{|env| [200,{},["hello world"]] }
Rack::Server.new.server.run app
ruby xxx.rb

#test.ru
run lambda{|env| [ 200,{},["rackup start"] ]}
rackup test.ru

rack會在啟動時(shí)默認(rèn)加載一些中間件:

def logging_middleware
    lambda { |server|
     server.server.name =~ /CGI/ || server.options[:quiet] ? nil : [Rack::CommonLogger, $stderr]
    }
   end

    m = Hash.new {|h,k| h[k] = []}
    m["deployment"] = [
     [Rack::ContentLength],
     [Rack::Chunked],
     logging_middleware,
     [Rack::TempfileReaper]
    ]
    m["development"] = [
     [Rack::ContentLength],
     [Rack::Chunked],
     logging_middleware,
     [Rack::ShowExceptions],
     [Rack::Lint],
     [Rack::TempfileReaper]
    ]

    m
   end

包括body長度錯(cuò)誤提示訪問記錄等。

rack有一個(gè)Directory的中間件，可以為目錄文件生成一個(gè)web服務(wù)。
使用很簡單一句話：

#test.ru
run Rack::Directory.new "~/"
rackup test.ru

這樣就會把home目錄下的所有文件、文件夾在瀏覽器中顯示

rails應(yīng)用中使用rake middleware即可顯示所有的middleware(中間件)

** **rake middleware
use Rack::Sendfile
use ActionDispatch::Static
use Rack::Lock
use #ActiveSupport::Cache::Strategy::LocalCache::Middleware:0x007feef1563b90>
use Rack::Runtime
use Rack::MethodOverride
use ActionDispatch::RequestId
use Rails::Rack::Logger
use ActionDispatch::ShowExceptions
use WebConsole::Middleware
use ActionDispatch::DebugExceptions
use ActionDispatch::RemoteIp
use ActionDispatch::Reloader
use ActionDispatch::Callbacks
use ActiveRecord::Migration::CheckPending
use ActiveRecord::ConnectionAdapters::ConnectionManagement
use ActiveRecord::QueryCache
use ActionDispatch::Cookies
use ActionDispatch::Session::CookieStore
use ActionDispatch::Flash
use ActionDispatch::ParamsParser
use Rack::Head
use Rack::ConditionalGet
use Rack::ETag
run Fool::Application.routes

rails使用了rack定義的一些中間件，自定義了一些中間件，其中自定義的routes為rack程序，routes 把rails controller的action變?yōu)閘ambda并作為rack程序運(yùn)行，在rails console里輸入

2.2.1 :001 > QuestionsController.action(:new)
 => #Proc:0x007fbe482ee0b0@/Users/killman/.rvm/gems/ruby-2.2.1/gems/actionpack-4.2.1/lib/action_controller/metal.rb:237 (lambda)>

在config/application.rb可添加、刪除、修改中間件

config.middleware.use(new_middleware, args)＃：把新中間件添加到列表末尾；
config.middleware.insert_before(existing_middleware,
 new_middleware, args)#：在 existing_middleware

 之前添加新中間件；

config.middleware.insert_after(existing_middleware,
 new_middleware, args)#：在 existing_middleware

 之后添加新中間件；

config.middleware.swap ActionDispatch::ShowExceptions, Lifo::ShowExceptions #替換中間件
config.middleware.delete "Rack::Lock"#刪除中間件

中間件的作用：

• Rack::Sendfile ：設(shè)置服務(wù)器上的 X-Sendfile 報(bào)頭。通過 config.action_dispatch.x_sendfile_header選項(xiàng)設(shè)置。
• ActionDispatch::Static ：用來服務(wù)靜態(tài)資源文件。如果選項(xiàng) config.serve_static_assets為 false，則禁用這個(gè)中間件。
• Rack::Lock ：把 env["rack.multithread"]旗標(biāo)設(shè)為 false，程序放入互斥鎖中。
• ActiveSupport::Cache::Strategy::LocalCache::Middleware ：在內(nèi)存中保存緩存，非線程安全。
• Rack::Runtime ：設(shè)置 X-Runtime 報(bào)頭，即執(zhí)行請求的時(shí)長，單位為秒。
• Rack::MethodOverride ：如果指定了 params[:_method]參數(shù)，會覆蓋所用的請求方法。這個(gè)中間件實(shí)現(xiàn)了 PUT 和 DELETE 方法。
• ActionDispatch::RequestId ：在響應(yīng)中設(shè)置一個(gè)唯一的 X-Request-Id 報(bào)頭，并啟用 ActionDispatch::Request#uuid方法。
• Rails::Rack::Logger ：請求開始時(shí)提醒日志，請求完成后寫入日志。
• ActionDispatch::ShowExceptions ：補(bǔ)救程序拋出的所有異常，調(diào)用處理異常的程序，使用特定的格式顯示給用戶。
• ActionDispatch::DebugExceptions ：如果在本地開發(fā)，把異常寫入日志，并顯示一個(gè)調(diào)試頁面。
• ActionDispatch::RemoteIp ：檢查欺騙攻擊的 IP。
• ActionDispatch::Reloader ：提供“準(zhǔn)備”和“清理”回調(diào)，協(xié)助開發(fā)環(huán)境中的代碼重新加載功能。
• ActionDispatch::Callbacks ：在處理請求之前調(diào)用“準(zhǔn)備”回調(diào)。
• ActiveRecord::Migration::CheckPending ：檢查是否有待運(yùn)行的遷移，如果有就拋出 ActiveRecord::PendingMigrationError異常。
• ActiveRecord::ConnectionAdapters::ConnectionManagement ：請求處理完成后，清理活躍的連接，除非在發(fā)起請求的環(huán)境中把 rack.test設(shè)為 true。
• ActiveRecord::QueryCache ：啟用 Active Record 查詢緩存。
• ActionDispatch::Cookies ：設(shè)置請求的 cookies。
• ActionDispatch::Session::CookieStore ：負(fù)責(zé)把會話存儲在 cookies 中。
• ActionDispatch::Flash ：設(shè)置 Flash 消息的鍵。只有設(shè)定了 config.action_controller.session_store選項(xiàng)時(shí)才可用。
• ActionDispatch::ParamsParser ：把請求中的參數(shù)出入 params。
• ActionDispatch::Head ：把 HEAD 請求轉(zhuǎn)換成 GET 請求，并處理。
• Rack::ConditionalGet ：添加對“條件 GET”的支持，如果頁面未修改，就不響應(yīng)。
• Rack::ETag ：為所有字符串類型的主體添加 ETags 報(bào)頭。ETags 用來驗(yàn)證緩存。