Class: Rails::Configuration::MiddlewareStackProxy

Inherits:
Object
  • Object
show all
Defined in:
railties/lib/rails/configuration.rb

Overview

MiddlewareStackProxy is a proxy for the Rails middleware stack that allows you to configure middlewares in your application. It works basically as a command recorder, saving each command to be applied after initialization over the default middleware stack, so you can add, swap, or remove any middleware in Rails.

You can add your own middlewares by using the config.middleware.use method:

config.middleware.use Magical::Unicorns

This will put the Magical::Unicorns middleware on the end of the stack. You can use insert_before if you wish to add a middleware before another:

config.middleware.insert_before ActionDispatch::Head, Magical::Unicorns

There’s also insert_after which will insert a middleware after another:

config.middleware.insert_after ActionDispatch::Head, Magical::Unicorns

Middlewares can also be completely swapped out and replaced with others:

config.middleware.swap ActionDispatch::Flash, Magical::Unicorns

And finally they can also be removed from the stack completely:

config.middleware.delete ActionDispatch::Flash

Instance Method Summary collapse

Constructor Details

#initialize ⇒ MiddlewareStackProxy

Returns a new instance of MiddlewareStackProxy.



36
37
38
 
# File 'railties/lib/rails/configuration.rb', line 36

def initialize
  @operations = []
end

Instance Method Details

#delete(*args, &block) ⇒ Object 



58
59
60
 
# File 'railties/lib/rails/configuration.rb', line 58

def delete(*args, &block)
  @operations << [__method__, args, block]
end

#insert_after(*args, &block) ⇒ Object 



46
47
48
 
# File 'railties/lib/rails/configuration.rb', line 46

def insert_after(*args, &block)
  @operations << [__method__, args, block]
end

#insert_before(*args, &block) ⇒ Object Also known as: insert 



40
41
42
 
# File 'railties/lib/rails/configuration.rb', line 40

def insert_before(*args, &block)
  @operations << [__method__, args, block]
end

#merge_into(other) ⇒ Object

:nodoc:



62
63
64
65
66
67
 
# File 'railties/lib/rails/configuration.rb', line 62

def merge_into(other) #:nodoc:
  @operations.each do |operation, args, block|
    other.send(operation, *args, &block)
  end
  other
end

#swap(*args, &block) ⇒ Object 



50
51
52
 
# File 'railties/lib/rails/configuration.rb', line 50

def swap(*args, &block)
  @operations << [__method__, args, block]
end

#use(*args, &block) ⇒ Object 



54
55
56
 
# File 'railties/lib/rails/configuration.rb', line 54

def use(*args, &block)
  @operations << [__method__, args, block]
end