NAME

Mojo::IOLoop::Stream::HTTPClient - Non-blocking I/O HTTP client stream

SYNOPSIS

  use Mojo::IOLoop::Client;
  use Mojo::IOLoop::Stream::HTTPClient;
  use Mojo::Transaction::HTTP;
  
  # Create transaction
  my $tx = Mojo::Transaction::HTTP->new;
  $tx->req->method('GET')
  $tx->url->parse('https://mojolicious.org');
  $tx->on(
    finish => sub {
      my $tx = shift;
      say $tx->res->code;
    }
  );
  
  # Create socket connection
  my $client = Mojo::IOLoop::Client->new;
  $client->on(
    connect => sub {
      my $stream = Mojo::IOLoop::Stream::HTTPClient->new(pop);
      $stream->start;
      $stream->process($tx);
    }
  );
  $client->connect(address => 'mojolicious.org', port => 80);

  # Start reactor if necessary
  $stream->reactor->start unless $stream->reactor->is_running;

DESCRIPTION

Mojo::IOLoop::Stream::HTTPClient is a container for I/O streams used by Mojo::IOLoop to support the HTTP protocol client-side.

EVENTS

Mojo::IOLoop::Stream::HTTPClient inherits all events from Mojo::IOLoop::Stream and can emit the following new ones.

upgrade

  $stream->on(upgrade => sub {
    my ($stream, $ws) = @_;
    ...
  });

Emitted when the connection should be upgraded to the WebSocket protocol.

ATTRIBUTES

Mojo::IOLoop::Stream::HTTPClient inherits all attributes from Mojo::IOLoop::Stream and implements the following ones.

request_timeout

  my $timeout = $stream->request_timeout;
  $stream     = $stream->request_timeout(5);

Maximum amount of time in seconds sending the request and receiving a whole response may take before getting canceled, defaults to 0. Setting the value to 0 will allow to wait indefinitely.

METHODS

Mojo::IOLoop::Stream::HTTPClient inherits all methods from Mojo::IOLoop::Stream and implements the following new ones.

new

  my $stream = Mojo::IOLoop::Stream::HTTPClient->new($handle);

Construct a new Mojo::IOLoop::Stream::HTTPClient object.

process

  $stream->process(Mojo::Transaction::HTTP->new);

Process a Mojo::Transaction::HTTP object with the current connection.

DEBUGGING

You can set the MOJO_CLIENT_DEBUG environment variable to get some advanced diagnostics information printed to STDERR.

  MOJO_CLIENT_DEBUG=1

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicious.org.