Ruby进阶之Rack深入

作者: 感觉被掏空 | 来源:发表于2016-12-28 16:44 被阅读157次

    之前讲述了基础的Rack使用,现在我们来试试深入Rack,如果不了解Rack,可以去看看之前一篇最基础的 Ruby进阶之Rack入门

    分析

    • Rack通过rackup命令启动,是如何选择应该启动哪个web容器?
    • Rack的中间件是如何调用的,如何确定中间件调用顺序?
    • 常用的几个模块介绍

    如何确定启动的web容器

    我们来看看rackup启动流程

    # rackup是Rack提供的命令,我们可以在gem包的bin目录找到该命令
    
    #!/usr/bin/env ruby
    require "rack"
    Rack::Server.start
    
    # 如果我们不用rackup命令,也可以直接在代码里指定启动参数
    #  Rack::Server.start(
    #    :app => lambda do |e|
    #      [200, {'Content-Type' => 'text/html'}, ['hello world']]
    #    end,
    #    :server => 'cgi'
    #  )
    

    rackup只有简单的两行代码,帮我们引入了rack,所以我们写代码时不用引入

    • Rack::Server.start 也是我们之前编码中省略的一部分,和我们之前省略 Rack:Builder.app 一样,在进行简单操作的时候,Rack允许我们不写这些繁琐代码

    • 其实只有在运行类似hello world这种简单代码时我们才省略并简写,正式使用过程中,还是建议按正常步骤写,尤其是在对Rack不是特别熟悉的时候,老老实实地Rack::Builder.new和Rack::Server.start吧

    • 顺便提一下,Rack::Builder.new 和 Rack::Builderf.app 是一样的,没有区别

    我们进入 lib/rack/server.rb 中,代码较多,我们看关键部分

    
    module Rack
      class Server
        #  Rack::Server.start(
        #    :app => lambda do |e|
        #      [200, {'Content-Type' => 'text/html'}, ['hello world']]
        #    end,
        #    :server => 'cgi'
        #  )
        # 实例化Server对象,Server对象接收类似上方的参数
        def self.start(options = nil)
          new(options).start
        end
      end
    end
    

    由于我们是通过rackup直接启动,start方法中我们是没传递参数的,所以来看看Rack如何自己确定选用哪个服务器

    module Rack
      class Server
        # server方法中,执行了服务器的选择逻辑, 我们可以看到,调用了Rack::Handler中的get方法
        def server
          @_server ||= Rack::Handler.get(options[:server])
    
          unless @_server
            @_server = Rack::Handler.default
    
            # We already speak FastCGI
            @ignore_options = [:File, :Port] if @_server.to_s == 'Rack::Handler::FastCGI'
          end
          @_server
        end
      end
    end
    

    上面这段代码,表明了如果没指定server,会自行选择,并且,如果Rack::Handler.get没能选出server,默认将会以FastCGI的方式运行

    我们进入lib/rack/handler.rb看看关键代码

    
    module Rack
      class Handler
        # 默认接受选择的server种类
        def self.default
          # Guess.
          if ENV.include?("PHP_FCGI_CHILDREN")
            Rack::Handler::FastCGI
          elsif ENV.include?(REQUEST_METHOD)
            Rack::Handler::CGI
          elsif ENV.include?("RACK_HANDLER")
            self.get(ENV["RACK_HANDLER"])
          else
            pick ['puma', 'thin', 'webrick']
          end
        end
      end
    end
    
    
    • 首先会被选择的依然是FastCGI,这种方式很高效,不过我还没发现哪个ruby框架采用的是FastCGI,不明白为什么
    • 然后被选择的是CGI方式启动
    • 然后看看用户有没有指定需要启动的server
    • 最后在 puma\thin\webrick 中依次选择

    换句话说,如果我本地装有puma和thin的gem,默认情况下会启动puma

    调用栈

    之前我们在Rack中间件的时候提到过调用栈,现在我们来分析下Rack的调用栈是如何工作的

    我们进入lib/rack/builder.rb 看看use方法的定义

    module Rack
      class Builder
        # 这就是我们在使用中间件时调用的use方法
        def use(middleware, *args, &block)
          # ....此处省略小部分代码....
          @use << proc { |app| middleware.new(app, *args, &block) }
        end
      end
    end
    

    我们可以看到,有一个数组@use,收集我们传递的中间件,并以proc的方式包装了起来

    我们讲过,Rack运行前都会通过Rack::Builder实例化一个app对象,在实例化app对象的时候,就会对@use里面包含的中间件进行组合,形成调用栈

    我们看以下代码

    module Rack
      class Builder
        # 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
    
        # 运行前会生成app对象
        def call(env)
          to_app.call(env)
        end
      end
    end
    

    不知道大家有没有理解app = @use.reverse.inject(app) { |a,e| e[a] } ,这段代码将所有中间件组合在了一起
    由于proc和中间件都是响应call方法的对象,一层一层嵌套,在调用to_app.call(env) 的时候,所有call方法都会依次执行

    可以看看一个调用方式类似的demo代码

    #! /usr/bin/env ruby
    #  encoding: utf-8
    
    use = []
    run = 'hello'
    
    5.times do |i|
      use << proc { |item| "#{item}-#{i}" }
    end
    
    # 将字符串按顺序连接
    app = use.reverse.inject(run) { |a, e| e[a] }
    
    puts app
    
    # 最后将会输出
    "hello-4-3-2-1-0"
    

    常用模块 - Rack::Request

    这个模块几乎所有基于rack的框架都用啦,基本把Request相关的信息都封装好了,使用更加简单

    #! /usr/bin/env ruby
    #  encoding: utf-8
    
    class MyApp
      def call(env)
        # 创建一个request对象,就能享受Rack::Request的便捷操作了
        @request = Rack::Request.new env
        puts @request.request_method
        puts @request.path_info
        [200, {}, ['hello world']]
      end
    end
    
    # 我们创建一个 rack app
    app = Rack::Builder.new do 
      run MyApp.new
    end
    
    # 启动 server
    Rack::Server.start(:app => app, :server => 'webrick')
    

    更多的Rack::Request操作可以参照文档

    常用模块 - Rack:Response

    这个模块也是几乎所有基于rack的框架都用,把Response相关的操作都做了封装

    #! /usr/bin/env ruby
    #  encoding: utf-8
    
    class MyApp
      def call(env)
        @response = Rack::Response.new
        @response.set_cookie('token', 'xxxxxxx')
        @response.headers['Content-Type'] = 'text/plain'
        [200, {}, ['hello world']]
      end
    end
    
    # 我们创建一个 rack app
    app = Rack::Builder.new do 
      run MyApp.new
    end
    
    # 启动 server
    Rack::Server.start(:app => app, :server => 'webrick')
    

    更多的Rack::Response操作可以参照文档

    ** Rack暂且讲到这里,很多有用的工具模块可以多去看看Rack源码或者文档,后面找时间用Rack实现一个自己的框架 **

    相关文章

      网友评论

        本文标题:Ruby进阶之Rack深入

        本文链接:https://www.haomeiwen.com/subject/xbvevttx.html