やる夫が Rack についても学ぶそうです(Rack ミドルウェア編)

Ruby 
　　　　　　　　　　　 ／￣￣＼ 
　　　　　　　　　　／　　 _ノ　　＼ 
　　　　　　　　　　|　　　 （ ●）（●）　 
　　　　　　　　　　|　　　　 （__人__）　　 
　 　 　 　 　　　　 |　　　　　｀ ⌒´ﾉ　次は Rack ミドルウェアだ。 
　 　 　 　 　 　　　 |　　　　　　 　 }　　 
　 　 　 　 　　　 　 ヽ　　　　　 　 }　　　
　　　　　　　　　　　 ヽ､.,＿＿ __ノ　　　
　　　_, ､ -― ''"::l:::::::＼ｰ-..,ノ,､.ﾞ,i ､ 
　　/;;;;;;::ﾞ:':､::::::::::::|＿:::;､>､_　l|||||ﾞ!:ﾞ､-､_ 
　丿;;;;;;;;;;;:::::i::::::::::::::／:::::::＼ﾞ'' ﾞ||i l＼>::::ﾞ'ｰ､ 
. i;;;;;;;;;;;;;;;;;;;;;;|::::::::::::::＼::::::::::＼ .||||i|::::ヽ::::::|:::! 
/;;;;;;;;;;;;;;;;;;;;;;;;!:::::::::::::::::::＼:::::::::ヽ|||||:::::/::::::::i:::| 
;;;;;;;;;;;;;;;;;;;;;;;;;;|;;;;:::::::::::::::::::::::＼:::::ﾞ､|||:::/::::::::::|::: 
　 　　　＿＿＿_　　 
　　　／　　 　 　＼ 
　 ／　　─　 　 ─＼　 
／ 　　 （●） 　（●） ＼　Rack ミドルウェア？ 
|　 　　 　 （__人__）　 　 |　　 
/　　　　 ∩ノ ⊃　　／ 
(　 ＼　／ ＿ノ　|　 | 
.＼　“　　／＿＿|　 | 　 
　　＼ ／＿＿＿ ／ 　 
　　　　　　　　　　　 ／￣￣＼ 
　　　　　　　　　　／　　 _ノ　　＼ 
　　　　　　　　　　|　　　 （ ●）（●）　 
　　　　　　　　　　|　　　　 （__人__）　　 
　 　 　 　 　　　　 |　　　　　｀ ⌒´ﾉ　Rack アプリケーションの一種だ。 
　 　 　 　 　 　　　 |　　　　　　 　 }　　他の Rackアプリケーションをラップして、
　 　 　 　 　　　 　 ヽ　　　　　 　 }　　　リクエストやレスポンスを加工したり、
　　　　　　　　　　　 ヽ､.,＿＿ __ノ　　　　処理を差し替えたりできる。
　　　_, ､ -― ''"::l:::::::＼ｰ-..,ノ,､.ﾞ,i ､ 
　　/;;;;;;::ﾞ:':､::::::::::::|＿:::;､>､_　l|||||ﾞ!:ﾞ､-､_ 
　丿;;;;;;;;;;;:::::i::::::::::::::／:::::::＼ﾞ'' ﾞ||i l＼>::::ﾞ'ｰ､ 
. i;;;;;;;;;;;;;;;;;;;;;;|::::::::::::::＼::::::::::＼ .||||i|::::ヽ::::::|:::! 
/;;;;;;;;;;;;;;;;;;;;;;;;!:::::::::::::::::::＼:::::::::ヽ|||||:::::/::::::::i:::| 
;;;;;;;;;;;;;;;;;;;;;;;;;;|;;;;:::::::::::::::::::::::＼:::::ﾞ､|||:::/::::::::::|::: 
　　　　　　　　　　　 ／￣￣＼ 
　　　　　　　　　　／　　 _ノ　　＼ 
　　　　　　　　　　|　　　 （ ●）（●）　 
　　　　　　　　　　|　　　　 （__人__）　　 
　 　 　 　 　　　　 |　　　　　｀ ⌒´ﾉ　Rack ミドルウェアを簡単に説明するなら、
　 　 　 　 　 　　　 |　　　　　　 　 }　　(1)Rack アプリケーションの仕様を満たしている
　 　 　 　 　　　 　 ヽ　　　　　 　 }　　　(2)initialize で Rack アプリケーションを受け取る
　　　　　　　　　　　 ヽ､.,＿＿ __ノ　　　　という仕様を満たしている Rack アプリケーションだ。
　　　_, ､ -― ''"::l:::::::＼ｰ-..,ノ,､.ﾞ,i ､ 　　　コードにするならこんな感じだな。
　　/;;;;;;::ﾞ:':､::::::::::::|＿:::;､>､_　l|||||ﾞ!:ﾞ､-､_ 
　丿;;;;;;;;;;;:::::i::::::::::::::／:::::::＼ﾞ'' ﾞ||i l＼>::::ﾞ'ｰ､ 
. i;;;;;;;;;;;;;;;;;;;;;;|::::::::::::::＼::::::::::＼ .||||i|::::ヽ::::::|:::! 
/;;;;;;;;;;;;;;;;;;;;;;;;!:::::::::::::::::::＼:::::::::ヽ|||||:::::/::::::::i:::| 
;;;;;;;;;;;;;;;;;;;;;;;;;;|;;;;:::::::::::::::::::::::＼:::::ﾞ､|||:::/::::::::::|::: 
class SampleMiddleware
  # initialize で他の Rack アプリケーションを受け取る
  def initialize(app)
    @app = app
  end

  # Rack アプリケーションなので、call メソッドをもっている
  def call(env)
    # env に対して何かする

    # ラップしている Rack アプリケーションを呼び出す
    resp = @app.call(env)

    # resp に対して何かする

    # resp を返す
    resp
  end
end

　　　　　　　　　　　 ／￣￣＼ 
　　　　　　　　　　／　　 _ノ　　＼ 
　　　　　　　　　　|　　　 （ ●）（●）　 
　　　　　　　　　　|　　　　 （__人__）　　 
　 　 　 　 　　　　 |　　　　　｀ ⌒´ﾉ　試しに レスポンスボディを全て大文字にする 
　 　 　 　 　 　　　 |　　　　　　 　 }　　ミドルウェアを書いてみる。 
　 　 　 　 　　　 　 ヽ　　　　　 　 }　　　
　　　　　　　　　　　 ヽ､.,＿＿ __ノ　　　
　　　_, ､ -― ''"::l:::::::＼ｰ-..,ノ,､.ﾞ,i ､ 
　　/;;;;;;::ﾞ:':､::::::::::::|＿:::;､>､_　l|||||ﾞ!:ﾞ､-､_ 
　丿;;;;;;;;;;;:::::i::::::::::::::／:::::::＼ﾞ'' ﾞ||i l＼>::::ﾞ'ｰ､ 
. i;;;;;;;;;;;;;;;;;;;;;;|::::::::::::::＼::::::::::＼ .||||i|::::ヽ::::::|:::! 
/;;;;;;;;;;;;;;;;;;;;;;;;!:::::::::::::::::::＼:::::::::ヽ|||||:::::/::::::::i:::| 
;;;;;;;;;;;;;;;;;;;;;;;;;;|;;;;:::::::::::::::::::::::＼:::::ﾞ､|||:::/::::::::::|::: 
# レスポンスボディを大文字に変えるミドルウェア
class UpcaseMiddleware
  def initialize(app)
    @app = app
  end

  def call(env)
    resp = @app.call(env)

    # レスポンスボディを取り出す
    resp[2].each do |body|
      # 大文字に変換
      body.upcase!
    end
    resp
  end
end

　　　　 　　　／￣￣＼
　　　　　　／　　　 　　 ＼ 　　　　　＿＿＿_
　　　　　　|:::::: 　 　　 　　｜　　　／　　　　　＼
　　　　　.　|:::::::::::　　　　　｜　 ／ ⌒　　　⌒　 ＼ 　
　　　　　　 |::::::::::::::　　　　｜／ 　（●）　（●） 　　＼　この Rack ミドルウェアはどうやって使うんだお？
　　　　　.　 |::::::::::::::　　　　} |　 　　（__人__）　　　　　|　
　　　　　.　 ヽ:::::::::::::: 　　 }　＼　　 ｀ ⌒´ 　　　　_／　
　　　　　　　 ヽ::::::::::　　ノ　　　|　　　　　　　　　　 ＼
　　　　　　　　/:::::::::::: く　　　　|　|　　　　　　　　 | 　|
-―――――|:::::::::::::::: ＼-―┴┴―――――┴┴――
　　　　　　　　　　　 ／￣￣＼ 
　　　　　　　　　　／　　 _ノ　　＼ 
　　　　　　　　　　|　　　 （ ●）（●）　 
　　　　　　　　　　|　　　　 （__人__）　　 
　 　 　 　 　　　　 |　　　　　｀ ⌒´ﾉ　作成したミドルウェアを使うには、 
　 　 　 　 　 　　　 |　　　　　　 　 }　　config.ru 内で use で指定する。
　 　 　 　 　　　 　 ヽ　　　　　 　 }　　　
　　　　　　　　　　　 ヽ､.,＿＿ __ノ　　　
　　　_, ､ -― ''"::l:::::::＼ｰ-..,ノ,､.ﾞ,i ､ 
　　/;;;;;;::ﾞ:':､::::::::::::|＿:::;､>､_　l|||||ﾞ!:ﾞ､-､_ 
　丿;;;;;;;;;;;:::::i::::::::::::::／:::::::＼ﾞ'' ﾞ||i l＼>::::ﾞ'ｰ､ 
. i;;;;;;;;;;;;;;;;;;;;;;|::::::::::::::＼::::::::::＼ .||||i|::::ヽ::::::|:::! 
/;;;;;;;;;;;;;;;;;;;;;;;;!:::::::::::::::::::＼:::::::::ヽ|||||:::::/::::::::i:::| 
;;;;;;;;;;;;;;;;;;;;;;;;;;|;;;;:::::::::::::::::::::::＼:::::ﾞ､|||:::/::::::::::|::: 
require 'sample_app'
require 'upcase_middleware'

# useはRack::Builderで用意されたDSLの記法
# 後続のミドルウェアやアプリケーションを引数に取ってnewしてHandlerの引数にする
# (例)
# use MiddlewareA
# use MiddlewareB
# run App.new
#    ↓
# Rack::Handler::CGI.run MiddlewareA.new( MiddlewareB.new( App.new ) )

use UpcaseMiddleware
run SampleApp.new

　　　　　　　　　　　 ／￣￣＼ 
　　　　　　　　　　／　　 _ノ　　＼ 
　　　　　　　　　　|　　　 （ ●）（●）　 
　　　　　　　　　　|　　　　 （__人__）　　 
　 　 　 　 　　　　 |　　　　　｀ ⌒´ﾉ　ミドルウェア自身も Rack アプリケーションなので、 
　 　 　 　 　 　　　 |　　　　　　 　 }　　次のように書く事もできる。
　 　 　 　 　　　 　 ヽ　　　　　 　 }　　　
　　　　　　　　　　　 ヽ､.,＿＿ __ノ　　　
　　　_, ､ -― ''"::l:::::::＼ｰ-..,ノ,､.ﾞ,i ､ 
　　/;;;;;;::ﾞ:':､::::::::::::|＿:::;､>､_　l|||||ﾞ!:ﾞ､-､_ 
　丿;;;;;;;;;;;:::::i::::::::::::::／:::::::＼ﾞ'' ﾞ||i l＼>::::ﾞ'ｰ､ 
. i;;;;;;;;;;;;;;;;;;;;;;|::::::::::::::＼::::::::::＼ .||||i|::::ヽ::::::|:::! 
/;;;;;;;;;;;;;;;;;;;;;;;;!:::::::::::::::::::＼:::::::::ヽ|||||:::::/::::::::i:::| 
;;;;;;;;;;;;;;;;;;;;;;;;;;|;;;;:::::::::::::::::::::::＼:::::ﾞ､|||:::/::::::::::|::: 
require 'sample_app'
require 'upcase_middleware'

run UpcaseMiddleware.new(SampleApp.new)

　　 　　　／￣￣￣＼　 
　　　　／　─　 　 ─ ＼　 
　　 ／　 （●） 　（●）　 ＼. 　　いったい、これの何がうれしいんだお？
　　 |　　　　（__人__）　　　　|　 
　　 ＼　　　 ｀ ⌒´　　　　／ 
　　 ／ 　 　 　　　　 　 　 ＼ 
　　　　　　　　　　　 ／￣￣＼ 
　　　　　　　　　　／　　 _ノ　　＼ 
　　　　　　　　　　|　　　 （ ●）（●）　 
　　　　　　　　　　|　　　　 （__人__）　　 
　 　 　 　 　　　　 |　　　　　｀ ⌒´ﾉ　今回のサンプルは大したことないから、恩恵は実感できないな。
　 　 　 　 　 　　　 |　　　　　　 　 }　　例えば、セッション管理やユーザー認証なんかは、
　 　 　 　 　　　 　 ヽ　　　　　 　 }　　　いろんな Rack アプリケーションで使うよな。
　　　　　　　　　　　 ヽ､.,＿＿ __ノ　　　　
　　　_, ､ -― ''"::l:::::::＼ｰ-..,ノ,､.ﾞ,i ､ 
　　/;;;;;;::ﾞ:':､::::::::::::|＿:::;､>､_　l|||||ﾞ!:ﾞ､-､_ 
　丿;;;;;;;;;;;:::::i::::::::::::::／:::::::＼ﾞ'' ﾞ||i l＼>::::ﾞ'ｰ､ 
. i;;;;;;;;;;;;;;;;;;;;;;|::::::::::::::＼::::::::::＼ .||||i|::::ヽ::::::|:::! 
/;;;;;;;;;;;;;;;;;;;;;;;;!:::::::::::::::::::＼:::::::::ヽ|||||:::::/::::::::i:::| 
;;;;;;;;;;;;;;;;;;;;;;;;;;|;;;;:::::::::::::::::::::::＼:::::ﾞ､|||:::/::::::::::|::: 
　　　　　　　　　＿＿＿
　　　　　　　／　　　　　＼　ｷﾘｯ
　　　　　 ／　　 ＼ ,　, ／＼
　　　　／　 　 （●）　 （●） ＼　　その通りだお。毎回ユーザー認証を実装するの面倒だお！
　　 　 |　　 　 　 （__人__）　　　|　だからライブラリ作ったお！
　 　 　 ＼　 　 　 ` ⌒ ´　　,／　
.　　　 　 /⌒〜"￣,￣￣〆⌒,ﾆつ
　　　 　 |　　,＿_＿ﾞ＿__､rヾｲｿ⊃
　　　　　| 　 　 　 　 　 　｀l￣
.　　　 　 |　　　　　　　　　 |
　　　　　　　　　　　 ／￣￣＼ 
　　　　　　　　　　／　　 _ノ　　＼ 
　　　　　　　　　　|　　　 （ ●）（●）　 
　　　　　　　　　　|　　　　 （__人__）　　 
　 　 　 　 　　　　 |　　　　　｀ ⌒´ﾉ　いろんな Rack アプリで使うものはライブラリにすると思うが、
　 　 　 　 　 　　　 |　　　　　　 　 }　　Rack ミドルウェアとして実装しておけば、config.ru を編集するだけで、
　 　 　 　 　　　 　 ヽ　　　　　 　 }　　　機能の着脱ができる。
　　　　　　　　　　　 ヽ､.,＿＿ __ノ　　　　アプリケーション本体のコードには手を加えなくていい。
　　　_, ､ -― ''"::l:::::::＼ｰ-..,ノ,､.ﾞ,i ､ 
　　/;;;;;;::ﾞ:':､::::::::::::|＿:::;､>､_　l|||||ﾞ!:ﾞ､-､_ 
　丿;;;;;;;;;;;:::::i::::::::::::::／:::::::＼ﾞ'' ﾞ||i l＼>::::ﾞ'ｰ､ 
. i;;;;;;;;;;;;;;;;;;;;;;|::::::::::::::＼::::::::::＼ .||||i|::::ヽ::::::|:::! 
/;;;;;;;;;;;;;;;;;;;;;;;;!:::::::::::::::::::＼:::::::::ヽ|||||:::::/::::::::i:::| 
;;;;;;;;;;;;;;;;;;;;;;;;;;|;;;;:::::::::::::::::::::::＼:::::ﾞ､|||:::/::::::::::|::: 
　 　 　 　 　／￣￣￣ ＼
　　　　　 ／　　 :::::＼:::／＼　　
　　 　 ／　　 　｡<一>:::::<ー>。　
　　 　 |　　　　.:::｡ﾟ~（__人__）~ﾟj　　 確かに、やらない夫の言うとおりだお…。
　　 　 ＼、　　　゜　｀ ⌒´,;／゜　　やる夫の作ったライブラリも Rack ミドルウェアにするお。
　　　　／　 ⌒ヽﾟ 　'"'"´(;ﾟ　｡　　
　　　/　,＿ ＼　＼／＼ ＼
　 　 と_＿＿）_ヽ＿つ_;_ヾ_つ.;._
　　　　　　　　　　　 ／￣￣＼ 
　　　　　　　　　　／　　 _ノ　　＼ 
　　　　　　　　　　|　　　 （ ●）（●）　 
　　　　　　　　　　|　　　　 （__人__）　　 
　 　 　 　 　　　　 |　　　　　｀ ⌒´ﾉ　よく使う機能は既に Rack に用意してあるけどな。
　 　 　 　 　 　　　 |　　　　　　 　 }　　とりあえず Rack::Session::Cookie や Rack::Auth::Basic
　 　 　 　 　　　 　 ヽ　　　　　 　 }　　　あたりからチェックしておけ。
　　　　　　　　　　　 ヽ､.,＿＿ __ノ　　　
　　　_, ､ -― ''"::l:::::::＼ｰ-..,ノ,､.ﾞ,i ､ 
　　/;;;;;;::ﾞ:':､::::::::::::|＿:::;､>､_　l|||||ﾞ!:ﾞ､-､_ 
　丿;;;;;;;;;;;:::::i::::::::::::::／:::::::＼ﾞ'' ﾞ||i l＼>::::ﾞ'ｰ､ 
. i;;;;;;;;;;;;;;;;;;;;;;|::::::::::::::＼::::::::::＼ .||||i|::::ヽ::::::|:::! 
/;;;;;;;;;;;;;;;;;;;;;;;;!:::::::::::::::::::＼:::::::::ヽ|||||:::::/::::::::i:::| 
;;;;;;;;;;;;;;;;;;;;;;;;;;|;;;;:::::::::::::::::::::::＼:::::ﾞ､|||:::/::::::::::|:::