ruby-on-rails - "use"Ruby/Rails/Rack 代码中的关键字/词

Question

最近我在查看与goliath相关的一些代码时，偶然在Ruby代码中看到了这个词use。 , 中间件等。看起来它不同于include/extend, and require.

有人可以解释为什么存在这个 use 关键字，以及它与 include/require 有何不同？它是如何工作的，何时使用它？

Answer 1

文档

正如人们指出的那样，use 不是Ruby 关键字，它实际上是Rack::Builder class 的一个方法。 :

use(middleware, *args, &block)

Specifies middleware to use in a stack.

This documentation ( pointed out by @user166390 ) 是这样描述的:

Rack::Builder implements a small DSL to iteratively construct Rack applications.

Example:

app = Rack::Builder.new {
  use Rack::CommonLogger
  use Rack::ShowExceptions
  map "/lobster" do
    use Rack::Lint
    run Rack::Lobster.new
  end
}

Or

app = Rack::Builder.app do
  use Rack::CommonLogger
  lambda { |env| [200, {'Content-Type' => 'text/plain'}, 'OK'] }
end

use adds a middleware to the stack, run dispatches to an application.

源代码

我不太熟悉 Rack::Builder source code , 但看起来每次你用一个新的中间件模块调用 use 时，它都会被添加到一个数组中，并且每个模块都按照添加它的相反顺序运行/注入(inject)(最后一个-先出顺序，又名堆栈顺序)。运行前一个中间件的结果通过inject传递给堆栈中的下一个中间件。 :

1. Lines 53-56 :

   def initialize(default_app = nil,&block)
     # @use is parallel assigned to [].
     @use, @map, @run = [], nil, default_app
     instance_eval(&block) if block_given?
   end
   

2. Lines 81-87 :

   def use(middleware, *args, &block)
     if @map
       mapping, @map = @map, nil
       @use << proc { |app| generate_map app, mapping }
     end
     # The new middleware is added to the @use array.
     @use << proc { |app| middleware.new(app, *args, &block) }
   end
   

3. Lines 131-135 :

   def to_app
     app = @map ? generate_map(@run, @map) : @run
     fail "missing run or map statement" unless app
     # The middlewares are injected in reverse order.
     @use.reverse.inject(app) { |a,e| e[a] }
   end
   

其他资源

1. A Quick Introduction to Rack .
2. Ruby on Rack #2 - The Builder .