Ruby进阶之Rack入门

简介

基本上所有的 Ruby web framework 都是Rack App，web框架大多都是基于rack之上的，比如Ruby On Rails、Sinatra.......，Rack帮助我们封装处理了很多基本的操作，并提供了大量工具

Rack

安装 gem

gem install rack

如何使用

• rack 会将请求参数封装成为一个Hash对象，叫做 env
• 它需要一个响应 call 方法的对象, 接受 env 参数
• 处理结束后，需要返回三元素的数组: 分别是 status code, header, body，其中 status code 是HTTP状态码， header 是一个 hash, body 是一个响应 each 方法的对象

简单尝试

#! /usr/bin/env ruby
#  encoding: utf-8

require 'rack'

app = proc { |env| [200, {}, ['hello world']] }

::Rack::Handler::WEBrick.run app

• 运行上面代码，WEBrick服务器就会启动，访问localhost:8080就能得到一个hello world返回
• 注意： ruby的块（proc, lambda）都是响应call方法的对象
• 200是要返回的状态码，响应头我们保持默认，不做设置，故传递 {}，响应each方法的对象我们一般传递一个数组，当然，也可以是其他能响应each方法的对象

分析

• WEBrick是我们最常见的web容器了吧，但是在这里，并不像我们单独使用WEBrick那样启动，Rack已经将WEBrick托管了，这里由Rack来启动服务器
• Rack托管的web容器还有很多，比如Thin, Puma, CGI .......
• 我们可以将Rack定义为一个介于web app 和 web 容器之间的中间件或者接口

env对象

#! /usr/bin/env ruby
#  encoding: utf-8

require 'rack'

class MyApp
  def call(env)
    puts env.inspect
    [200, {'Content-Type' => 'text/plain'}, ['hello world']]
  end
end

::Rack::Handler::WEBrick.run MyApp.new

• 如果你运行了以上代码，你可以在console看到env对象的输出
• env 对象将请求的所有信息进行了封装成了一个hash对象，直接操作hash对象，简化了我们使用的复杂度
• Rack还提供了很多强大的辅助模块，帮助我们进一步解析env对象，比如Rack::Request和Rack::Response模块（后面再讲）

Rack中间件介绍

• 由于web应用的复杂性，我们为了代码的封装，不可能在一个对象的call方法中就完成所有操作，我们可能需要将通用的逻辑分离
• Rack的中间件特性可以让我们链式调用处理对象，直到处理完成，并且方便对中间件的自由组合
• 另外：Rack中间件的调用方式十分优雅，之后会分析Rack调用原理

Rack中间件简单使用

新建一个文件 config.ru

#! /usr/bin/env ruby
#  encoding: utf-8

require 'rack'

class MyMiddleware
  def initialize(app)
    @app = app
  end

  def call(env)
    code, headers, body = @app.call(env)
    body << ['this is my middleware']
    [code, headers, body]
  end
end

class MyApp
  def call(env)
    [200, {'Content-Type' => 'text/plain'}, ['hello world']]
  end
end

use MyMiddleware
run MyApp.new

• 这次我们在console通过rackup命令启动， rackup是Rack提供的命令，它会默认执行当前目录下config.ru文件，可以不用写require 'rack'，并且文件中我们可以直接写run MyApp.new，不用显示写出web容器，Rack会根据当前情况自己选择web容器启动
• 运行上面的代码，最后得到看到的返回内容，除了hello world, 还有this is my middleware
• 因为Rack需要一个响应call方法的对象，只要让中间件也响应同样的方法，再配合设计模式中的组合模式，就实现了所谓的Rack中间件
• Rack其实是将MyApp的对象作为参数传递给了MyMiddleware， 当Rack去调用MyMiddleware的call方法时，也会触发MyApp的call方法
• 这里建议大家有空看看组合模式，以上相当于在调用MyMiddleware.new(MyApp.new()).call(env)

Rack提供的路由

• Rack也提供了路由功能，大概所有框架都是自带一套路由解析规则，不过Rack提供了最基础的路由定义
• 我们来试试一个简单的路由，当然咯，会比之前的代码复杂一点

#! /usr/bin/env ruby
#  encoding: utf-8

require 'rack'

class MyMiddleware
  def initialize(app)
    @app = app
  end

  def call(env)
    code, headers, body = @app.call(env)
    body << 'this is my middleware'
    [code, headers, body]
  end
end

class MyApp
  def call(env)
    [200, {'Content-Type' => 'text/plain'}, ['hello world']]
  end
end

app = Rack::Builder.app do 
  map '/' do
    run MyApp.new
  end
  map '/middleware' do
    use MyMiddleware
    run MyApp.new
  end
end

run app

• rackup运行以上代码，两个路由的返回结果肯定是不一样的，一个采用了中间件，一个没有
• 比起之前的代码，我们创建了一个Rack::Builder对象，里面定义了路由规则，之前没有使用路由时的代码，只是没有显示创建Rack::Builder对象，其实每个Rack App，都是Rack::Builder实例化的对象
• run 和 use 都是可以多次使用的，方便根据功能灵活选择
• 注意：在唯一路由中，只应该出现一个 run ，这是我们逻辑处理的入口

总结

• Rack封装了web的基本操作，这些操作很基础，但是很繁琐
• 封装过的env对象，让我们处理http请求信息十分容易
• 中间件的使用，可以让我们方便地实现代码的热插拔和过滤器等等功能
• 简单的路由也方便了更多的扩展功能

后面我们会深入Rack更多知识