› Falcon › Source › Falcon › Middleware › Redirect

`class Redirect`

A HTTP middleware for redirecting a given set of hosts to a different endpoint. Typically used for implementing HTTP -> HTTPS redirects.

Definitions

`def initialize(app, hosts, endpoint)`

Initialize the redirect middleware.

Signature

parameter　app　Protocol::HTTP::Middleware: The middleware to wrap.
parameter　hosts　Hash(String, Service::Proxy): The map of hosts.
parameter　endpoint　Endpoint: The template endpoint to use to build the redirect location.

Implementation

def initialize(app, hosts, endpoint)
	super(app)
	
	@hosts = hosts
	@endpoint = endpoint
end

`def lookup(request)`

Lookup the appropriate host for the given request.

Signature

parameter　request　Protocol::HTTP::Request

Implementation

def lookup(request)
	# Trailing dot and port is ignored/normalized.
	if authority = request.authority&.sub(/(\.)?(:\d+)?$/, '')
		return @hosts[authority]
	end
end

`def call(request)`

Redirect the request if the authority matches a specific host.

Signature

parameter　request　Protocol::HTTP::Request

Implementation

def call(request)
	if host = lookup(request)
		if @endpoint.default_port?
			location = "#{@endpoint.scheme}://#{host.authority}#{request.path}"
		else
			location = "#{@endpoint.scheme}://#{host.authority}:#{@endpoint.port}#{request.path}"
		end
		
		return Protocol::HTTP::Response[301, [['location', location]], []]
	else
		super
	end
end