Mojo::UserAgent::Transactor(3pm)			User Contributed Perl Documentation			  Mojo::UserAgent::Transactor(3pm)

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($tx);

       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.

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

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

       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'}
	 );

   "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, 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>.

perl v5.14.2							    2012-09-05					  Mojo::UserAgent::Transactor(3pm)