/ 
Mojolicious-3.12
River stage four • 995 direct dependents • 1115 total dependents
/ Mojo::UserAgent::Transactor

NAME

Mojo::UserAgent::Transactor - User agent transactor

SYNOPSIS

use Mojo::UserAgent::Transactor;

my $t  = Mojo::UserAgent::Transactor->new;
my $tx = $t->tx(GET => 'http://mojolicio.us');

DESCRIPTION

Mojo::UserAgent::Transactor is the transaction building and manipulation framework used by Mojo::UserAgent.

METHODS

Mojo::UserAgent::Transactor inherits all methods from Mojo::Base and implements the following new ones.

endpoint

my ($scheme, $host, $port) = $t->endpoint(Mojo::Transaction::HTTP->new);

Actual endpoint for transaction.

form

my $tx = $t->form('kraih.com' => {a => 'b'});
my $tx = $t->form('http://kraih.com' => {a => 'b'});
my $tx = $t->form('http://kraih.com' => {a => [qw(b c d)]});
my $tx = $t->form('http://kraih.com' => {mytext => {file => '/foo.txt'}});
my $tx = $t->form('http://kraih.com' => {mytext => {content => 'lalala'}});
my $tx = $t->form('http://kraih.com' => {
  myzip => {
    file     => Mojo::Asset::Memory->new->add_chunk('lalala'),
    filename => 'foo.zip',
    DNT      => 1
  }
});
my $tx = $t->form('http://kraih.com' => 'UTF-8' => {a => 'b'});
my $tx = $t->form('http://kraih.com' => {a => 'b'} => {DNT => 1});
my $tx = $t->form('http://kraih.com', 'UTF-8', {a => 'b'}, {DNT => 1});

Versatile Mojo::Transaction::HTTP builder for POST requests with form data.

# Multipart upload with filename
my $tx = $t->form(
  'mojolicio.us' => {fun => {content => 'Hello!', filename => 'test.txt'}});

# Multipart upload streamed from file
my $tx = $t->form('mojolicio.us' => {fun => {file => '/etc/passwd'}});

# Inspect generated request
say $t->form('mojolicio.us' => {a => [1, 2], b => 3})->req->to_string;

While the "multipart/form-data" content type will be automatically used instead of "application/x-www-form-urlencoded" when necessary, you can also enforce it by setting the header manually.

# Force multipart
my $tx = $t->form(
  'http://kraih.com/foo',
  {a => 'b'},
  {'Content-Type' => 'multipart/form-data'}
);

json

my $tx = $t->json('kraih.com' => {a => 'b'});
my $tx = $t->json('http://kraih.com' => [1, 2, 3]);
my $tx = $t->json('http://kraih.com' => {a => 'b'} => {DNT => 1});
my $tx = $t->json('http://kraih.com' => [1, 2, 3] => {DNT => 1});

Versatile Mojo::Transaction::HTTP builder for POST requests with JSON data.

# Change method
my $tx = $t->json('mojolicio.us/hello', {hello => 'world'});
$tx->req->method('PATCH');

peer

my ($scheme, $host, $port) = $t->peer(Mojo::Transaction::HTTP->new);

Actual peer for transaction.

proxy_connect

my $tx = $t->proxy_connect(Mojo::Transaction::HTTP->new);

Build Mojo::Transaction::HTTP proxy connect request for transaction if possible.

redirect

my $tx = $t->redirect(Mojo::Transaction::HTTP->new);

Build Mojo::Transaction::HTTP followup request for 301, 302, 303, 307 or 308 redirect response if possible.

tx

my $tx = $t->tx(GET  => 'kraih.com');
my $tx = $t->tx(POST => 'http://kraih.com');
my $tx = $t->tx(GET  => 'http://kraih.com' => {DNT => 1});
my $tx = $t->tx(PUT  => 'http://kraih.com' => 'Hi!');
my $tx = $t->tx(POST => 'http://kraih.com' => {DNT => 1} => 'Hi!');

Versatile general purpose Mojo::Transaction::HTTP builder for requests.

# Inspect generated request
say $t->tx(GET => 'mojolicio.us' => {DNT => 1} => 'Bye!')->req->to_string;

# Streaming response
my $tx = $t->tx(GET => 'http://mojolicio.us');
$tx->res->body(sub { say $_[1] });

# Custom socket
my $tx = $t->tx(GET => 'http://mojolicio.us');
$tx->connection($sock);

websocket

my $tx = $t->websocket('ws://localhost:3000');
my $tx = $t->websocket('ws://localhost:3000' => {DNT => 1});

Versatile Mojo::Transaction::WebSocket builder for WebSocket handshake requests.

SEE ALSO

Mojolicious, Mojolicious::Guides, http://mojolicio.us.