class WEBrick::HTTPResponse

An HTTP response. This is filled in by the service or do_* methods of a WEBrick HTTP Servlet.

Attributes

Body may be:

a String;
an IO-like object that responds to read and readpartial;
a Proc-like object that responds to call.

In the latter case, either chunked= should be set to true, or header['content-length'] explicitly provided. Example:

server.mount_proc '/' do |req, res|
  res.chunked = true
  # or
  # res.header['content-length'] = 10
  res.body = proc { |out| out.write(Time.now.to_s) }
end

config [R]

Configuration for this response

cookies [R]

Response cookies

filename [RW]

Filename of the static file in this response. Only used by the FileHandler servlet.

header [R]

Response header

http_version [R]

HTTP Response version

keep_alive [RW]

Is this a keep-alive response?

reason_phrase [RW]

Response reason phrase (“OK”)

request_http_version [RW]

Request HTTP version for this response

request_method [RW]

Request method for this response

request_uri [RW]

Request URI for this response

sent_size [R]

Bytes sent in this response

status [R]

Response status code (200)

upgrade [RW]

Set the response body proc as an streaming/upgrade response.

Public Class Methods

new (config)

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 117
def initialize(config)
  @config = config
  @buffer_size = config[:OutputBufferSize]
  @logger = config[:Logger]
  @header = Hash.new
  @status = HTTPStatus::RC_OK
  @reason_phrase = nil
  @http_version = HTTPVersion::convert(@config[:HTTPVersion])
  @body = +""
  @keep_alive = true
  @cookies = []
  @request_method = nil
  @request_uri = nil
  @request_http_version = @http_version  # temporary
  @chunked = false
  @filename = nil
  @sent_size = 0
  @bodytempfile = nil
end

Creates a new HTTP response object. WEBrick::Config::HTTP is the default configuration.

Public Instance Methods

[] (field)

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 155
def [](field)
  @header[field.downcase]
end

Retrieves the response header field

[]= (field, value)

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 162
def []=(field, value)
  @chunked = value.to_s.downcase == 'chunked' if field.downcase == 'transfer-encoding'
  @header[field.downcase] = value.to_s
end

Sets the response header field to value

chunked= (val)

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 214
def chunked=(val)
  @chunked = val ? true : false
end

Enables chunked transfer encoding.

chunked? ()

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 207
def chunked?
  @chunked
end

Will this response body be returned using chunked transfer-encoding?

content_length ()

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 170
def content_length
  if len = self['content-length']
    return Integer(len)
  end
end

The content-length header

content_length= (len)

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 179
def content_length=(len)
  self['content-length'] = len.to_s
end

Sets the content-length header to len

content_type ()

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 186
def content_type
  self['content-type']
end

The content-type header

content_type= (type)

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 193
def content_type=(type)
  self['content-type'] = type
end

Sets the content-type header to type

each () { |field, value| ... }

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 200
def each
  @header.each{|field, value|  yield(field, value) }
end

Iterates over each header in the response

keep_alive? ()

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 221
def keep_alive?
  @keep_alive
end

Will this response’s connection be kept alive?

set_error (ex, backtrace=false)

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 405
def set_error(ex, backtrace=false)
  case ex
  when HTTPStatus::Status
    @keep_alive = false if HTTPStatus::error?(ex.code)
    self.status = ex.code
  else
    @keep_alive = false
    self.status = HTTPStatus::RC_INTERNAL_SERVER_ERROR
  end
  @header['content-type'] = "text/html; charset=ISO-8859-1"

  if respond_to?(:create_error_page)
    create_error_page()
    return
  end

  if @request_uri
    host, port = @request_uri.host, @request_uri.port
  else
    host, port = @config[:ServerName], @config[:Port]
  end

  error_body(backtrace, ex, host, port)
end

Creates an error page for exception ex with an optional backtrace

set_redirect (status, url)

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 395
def set_redirect(status, url)
  url = URI(url).to_s
  @body = "<HTML><A HREF=\"#{url}\">#{url}</A>.</HTML>\n"
  @header['location'] = url
  raise status
end

Redirects to url with a WEBrick::HTTPStatus::Redirect status.

Example:

res.set_redirect WEBrick::HTTPStatus::TemporaryRedirect

status= (status)

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 147
def status=(status)
  @status = status
  @reason_phrase = HTTPStatus::reason_phrase(status)
end

Sets the response’s status to the status code

status_line ()

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 140
def status_line
  "HTTP/#@http_version #@status #@reason_phrase".rstrip << CRLF
end

The response’s HTTP status line

upgrade! (protocol)

Source

# File vendor/bundle/ruby/3.4.0/gems/webrick-1.9.1/lib/webrick/httpresponse.rb, line 229
def upgrade!(protocol)
  @upgrade = protocol
  @keep_alive = false
  @chunked = false
end

Sets the response to be a streaming/upgrade response. This will disable keep-alive and chunked transfer encoding.