Rack::Response provides a convenient interface to create a Rack response.
It allows setting of headers and cookies, and provides useful defaults (a OK response containing HTML).
You can use Response#write to iteratively generate your response, but note that this is buffered by Rack::Response until you call finish. finish however can take a block inside which calls to write are synchronous with the Rack response.
Your application's call should end returning Response#finish.
# File lib/rack/response.rb, line 22 def initialize(body=[], status=200, header={}) @status = status.to_i @header = Utils::HeaderHash.new.merge(header) @chunked = "chunked" == @header['Transfer-Encoding'] @writer = lambda { |x| @body << x } @block = nil @length = 0 @body = [] if body.respond_to? :to_str write body.to_str elsif body.respond_to?(:each) body.each { |part| write part.to_s } else raise TypeError, "stringable or iterable required" end yield self if block_given? end
# File lib/rack/response.rb, line 53 def []=(key, value) header[key] = value end
# File lib/rack/response.rb, line 104 def close body.close if body.respond_to?(:close) end
# File lib/rack/response.rb, line 85 def each(&callback) @body.each(&callback) @writer = callback @block.call(self) if @block end
# File lib/rack/response.rb, line 108 def empty? @block == nil && @body.empty? end
# File lib/rack/response.rb, line 70 def finish(&block) @block = block if [204, 205, 304].include?(status.to_i) header.delete "Content-Type" header.delete "Content-Length" close [status.to_i, header, []] else [status.to_i, header, BodyProxy.new(self){}] end end
# File lib/rack/response.rb, line 65 def redirect(target, status=302) self.status = status self["Location"] = target end
Generated with the Darkfish Rdoc Generator 2.