Class: Rage::Configuration::Middleware

Inherits:
MiddlewareRegistry show all
Defined in:
lib/rage/configuration.rb

Overview

See Rage::Configuration::MiddlewareRegistry for details on available methods.

Instance Method Summary collapse

Methods inherited from MiddlewareRegistry

#delete, #include?, #insert_after, #insert_before, #use

Instance Method Details

#allow_outside_request_fiber! { ... } ⇒ Object

Suppress warnings when inserting middleware before FiberWrapper.

By default, Rage warns when middleware is inserted before FiberWrapper because such middleware runs outside the fiber-based request context. This means the middleware won't benefit from Rage's non-blocking I/O scheduling and must handle the custom response format.

Use this method when you intentionally want middleware to run outside the request fiber, for example, to serve static assets without the overhead of creating a fiber for each request.

Examples:

Suppress warnings when inserting a static file server

Rage.configure do
  config.middleware.allow_outside_request_fiber! do
    config.middleware.insert_before 0, MyStaticFileServer
  end
end

Yields:

  • The block within which middleware insertion warnings are suppressed



660
661
662
663
664
665
 
# File 'lib/rage/configuration.rb', line 660

def allow_outside_request_fiber!
  @suppress_fiber_wrapper_warning = true
  yield
ensure
  @suppress_fiber_wrapper_warning = false
end