Falcon SourceFalconMiddlewareVerbose

class Verbose

A HTTP middleware for logging requests and responses.

Definitions

def initialize(app, logger = Console.logger)

Initialize the verbose middleware.

Signature

parameter app Protocol::HTTP::Middleware

The middleware to wrap.

parameter logger Console::Logger

The logger to use.

Implementation

def initialize(app, logger = Console.logger)
	super(app)
	
	@logger = logger
end

def annotate(request)

Log details of the incoming request.

Implementation

def annotate(request)
	task = Async::Task.current
	address = request.remote_address
	
	@logger.info(request) {"Headers: #{request.headers.to_h} from #{address.inspect}"}
	
	task.annotate("#{request.method} #{request.path} from #{address.inspect}")
end

def call(request)

Log details of the incoming request using Falcon::Middleware::Verbose#annotate and wrap the response to log response details too.

Implementation

def call(request)
	annotate(request)
	
	statistics = Async::HTTP::Statistics.start
	
	response = super
	
	statistics.wrap(response) do |statistics, error|
		@logger.info(request) {"Responding with: #{response.status} #{response.headers.to_h}; #{statistics.inspect}"}
		
		@logger.error(request) {"#{error.class}: #{error.message}"} if error
	end
	
	return response
end