Class Rev::HttpClient
In: lib/rev/http_client.rb
Parent: TCPSocket

HTTP client class implemented as a subclass of Rev::TCPSocket. Encodes requests and allows streaming consumption of the response. Response is parsed with a Ragel-generated whitelist parser which supports chunked HTTP encoding.

Example

  loop = Rev::Loop.default
  client = Rev::HttpClient.connect("www.google.com").attach
  client.get('/search', query: {q: 'foobar'})
  loop.run

Methods

connect   dispatch   enable   new   on_body_data   on_connect   on_error   on_read   on_request_complete   on_response_header   request   send_request   send_request_body   send_request_header  

Included Modules

HttpEncoding

Constants

ALLOWED_METHODS = [:put, :get, :post, :delete, :head]
TRANSFER_ENCODING = "TRANSFER_ENCODING"
CONTENT_LENGTH = "CONTENT_LENGTH"
SET_COOKIE = "SET_COOKIE"
LOCATION = "LOCATION"
HOST = "HOST"
CRLF = "\r\n"

Public Class methods

connect(addr, port = 80, *args)

Connect to the given server, with port 80 as the default

Public Instance methods

enable()

Enable the HttpClient if it has been disabled

on_body_data(data)

Called when part of the body has been read

on_error(reason)

Called when an error occurs dispatching the request

on_request_complete()

Called when the request has completed

on_response_header(response_header)

Called when response header has been received

request(method, path, options = {})

Send an HTTP request and consume the response. Supports the following options: 

  head: {Key: Value}
    Specify an HTTP header, e.g. {'Connection': 'close'}

  query: {Key: Value}
    Specify query string parameters (auto-escaped)

  cookies: {Key: Value}
    Specify hash of cookies (auto-escaped)

  body: String
    Specify the request body (you must encode it for now)

Protected Instance methods

dispatch()

Response processing

send_request()

Request sending

[Validate]