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. Note that this module is EXPERIMENTAL and might change without warning!
METHODS
Mojo::UserAgent::Transactor inherits all methods from Mojo::Base and implements the following new ones.
form
my $tx = $t->form('http://kraih.com/foo' => {test => 123});
my $tx = $t->form(
'http://kraih.com/foo',
'UTF-8',
{test => 123}
);
my $tx = $t->form(
'http://kraih.com/foo',
{test => 123},
{Accept => '*/*'}
);
my $tx = $t->form(
'http://kraih.com/foo',
'UTF-8',
{test => 123},
{Accept => '*/*'}
);
my $tx = $t->form(
'http://kraih.com/foo',
{mytext => {file => '/foo/bar.txt'}}
);
my $tx = $t->form(
'http://kraih.com/foo',
{mytext => {content => 'lalala'}}
);
my $tx = $t->form(
'http://kraih.com/foo',
{myzip => {file => $asset, filename => 'foo.zip'}}
);Versatile Mojo::Transaction::HTTP builder for form requests.
my $tx = $t->form('http://kraih.com/foo' => {test => 123});
$tx->res->body(sub { say $_[1] });
$ua->start($tx);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.
my $tx = $t->form(
'http://kraih.com/foo',
{test => 123},
{'Content-Type' => 'multipart/form-data'}
);peer
my ($scheme, $host, $port) = $t->peer($tx);Actual peer for transaction.
proxy_connect
my $tx = $t->proxy_connect($old);Build Mojo::Transaction::HTTP proxy connect request for transaction if possible.
redirect
my $tx = $t->redirect($old);Build Mojo::Transaction::HTTP followup request for 301, 302, 303 or 307 redirect response if possible.
tx
my $tx = $t->tx(GET => 'mojolicio.us');
my $tx = $t->tx(POST => 'http://mojolicio.us');
my $tx = $t->tx(GET => 'http://kraih.com' => {Accept => '*/*'});
my $tx = $t->tx(PUT => 'http://kraih.com' => 'Hi!');
my $tx = $t->tx(POST => 'http://kraih.com' => {Accept => '*/*'} => 'Hi!');Versatile general purpose Mojo::Transaction::HTTP builder for requests.
# Streaming response
my $tx = $t->tx(GET => 'http://mojolicio.us');
$tx->res->body(sub { say $_[1] });
$ua->start($tx);
# Custom socket
my $tx = $t->tx(GET => 'http://mojolicio.us');
$tx->connection($socket);
$ua->start($tx);websocket
my $tx = $t->websocket('ws://localhost:3000');
my $tx =
$t->websocket('ws://localhost:3000' => {'User-Agent' => 'Agent 1.0'});Versatile Mojo::Transaction::WebSocket builder for WebSocket handshake requests.