› Falcon › Source › Falcon › Middleware › Verbose

class Verbose

A HTTP middleware for logging requests and responses.

Definitions

def initialize(app, logger = Console)

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)
	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, "-> #{request.method} #{request.path}", headers: request.headers.to_h, address: 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 |body, error|
		@logger.info(request, "<- #{request.method} #{request.path}", headers: response.headers.to_h, status: response.status, body: body.inspect, error: error)
	end
	
	return response
end