一、Rack中间件
1、什么是中间件
中间件其实就是Ruby应用服务器和Rack应用程序之间执行的代码
2、一个简单的例子
$LOAD_PATH.unshift(File.dirname(__FILE__)) require 'rack' require 'decorator' my_app = lambda { |env| request = Rack::Request.new(env) response = Rack::Response.new response["Content-Type"] = "text/html" if request.path_info == "/hello" response.write("you say hello") else response.write("you need say something") end response.finish } Rack::Handler::WEBrick.run Decorator.new(my_app), :Port => 3000
这段代码中我们的rack应用程序是一个lambda(lambda具有call方法的) 前面几行没什么好说的,大家看最后一句:
Rack::Handler::WEBrick.run Decorator.new(my_app), :Port => 3000
我们最后传给run的是Decorator对象,这个对象在构造时接受一个rack应用为参数,这个实例既然能被Handler调用,可想而知,我们Decorator必然具备call方法,所以我们也就清楚这个类的结构如下:
class Decorator def initialize(app) ...... end def call(env) ...... end end
ok,接下来我们编写Decorator
class Decorator def initialize(app) @app = app end def call(env) status, headers, body = @app.call(env) new_body = "=======beader=========<br/>" body.each { |str| new_body << str } new_body << "<br/>======footer=========" headers["Content-Length"] = new_body.bytesize.to_s [status, headers, [new_body]] end end
启动应用,在浏览器上看看效果:
=======beader=========
you say hello
======footer=========
由上可知,Decorator运行在Ruby应用服务器和Rack应用程序之间,因此Decorator就是一个中间件,而且我们可以知道,任何Rack中间件必然是一个合法的Rack应用程序。
3、为什么要用中间件
中间件可以实现通用逻辑和业务逻辑分离,并且这些通用逻辑可以应用到各种各样的业务逻辑中。
二、装配中间件
前面我看到一个Rack中间件必然是一个合法的Rack应用程序,那么我们不难想到,一个中间件 外面可以在包装一个中间件,每一个中间件都是独立的,只关心自己的逻辑实现,这样我们就 可以对整个框架或系统中的中间件进行替换,我们还可以用不同的方式去组合多个中间件,从 而满足我们的需求。
1、如何装配中间件
我们往往会在一个应用程序中使用多个中间件,最直接的办法就是new出我们需要的中间件,
例如我们要用middleware1和middleware2两个中间件,那我们可以这样编写代码:
Rack::Handler::WEBrick.run middleware1.new(middleware2.new(rack_app)), :Port => 3000
当然这并不是一个好办法,如果我们要用的中间件非常多,那这段代码就会非常冗⻓,好在Rack已经想到这一点,并且提供了一个非常好的办法:
Rack::Builder
我们利用Builder修改我们之前的代码:
app = lambda { |env| request = Rack::Request.new(env) response = Rack::Response.new response["Content-Type"] = "text/html" if request.path_info == "/hello" response.write("you say hello") else response.write("you need say something") end response.finish } my_app = Rack::Builder.new { use Decorator run app }.to_app Rack::Handler::WEBrick.run my_app, :Port => 3000
如果要用多个中间件,那就写成这样:
use middleware1
use middleware2
user middleware3
......
PS:前面大家可能注意到,中间件采用了装饰器的设计模式,所以当使用多个中间件时,各个中间件之间顺序是需要注意的
我们来看看Builder中几个重要的方法
initialize
def initialize(default_app = nil,&block) @use, @map, @run, @warmup = [], nil, default_app, nil instance_eval(&block) if block_given? end
initialize:构造方法,能够接受语句块
use
def use(middleware, *args, &block) if @map mapping, @map = @map, nil @use << proc { |app| generate_map app, mapping } end @use << proc { |app| middleware.new(app, *args, &block) } end
use:记录要创建的中间件及其顺序。
run
def run(app) @run = app end
run:记录原始的应用程序
to_app
def to_app app = @map ? generate_map(@run, @map) : @run fail "missing run or map statement" unless app app = @use.reverse.inject(app) { |a,e| e[a] } @warmup.call(app) if @warmup app end
to_app:根据use和run中的纪录组合最终的应用程序