class Rack::Response
Your application’s call
should end returning Response#finish.write
are synchronous with the Rack response.finish
. finish
however can take a block inside which calls to
but note that this is buffered by Rack::Response until you call
You can use Response#write to iteratively generate your response,
defaults (an OK response with empty headers and body).
It allows setting of headers and cookies, and provides useful
response.
Rack::Response provides a convenient interface to create a Rack
def self.[](status, headers, body)
def self.[](status, headers, body) self.new(body, status, headers) end
def chunked?
def chunked? CHUNKED == get_header(TRANSFER_ENCODING) end
def close
def close @body.close if @body.respond_to?(:close) end
def delete_header(key); headers.delete key; end
def delete_header(key); headers.delete key; end
def each(&callback)
def each(&callback) @body.each(&callback) @buffered = true if @block @writer = callback @block.call(self) end end
def empty?
def empty? @block == nil && @body.empty? end
def finish(&block)
-
(Array)
- a 3-tuple suitable of `[status, headers, body]`
def finish(&block) if STATUS_WITH_NO_ENTITY_BODY[status.to_i] delete_header CONTENT_TYPE delete_header CONTENT_LENGTH close return [@status, @headers, []] else if block_given? @block = block return [@status, @headers, self] else return [@status, @headers, @body] end end end
def get_header(key); headers[key]; end
def get_header(key); headers[key]; end
def has_header?(key); headers.key? key; end
def has_header?(key); headers.key? key; end
def initialize(body = nil, status = 200, headers = {})
-
headers
(#each
) -- a list of key-value header pairs which -
status
(Integer
) -- the integer status as defined by the -
body
(nil, #each, #to_str
) -- the response body.
def initialize(body = nil, status = 200, headers = {}) @status = status.to_i @headers = Utils::HeaderHash[headers] @writer = self.method(:append) @block = nil # Keep track of whether we have expanded the user supplied body. if body.nil? @body = [] @buffered = true @length = 0 elsif body.respond_to?(:to_str) @body = [body] @buffered = true @length = body.to_str.bytesize else @body = body @buffered = false @length = 0 end yield self if block_given? end
def redirect(target, status = 302)
def redirect(target, status = 302) self.status = status self.location = target end
def set_header(key, v); headers[key] = v; end
def set_header(key, v); headers[key] = v; end
def write(chunk)
NOTE: Do not mix #write and direct #body access!
Append to body and update Content-Length.
def write(chunk) buffered_body! @writer.call(chunk.to_s) end