Class: Rack::Cascade

Inherits:
Object
  • Object
show all
Defined in:
lib/rack/cascade.rb

Overview

Rack::Cascade tries a request on several apps, and returns the first response that is not 404 or 405 (or in a list of configurable status codes).

Constant Summary collapse

NotFound = 
[404, { CONTENT_TYPE => "text/plain" }, []]

Instance Attribute Summary collapse

Instance Method Summary collapse

Constructor Details

#initialize(apps, catch = [404, 405]) ⇒ Cascade

Returns a new instance of Cascade.



13
14
15
16
17
18
19
 
# File 'lib/rack/cascade.rb', line 13

def initialize(apps, catch = [404, 405])
  @apps = []
  apps.each { |app| add app }

  @catch = {}
  [*catch].each { |status| @catch[status] = true }
end

Instance Attribute Details

#apps ⇒ Object (readonly)

Returns the value of attribute apps.



11
12
13
 
# File 'lib/rack/cascade.rb', line 11

def apps
  @apps
end

Instance Method Details

#add(app) ⇒ Object Also known as: << 



43
44
45
 
# File 'lib/rack/cascade.rb', line 43

def add(app)
  @apps << app
end

#call(env) ⇒ Object 



21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
 
# File 'lib/rack/cascade.rb', line 21

def call(env)
  result = NotFound

  last_body = nil

  @apps.each do |app|
    # The SPEC says that the body must be closed after it has been iterated
    # by the server, or if it is replaced by a middleware action. Cascade
    # replaces the body each time a cascade happens. It is assumed that nil
    # does not respond to close, otherwise the previous application body
    # will be closed. The final application body will not be closed, as it
    # will be passed to the server as a result.
    last_body.close if last_body.respond_to? :close

    result = app.call(env)
    last_body = result[2]
    break unless @catch.include?(result[0].to_i)
  end

  result
end

#include?(app) ⇒ Boolean

Returns:

  • (Boolean) 


47
48
49
 
# File 'lib/rack/cascade.rb', line 47

def include?(app)
  @apps.include?(app)
end