Mojo::UserAgent::Transactor - User agent transactor
use Mojo::UserAgent::Transactor; # Simple GET request my $t = Mojo::UserAgent::Transactor->new; say $t->tx(GET => 'http://mojolicio.us')->req->to_string; # PATCH request with "Do Not Track" header and content say $t->tx(PATCH => 'mojolicio.us' => {DNT => 1} => 'Hi!')->req->to_string; # POST request with form data say $t->tx(POST => 'example.com' => form => {a => 'b'})->req->to_string; # PUT request with JSON data say $t->tx(PUT => 'example.com' => json => {a => 'b'})->req->to_string;
Mojo::UserAgent::Transactor is the transaction building and manipulation framework used by Mojo::UserAgent.
Mojo::UserAgent::Transactor implements the following attributes.
my $generators = $t->generators; $t = $t->generators({foo => sub {...}});
Registered content generators.
Mojo::UserAgent::Transactor inherits all methods from Mojo::Base and implements the following new ones.
my $t = Mojo::UserAgent::Transactor->new;
Construct a new transactor and register form and json content generators.
form
json
$t = $t->add_generator(foo => sub {...});
Register a new content generator.
my ($proto, $host, $port) = $t->endpoint(Mojo::Transaction::HTTP->new);
Actual endpoint for transaction.
my ($proto, $host, $port) = $t->peer(Mojo::Transaction::HTTP->new);
Actual peer for transaction.
my $tx = $t->proxy_connect(Mojo::Transaction::HTTP->new);
Build Mojo::Transaction::HTTP proxy connect request for transaction if possible.
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.
301
302
303
307
308
my $tx = $t->tx(GET => 'example.com'); my $tx = $t->tx(POST => 'http://example.com'); my $tx = $t->tx(GET => 'http://example.com' => {DNT => 1}); my $tx = $t->tx(PUT => 'http://example.com' => 'Hi!'); my $tx = $t->tx(PUT => 'http://example.com' => form => {a => 'b'}); my $tx = $t->tx(PUT => 'http://example.com' => json => {a => 'b'}); my $tx = $t->tx(POST => 'http://example.com' => {DNT => 1} => 'Hi!'); my $tx = $t->tx( PUT => 'http://example.com' => {DNT => 1} => form => {a => 'b'}); my $tx = $t->tx( PUT => 'http://example.com' => {DNT => 1} => json => {a => 'b'});
Versatile general purpose Mojo::Transaction::HTTP transaction builder for requests, with support for content generators.
# 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); # Generate query parameters my $tx = $t->tx(GET => 'http://example.com' => form => {a => 'b'}); # Use form generator with custom charset my $tx = $t->tx( PUT => 'http://example.com' => form => {a => 'b'} => charset => 'UTF-8'); # Multiple form values with the same name my $tx = $t->tx(PUT => 'http://example.com' => form => {a => [qw(b c d)]}); # Multipart upload streamed from file my $tx = $t->tx( PUT => 'http://example.com' => form => {mytext => {file => '/foo.txt'}}); # Multipart upload with in-memory content my $tx = $t->tx( POST => 'http://example.com' => form => {mytext => {content => 'lala'}}); # Upload multiple files my $tx = $t->tx(POST => 'http://example.com' => form => {mytext => [{content => 'first'}, {content => 'second'}]}); # Customized upload with filename and header my $tx = $t->tx(POST => 'http://example.com' => form => { myzip => { file => Mojo::Asset::Memory->new->add_chunk('lalala'), filename => 'foo.zip', DNT => 1 } });
The form content generator will automatically use query parameters for GET/HEAD requests and the "application/x-www-form-urlencoded" content type for everything else. Both get upgraded automatically to using the "multipart/form-data" content type when necessary or when the header has been set manually.
GET
HEAD
my $tx = $t->upgrade(Mojo::Transaction::HTTP->new);
Build Mojo::Transaction::WebSocket followup transaction for WebSocket handshake if possible.
my $tx = $t->websocket('ws://localhost:3000'); my $tx = $t->websocket('ws://localhost:3000' => {DNT => 1});
Versatile Mojo::Transaction::HTTP transaction builder for WebSocket handshake requests.
Mojolicious, Mojolicious::Guides, http://mojolicio.us.
To install Mojolicious, copy and paste the appropriate command in to your terminal.
cpanm
cpanm Mojolicious
CPAN shell
perl -MCPAN -e shell install Mojolicious
For more information on module installation, please visit the detailed CPAN module installation guide.