Rainbows! 5.2.1
[rainbows.git] / lib / rainbows / max_body.rb
blob56a77abf0afa6f208e31058a51b5066ebcfe2db7
1 # -*- encoding: binary -*-
3 # Middleware used to enforce client_max_body_size for TeeInput users.
5 # There is no need to configure this middleware manually, it will
6 # automatically be configured for you based on the client_max_body_size
7 # setting.
9 # For more fine-grained control, you may also define it per-endpoint in
10 # your Rack config.ru like this:
12 #        map "/limit_1M" do
13 #          use Rainbows::MaxBody, 1024*1024
14 #          run MyApp
15 #        end
16 #        map "/limit_10M" do
17 #          use Rainbows::MaxBody, 1024*1024*10
18 #          run MyApp
19 #        end
21 # This is only compatible with concurrency models that expose a streaming
22 # "rack.input" to the Rack application.  Thus it is NOT compatible with
23 # any of the following as they fully buffer the request body before
24 # the application dispatch:
26 # * :Coolio
27 # * :CoolioThreadPool
28 # * :CoolioThreadSpawn
29 # * :Epoll
30 # * :EventMachine
31 # * :NeverBlock
32 # * :Rev
33 # * :RevThreadPool
34 # * :RevThreadSpawn
35 # * :XEpoll
37 # However, the global Rainbows::Configurator#client_max_body_size is compatible
38 # with all concurrency models \Rainbows! supports.
39 class Rainbows::MaxBody
41   # This is automatically called when used with Rack::Builder#use
42   def initialize(app, limit = nil)
43     case limit
44     when Integer, nil
45     else
46       raise ArgumentError, "limit not an Integer"
47     end
48     @app, @limit = app, limit
49   end
51   # our main Rack middleware endpoint
52   def call(env)
53     @limit = Rainbows.server.client_max_body_size if nil == @limit
54     catch(:rainbows_EFBIG) do
55       len = env['CONTENT_LENGTH']
56       if len && len.to_i > @limit
57         return err
58       elsif /\Achunked\z/i =~ env['HTTP_TRANSFER_ENCODING']
59         limit_input!(env)
60       end
61       @app.call(env)
62     end || err
63   end
65   # this is called after forking, so it won't ever affect the master
66   # if it's reconfigured
67   def self.setup # :nodoc:
68     Rainbows.server.client_max_body_size or return
69     case Rainbows.server.use
70     when :Rev, :Coolio, :EventMachine, :NeverBlock,
71          :RevThreadSpawn, :RevThreadPool,
72          :CoolioThreadSpawn, :CoolioThreadPool,
73          :Epoll, :XEpoll
74       return
75     end
77     # force ourselves to the outermost middleware layer
78     Rainbows.server.app = self.new(Rainbows.server.app)
79   end
81   # Rack response returned when there's an error
82   def err # :nodoc:
83     [ 413, { 'Content-Length' => '0', 'Content-Type' => 'text/plain' }, [] ]
84   end
86   def limit_input!(env)
87     input = env['rack.input']
88     klass = input.respond_to?(:rewind) ? RewindableWrapper : Wrapper
89     env['rack.input'] = klass.new(input, @limit)
90   end
92   # :startdoc:
93 end
94 require 'rainbows/max_body/wrapper'
95 require 'rainbows/max_body/rewindable_wrapper'